Playbooks ausführen

Installation und Ersteinrichtung beschreibt die Haupt-README. Die folgenden Befehle gelten, wenn Sie playbooks/setup.yml direkt aus dem Repository ausführen möchten.

Vor dem Ausführen eines Playbooks

• Führen Sie die Befehle im Stammverzeichnis des Repositorys aus.
• Installieren Sie zuerst die Host-Abhängigkeiten, wie in der README im Stammverzeichnis beschrieben.
• Starten Sie mit --check, um vor dem Anwenden von Änderungen einen Probelauf durchzuführen.
• Passen Sie das Inventory an Ihre Umgebung an oder übergeben Sie bei Bedarf zusätzliche Variablen über die Kommandozeile.
• Wenn Sie sailwright provision verwenden, konfigurieren Sie zusätzliche lokale oder Git-basierte Rollenquellen über Ansible-Rollenquellen.

Auf localhost ausführen

Für den Wrapper-basierten localhost-Ablauf nutzen Sie Lokales Provisioning.

Unter macOS oder Linux sehen die direkten localhost-Befehle so aus.

Probelauf:

ansible-playbook playbooks/setup.yml -i inventory/localhost.yaml --check

Anwenden:

ansible-playbook playbooks/setup.yml -i inventory/localhost.yaml

Auf einem entfernten Host oder in einer VM ausführen

Probelauf:

HOST="192.168.179.21"
cat <<EOF > inventory/remote.yml
all:
  hosts:
    $HOST:
      ansible_user: admin
EOF
ansible-playbook playbooks/setup.yml -i inventory/remote.yml -l "$HOST" --ask-pass --ask-become-pass --check

Anwenden:

ansible-playbook playbooks/setup.yml -i inventory/remote.yml -l "$HOST" --ask-pass --ask-become-pass

Unter Windows ausführen

Wenn auf dem Windows-Ziel noch kein Fernzugriff eingerichtet ist, beginnen Sie mit Windows-Ansible-Zugriff.

Wenn Sie statt eines direkten ansible-playbook-Aufrufs den vom Wrapper verwalteten localhost-Ablauf nutzen möchten, verwenden Sie Lokales Provisioning.

Über WinRM

Wenn Sie ansible-playbook direkt mit inventory/localhost_windows_winrm.yml ausführen, sind Sie selbst dafür verantwortlich, sichere WinRM-Verbindungsvariablen und Zugangsdaten bereitzustellen.

Über SSH

Wenn Sie ansible-playbook direkt mit inventory/localhost_windows_ssh.yml ausführen, sind Sie selbst dafür verantwortlich, einen sicheren SSH-Benutzer, einen Schlüssel und die Shell-Variablen bereitzustellen. Konfigurieren Sie den Windows-OpenSSH-Server so, dass HKLM:\SOFTWARE\OpenSSH\DefaultShell auf C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe gesetzt ist, wie in Windows-Ansible-Zugriff beschrieben. Andernfalls verbindet sich Ansible möglicherweise über cmd.exe statt über PowerShell.

$SailwrightPath = "C:\path\to\sailwright"
C:\\cygwin64\\bin\\bash.exe -l -c "cd $SailwrightPath && ansible-playbook playbooks/setup.yml -i inventory/localhost_windows_ssh.yml -l windows_host -e ansible_user=admin -e ansible_ssh_private_key_file=/path/to/key -e ansible_shell_type=powershell -e ansible_shell_executable=powershell.exe -vvv"