volant pull
Checkt ein Repository mit git aus und führt sein Playbook auf dieser Maschine aus, wie ansible-pull, ohne Python für den Checkout.
volant pull ist das ansible-pull von ansible-core 2.19.12, in Rust geschrieben. Es checkt ein Repository auf der Maschine aus, auf der es läuft, und führt dann ein Playbook daraus gegen dieselbe Maschine aus. Es ist für den Lauf aus cron gedacht. Der Checkout braucht git und kein Python. Das Playbook läuft mit Volants Engine, so wie volant playbook es ausführt, und installiert die verwaltete Runtime nur, wenn das Playbook Python braucht.
volant pull -U URL [-d DIR] [-C REV] [-i INV]... [-e VARS]... [-t TAGS] [--skip-tags TAGS] [-l SUBSET] [--check] [--diff] [--flush-cache] [-o] [-s N] [-f] [--clean] [--purge] [--full] [--accept-host-key] [--verify-commit] [--track-subs] [--private-key FILE] [-m MODULE] [-v...] [vault and password options] [PLAYBOOK...]Die Schritte
Abschnitt betitelt „Die Schritte“-Unennt das Repository und-ddas Verzeichnis, in das es ausgecheckt wird. Das Standardverzeichnis ist~/.ansible/pull/<fqdn>($ANSIBLE_HOME/pull/<fqdn>), wobei<fqdn>der vollständige Name der Maschine ist. Ein relatives-dwird absolut gemacht.- Der Befehl gibt
Starting Ansible Pull at <Datum und Uhrzeit>aus, dann seine eigene Befehlszeile. - Der Checkout klont das Repository, oder holt es und aktualisiert den Arbeitsbaum, so wie das Modul
gites mitdepth=1tut. Der Klon ist flach, außer mit--full, und endet auf dem Branch, dem Tag oder dem Commit, den-Cnennt. Das Ergebnis wird ausgegeben, wieansible -m gites ausgibt:localhost | CHANGED => {...}mitbeforeundafter, oderSUCCESS, wenn sich nichts geändert hat. Ein Fehlschlag gibt den[ERROR]-Block undFAILED!aus, und der Befehl endet mit 2. Lokale Änderungen an verfolgten Dateien lassen den Checkout fehlschlagen, außer mit--clean. - Das Playbook wird gewählt. Jedes auf der Befehlszeile genannte Playbook wird im Checkout gesucht. Ohne Namen wird das erste vorhandene aus
<fqdn>.yml,<hostname>.ymlundlocal.ymlgenommen. Wird nichts gefunden, warnt der Befehl für jede fehlende Datei und endet mit 5 undCould not find a playbook to run. - Das Playbook läuft aus dem Checkout als
ansible-playbook -c local. Es ist auflocalhost, die Namen der Maschine und127.0.0.1begrenzt, oder auf-l, wenn es angegeben ist. Jede-i-Quelle, die im Checkout existiert oder ein Komma enthält, wird weitergegeben. Der Exit-Code ist der des Playbooks.
Beide Schritte schreiben auf die Standardausgabe, Warnungen und Fehler eingeschlossen, weil ansible-pull sie dorthin kopiert. Die Warnungen des Befehls selbst, für -f und für ein fehlendes Playbook, gehen auf die Standardfehlerausgabe.
Optionen
Abschnitt betitelt „Optionen“| Option | Wirkung |
|---|---|
-o, --only-if-changed |
Das Playbook nur ausführen, wenn der Checkout etwas geändert hat. Sonst Repository has not changed, quitting: b'...' ausgeben, mit der Ausgabe des Checkouts als Python-Bytes-Literal, und mit 0 enden. |
-s N, --sleep N |
Vor dem Checkout eine zufällige Zahl von Sekunden warten, von 0 bis N-1, und Sleeping for <n> seconds... ausgeben, wenn diese Zahl nicht 0 ist. Ein Wert, der keine positive Zahl ist, endet mit 5. |
-f, --force |
Wenn der Checkout fehlschlägt, Unable to update repository. Continuing with (forced) run of playbook. warnen und das Playbook des vorigen Checkouts ausführen. |
--clean |
Lokale Änderungen im Checkout verwerfen (force=yes). |
--purge |
Den Checkout nach dem Playbook-Lauf entfernen, was auch sein Ergebnis ist. |
--full |
Die ganze Historie klonen. |
-C REV, --checkout REV |
Der Branch, der Tag oder der Commit, der ausgecheckt wird. |
--verify-commit |
Die GPG-Signatur des ausgecheckten Commits oder des Tags prüfen und anhalten, wenn sie sich nicht bestätigen lässt. |
--track-subs |
Die Submodule auf den neuesten Commit ihres Branches bringen. |
--accept-host-key |
Einen unbekannten Host-Schlüssel des ssh-Servers des Repositorys annehmen. |
--private-key FILE |
Der ssh-Schlüssel für das Repository. |
-m MODULE |
git, der Standard, läuft nativ. subversion, hg und bzr führen dieses Modul über volant adhoc aus, das die verwaltete Runtime braucht. Jeder andere Name endet mit 5. |
-e, -t, --skip-tags, -l, --check, --diff, --flush-cache, -K, --become-password-file, --connection-password-file, --vault-id, --vault-password-file, -v |
An den Playbook-Lauf weitergegeben. -e und -v gehen auch an den Checkout. |
-u, -c, -T, die Optionen für ssh-Argumente, -k, -J, -M und --list-hosts werden angenommen und tun nichts, wie in ansible-pull.
Unterschiede zu ansible-pull
Abschnitt betitelt „Unterschiede zu ansible-pull“- Auf einer Pipe gibt
ansible-pullseine ersten zwei Zeilen nach allem aus, was seine Schritte ausgegeben haben, weil seine eigene Ausgabe gepuffert ist. Volant gibt sie zuerst aus, wie beide es auf einem Terminal tun. - Der Checkout läuft einmal, auf
localhost. Wenn eine-i-Datei vor dem Checkout existiert und diese Maschine unter ihrem eigenen Namen führt, machtansible-pullden Checkout auch auf diesem Host. - Mit
-ienthält das Ergebnis des Checkouts der Referenz auchansible_facts.discovered_interpreter_python, mit einer Warnung über den gefundenen Interpreter. Der native Checkout startet kein Python, also wird keines von beiden ausgegeben. - Der vollständige Name ergibt sich aus der Auflösung des Maschinennamens und dann seiner Adresse. Wenn der kanonische Name keinen Punkt hat und einer seiner Aliasse schon, nimmt Pythons
socket.getfqdn()den Alias und Volant nicht. - Mit
-vsteht die Zeile zur Konfigurationsdatei vor den Warnungen des Checkouts. Auf einer Pipe hängt die Reihenfolge der Referenz vom Zeitpunkt ab. --purgemeldet ein Verzeichnis, das es nicht entfernen kann, mit dem Wortlaut des Fehlers des Betriebssystems.