Zum Inhalt springen
Installieren

Wenn ein Lauf fehlschlägt

Finden Sie den fehlgeschlagenen Task und die Ursache, prüfen Sie dasselbe Playbook unter ansible-playbook und melden Sie, was Sie gefunden haben.

Beginnen Sie beim Exit-Code. Er sagt Ihnen, ob der Lauf angehalten hat, bevor er einen Host berührte, oder auf einem Host fehlgeschlagen ist.

Code Was geschehen ist Wo Sie nachsehen
4, ohne Recap Das Playbook ist vor der ersten Verbindung abgebrochen. Es lässt sich nicht parsen, oder es verwendet etwas, das dieses Release noch nicht unterstützt. Die Meldung über dem Code. Siehe Abbruch vor dem Lauf.
2, 4 oder 6, mit Recap Ein Host ist fehlgeschlagen (2), ein Host war nicht erreichbar (4), oder beides (6). Die Zeile fatal: des Tasks, dann Fehler während des Laufs.
1 Eine Rolle, ein Playbook oder ein Host-Muster wurde nicht gefunden. Die Datei oder der Name, den die Meldung zitiert.

Exit-Codes listet jeden Code auf.

Das meiste, was dieses Release nicht ausführen kann, wird benannt, bevor Volant sich mit irgendetwas verbindet. Die Meldung sagt, was abgelehnt wurde und wo:

Meldung Was zu tun ist
task 'NAME': keyword 'KEYWORD' is not supported yet on 'MODULE' Prüfen Sie das Keyword unter Keywords. Entfernen Sie es, oder lassen Sie dieses Play vorerst unter ansible-playbook.
task 'NAME': argument 'ARGUMENT' is not supported yet on 'MODULE' Prüfen Sie das Modul unter Module. Für die meisten abgelehnten Argumente gibt es dort einen Workaround.
couldn't resolve module/action 'NAME' Prüfen Sie die Schreibweise. Stammt das Modul aus einer Collection, installieren Sie sie mit volant runtime install --collections NAMESPACE.COLLECTION.
strategy 'NAME' is not supported yet Verwenden Sie linear, free, host_pinned oder debug. Ein Strategie-Plugin läuft nur, wenn es von einer davon ableitet und nichts hinzufügt.
become_method 'NAME' is not supported yet Verwenden Sie sudo oder su. Dieser Fall endet mit 2.
the role 'NAME' was not found in ... Die Meldung listet die durchsuchten Verzeichnisse auf. Fügen Sie das Verzeichnis der Rolle zu roles_path hinzu. Dieser Fall endet mit 1.

Läuft mein Playbook? listet diese Ablehnungen auf und zeigt, wie Sie ein ganzes Projekt prüfen, ohne es auszuführen. Die Vorabprüfung erklärt, wie die Prüfung funktioniert.

  1. Führen Sie den Lauf erneut nur auf dem fehlschlagenden Host aus, mit mehr Ausgabe. -vvv gibt die Argumente aus, die jedes Modul erhalten hat:

    Terminal-Fenster
    volant playbook -i inventory.ini site.yml --limit web1 -vvv
  2. Überspringen Sie die Tasks, die bereits durchlaufen. --start-at-task beginnt bei dem Task, den Sie nennen, und --step fragt vor jedem Task nach:

    Terminal-Fenster
    volant playbook -i inventory.ini site.yml --limit web1 --start-at-task "Install nginx"
  3. Halten Sie am Fehler an und sehen Sie sich um. Mit debugger: on_failed am Play oder am Task öffnet Volant den Task-Debugger von Ansible, wenn ein Task fehlschlägt. Sie können Variablen ausgeben, die Argumente ändern und den Task erneut ausführen.

Volant liest dieselben Dateien, also läuft derselbe Befehl unter Ansible:

Terminal-Fenster
ansible-playbook -i inventory.ini site.yml --limit web1

Schlägt Ansible genauso fehl, liegt das Problem im Playbook oder auf dem Host. Schlägt nur Volant fehl, oder liefern beide unterschiedliche Ergebnisse, ist das ein Bug in Volant. Sie können das Play unter ansible-playbook lassen, bis er behoben ist.

Dieselben Dateien laufen unverändert unter ansible-playbook. Volant fügt Ihren Playbooks, Rollen, Inventories und Ihrer ansible.cfg nichts hinzu, es gibt also nichts zurückzukonvertieren.

Auf den Hosts bleibt nur der zwischengespeicherte Agent: ein Verzeichnis namens volant-agent-<version>-<uid> in ~/.ansible/tmp und daneben ein Verzeichnis volant-blobs-<version>-<uid>, wenn ein Lauf Python-Module verwendet hat. Um sie zu entfernen, löschen Sie sie auf jedem Host als das Konto, das der Lauf verwendet hat:

Terminal-Fenster
ssh web1 'rm -rf ~/.ansible/tmp/volant-*'

Auf einem Host, auf dem Tasks mit become liefen, liegt eine zweite Kopie im Home-Verzeichnis des Kontos, auf das gewechselt wurde. Führen Sie denselben Befehl als dieses Konto aus. Wie Sie Volant auch vom Controller entfernen, steht unter Deinstallieren. Was Volant auf Ihren Rechnern ablegt listet alles auf.

Fügen Sie die Ausgabe von volant --version bei, das kleinste Playbook samt Inventory, das noch fehlschlägt, und die Ausgabe des fehlschlagenden Laufs mit -vvv. Entfernen Sie Passwörter, Schlüssel, Vault-Inhalte und Hostnamen, bevor Sie sie posten. Ein öffentliches Issue bleibt öffentlich.