Ansible AWX Anleitung: Grundlegende Nutzung und Konfiguration

AWX ist eine Open-Source-Webanwendung, die eine Benutzeroberfläche, eine REST-API und eine Aufgaben-Engine für Ansible bereitstellt. Es ist die Open-Source-Version des Ansible Tower. Das AWX ermöglicht es Ihnen, Ansible-Playbooks, Inventare zu verwalten und Jobs über die Weboberfläche zu planen.

In diesem Tutorial zeigen wir Ihnen die grundlegende Nutzung von Ansible AWX. Sie benötigen also einen Server, auf dem Ansible AWX bereits installiert ist. Wir behandeln einige grundlegende Konfigurationen von Ansible AWX, die Sie kennen müssen, wie z. B. die Einrichtung von Anmeldeinformationen, Inventaren, die Einrichtung und Ausführung von Jobvorlagen usw. Wenn Sie Ansible noch nicht installiert haben, sehen Sie sich bitte dieses Tutorial an: https://www.howtoforge.com/how-to-install-ansible-awx-with-nginx-reverse-proxy-on-ubuntu-1804/.

Voraussetzungen

• 2 oder 3 Server - 10.5.5.20 ansible-awx
• 10.5.5.21 lemp
• Grundlegendes Verständnis von Ansible
• Root-Rechte

Was wir tun werden:

1. Umgebungseinrichtung und Konfiguration
2. Anmeldeinformationen einrichten
3. Inventare einrichten
4. Projekte einrichten
5. Jobvorlagen einrichten
6. Jobs ausführen

Schritt 1 - Umgebungseinrichtung und Konfiguration

In diesem Tutorial werden wir das Ansible-Playbook für die grundlegende LEMP-Installation über das Ansible AWX-Dashboard bereitstellen und ausführen.

Wir haben zwei Server für das AWX selbst und die Zielmaschine.

10.5.5.20   ansible-awx  
10.5.5.21   lemp

Jetzt werden wir das Playbook als Benutzer namens ‘hakase’ bereitstellen und die schlüsselbasierte SSH-Authentifizierung verwenden. Stellen Sie sicher, dass Sie den Benutzer und die schlüsselbasierte Authentifizierung auf der Zielmaschine ‘lemp’ bereits eingerichtet haben.

Testen Sie mit dem folgenden Befehl vom Server ‘ ansible-awx ‘.

su - hakase  
ssh [email protected]

Stellen Sie sicher, dass Sie ohne Passwort angemeldet sind.

Jetzt muss der Benutzer ‘hakase’ das Root-Passwortlos haben, um Aufgaben auszuführen.

Führen Sie auf der Zielmaschine ‘ lemp ‘ den sudo-Befehl wie folgt aus.

su - hakase  
sudo su

Stellen Sie sicher, dass Sie die Root-Rechte ohne Passwort eingegeben haben.

Jetzt müssen Sie die Python-Pakete auf allen von Ansible verwalteten Zielmaschinen installieren.

sudo apt install python -y

Schritt 2 - Anmeldeinformationen einrichten

Zunächst müssen wir die Anmeldeinformationen von Ansible AWX konfigurieren. Diese werden zur Authentifizierung beim Starten und Ausführen von Jobs gegen verwaltete Server, zur Synchronisierung mit Inventarquellen und zum Importieren von Projekten verwendet.

Standardmäßig unterstützt Ansible AWX viele Anmeldeinformationen, einschließlich der VM-Maschine über SSH-Authentifizierung, Amazon Web Services, Google Compute Engine, OpenStack, Vault-Passwort, Quellcodeverwaltung usw.

Um Anmeldeinformationen einzurichten, klicken Sie im linken Menü auf ‘ Anmeldeinformationen ‘ und dann auf die Schaltfläche ‘+’ auf der rechten Seite.

Geben Sie nun die Anmeldeinformationen ‘ NAME ‘ und ‘ BESCHREIBUNG ‘ ein und geben Sie den ‘ ANMELDEART ‘ auf ‘ Maschine ‘ an.

Einfach gesagt, ermöglicht die ‘Maschine’-Anmeldeinformation die Verwendung der SSH-Authentifizierung zur Verwaltung von Servern. Sie unterstützt sowohl Passwort- als auch schlüsselbasierte Authentifizierungen.

Für diesen Leitfaden verwenden wir die schlüsselbasierte Authentifizierung. Geben Sie also den Benutzernamen ein und fügen Sie die privaten Schlüssel für diesen Benutzer ein.

Klicken Sie dann auf die Schaltfläche ‘ SPEICHERN ‘.

Infolgedessen wurde der neue Anmeldeinformationstyp ‘Maschine’ in Ansible AWX erstellt.

Schritt 3 - Inventare einrichten

Inventare sind Gruppen von Host-Servern, die von Ansible AWX verwaltet werden. Die Inventare ermöglichen es Ihnen, eine Gruppe mit mehreren Host-Servern zu erstellen. Und es erleichtert die Verwaltung verschiedener Server mit unterschiedlichen Umgebungen.

Um die Server zu verwalten und bereitzustellen, müssen wir eine neue Inventargruppe erstellen und dann Serverhosts in diese Inventargruppe hinzufügen.

Um ein neues Inventar hinzuzufügen, klicken Sie im linken Menü auf ‘ Inventare ‘, klicken Sie dann auf die Schaltfläche ‘+’ und wählen Sie ‘Inventar’.

Geben Sie den ‘ NAME ‘ und die ‘ BESCHREIBUNG ‘ des Inventars ein und klicken Sie dann auf die Schaltfläche ‘ SPEICHERN ‘.

Klicken Sie nun auf die Registerkarte ‘ HOSTS ‘ und klicken Sie auf die Schaltfläche ‘+’, um neue Hosts hinzuzufügen.

Geben Sie den ‘ HOSTNAMEN ‘, die ‘ BESCHREIBUNG ‘ und die ‘ VARIABLES ‘ mit zusätzlichen Konfigurationen für die Zielmaschinen-IP-Adresse ‘ansible_host: 10.5.5.21’ ein.

Klicken Sie nun auf die Schaltfläche ‘ SPEICHERN ‘.

Als nächstes müssen wir die Hosts-Konfiguration überprüfen, indem wir die Hosts mit dem Ping-Befehl überprüfen.

Gehen Sie zurück zur Registerkarte ‘ HOSTS ‘, aktivieren Sie den Namen Ihres Hosts und klicken Sie auf die Schaltfläche ‘ BEFEHLE AUSFÜHREN ‘.

Wählen Sie nun das ‘ MODUL ‘ namens ‘ ping ‘, klicken Sie auf die Schaltfläche zur Suche innerhalb der ‘ MASCHINENANMELDEINFORMATION ‘ und ‘ WÄHLEN SIE ‘ Ihre eigene aus, und klicken Sie dann auf die Schaltfläche ‘ STARTEN ‘.

Und Sie werden auf die neue Seite weitergeleitet, und unten ist das Ergebnis.

Ein neues Inventar wurde erstellt, und der Zielmaschinenserver wurde hinzugefügt.

Schritt 4 - Projekte einrichten

Projekte werden als Ansible-Playbooks im AWX dargestellt. Es handelt sich um Sammlungen von Ansible-Playbooks, die wir über das lokale Projektverzeichnis oder mithilfe des SCM-Systems wie Git, Subversion, Mercurial und RedHat Insights verwalten können.

Um neue Projekte zu erstellen, klicken Sie im linken Menü auf ‘ Projekte ‘ und klicken Sie auf die Schaltfläche ‘+’.

Geben Sie den ‘ NAME ‘ Ihres Projekts und die ‘ BESCHREIBUNG ‘ ein, wählen Sie dann den ‘ SCM-TYP ‘ auf ‘ Git ‘ und fügen Sie Ihr Playbook-Repository ein.

Klicken Sie nun auf die Schaltfläche ‘ SPEICHERN ‘, und als Ergebnis wurde ein neues Projekt für das Playbook erstellt.

Zusätzlich:

Wenn Sie ein neues Projekt mit dem SCM-Typ ‘ Manuell ‘ erstellen möchten, können Sie ein neues Verzeichnis für Playbooks im Verzeichnis ‘ /var/lib/awx/projects ‘ erstellen.

Das Verzeichnis ‘/var/lib/awx/projects’ ist das Standardprojektverzeichnis für Ihre Ansible-Playbooks, wenn Sie die AWX-Docker-Version mit dem aktivierten ‘ project_data_dir ‘ verwenden.

Schritt 5 - Neue Jobvorlagen erstellen

Die Jobvorlage ist die Definition zum Ausführen von Ansible-Playbooks selbst. Um eine neue Jobvorlage zu erstellen oder die Jobvorlage auszuführen, müssen wir das Ansible-Playbook aus unserem ‘Projekt’, die ‘Anmeldeinformationen’ zur Authentifizierung und die Zielmaschinen, die im ‘Inventar’ gespeichert sind, hinzufügen.

Für diesen Leitfaden haben wir bereits ein neues Projekt, Anmeldeinformationen und Inventar erstellt. Klicken Sie also einfach auf das Menü ‘ Vorlagen ‘ auf der linken Seite, klicken Sie dann auf die Schaltfläche ‘+’ und wählen Sie die Option ‘ Jobvorlage ‘.

Jetzt müssen Sie den ‘ NAME ‘ und die ‘ BESCHREIBUNG ‘ des Jobs eingeben. Wählen Sie dann das ‘ INVENTAR ‘, die ‘ ANMELDEINFORMATION ‘ und das ‘ PROJEKT ‘. Und danach geben Sie das ‘ PLAYBOOK ‘ an, das Sie ausführen und bereitstellen möchten.

Und als Ergebnis wurde die neue Jobvorlage Ansible AWX erstellt.

Schritt 6 - Die Jobvorlage ausführen

Nachdem wir die neue Jobvorlage erstellt haben, werden wir die Jobvorlage ausführen und die Playbooks ‘Projekte’ auf die Zielhosts im ‘Inventar’ bereitstellen.

Klicken Sie auf das Menü ‘ Vorlagen ‘ auf der linken Seite, und Sie erhalten eine Liste der verfügbaren Jobvorlagen.

Sobald der Job abgeschlossen ist, erhalten Sie das grüne Zeichen innerhalb des Namens der Jobvorlage.

Klicken Sie auf das grüne Zeichen innerhalb des Namens der Jobvorlage, und Ihnen wird das tatsächliche Ergebnis dieses Jobs angezeigt.

Der Job wurde erfolgreich abgeschlossen, und die Zielmaschine hat den LEMP-Stack über Ansible AWX installiert.

Schritt 7 - Zielmaschine testen

Testen Sie den Domainnamen der Zielmaschine. Die Konfiguration des Domainnamens wird in der Konfiguration ‘ roles/web/vars/main.yml ‘ gespeichert.

Überprüfen Sie die Nginx- und PHP-FPM-Dienste mit systemctl-Befehlen.

systemctl status nginx  
systemctl status php7.2-fpm

Testen Sie die MySQL-Datenbank auf der Zielmaschine. Detaillierte Konfigurationen der MySQL-Datenbank werden in der Konfigurationsdatei ‘roles/db/vars/main.yml’ gespeichert.

Infolgedessen wurde der LEMP-Stack auf der Zielmaschine über Ansible AWX installiert.

Referenz

• https://docs.ansible.com/ansible-tower/latest/html/userguide/