Ansible-Befehlsnamen
Welcher Volant-Befehl welches Programm von ansible-core ersetzt, was gleich ist, was abweicht und wie Sie Ihre Kommandozeilen behalten.
Volant führt die neun Programme von ansible-core 2.19.12 aus. Jedes ist ein Unterbefehl von volant, und unter Linux und macOS kann es auch unter seinem ansible-Namen gestartet werden. Windows wird weder für die Programmnamen noch für die Links unterstützt.
Was was ersetzt
Abschnitt betitelt „Was was ersetzt“| Programm von ansible-core | Befehl von Volant | Läuft in | Verwaltete Runtime |
|---|---|---|---|
ansible |
volant adhoc |
Volant | für die nativen Module nicht nötig |
ansible-playbook |
volant playbook, volant-playbook |
Volant | bei der ersten Verwendung installiert, die Python braucht |
ansible-vault |
volant vault |
Volant | nicht nötig |
ansible-inventory |
volant inventory |
Volant | nicht nötig, außer für Inventory-Plugins von Collections |
ansible-doc |
volant doc |
dem eigenen Werkzeug von ansible-core | bei der ersten Verwendung installiert |
ansible-config |
volant config |
dem eigenen Werkzeug von ansible-core | bei der ersten Verwendung installiert |
ansible-galaxy |
volant galaxy |
Volant, im Entstehen: die Unterbefehle werden abgelehnt, bis sie nativ sind | nicht nötig |
ansible-pull |
volant pull |
Volant | für einen git-Checkout nicht nötig |
ansible-console |
volant console |
Volant | für die nativen Module nicht nötig |
Die verwaltete Runtime installiert sich beim ersten Mal selbst, wenn ein Befehl sie braucht, wie bei einem Playbook, und gibt dabei eine Zeile auf der Standardfehlerausgabe aus. Die verwaltete Runtime beschreibt sie. Sie müssen ansible nicht installieren, aber zwei der neun Befehle führen den eigenen Code von ansible-core aus dieser Runtime aus.
Ihre Kommandozeilen behalten
Abschnitt betitelt „Ihre Kommandozeilen behalten“Die Links werden nur angelegt, wenn Sie darum bitten. Führen Sie entweder das Installationsskript mit --shims aus oder volant shims install:
curl -fsSL https://volant.sh/install.sh | sh -s -- --shimsvolant shims installJeder Name ist ein symbolischer Link auf volant. Volant liest den Dateinamen, unter dem es gestartet wurde, sodass der Link ansible-vault volant vault ausführt. Beide Befehle nehmen dieselben Argumente und geben dieselbe Ausgabe und dieselben Exit-Codes. Ein Aufruffehler endet mit 2 und nennt das Programm unter dem gestarteten Namen, ansible-vault: error: .... Wie ansible-core prüft ein Link die Locale, bevor er seine Argumente liest. Eine Locale, die sich nicht setzen lässt oder nicht UTF-8 ist, endet mit 1 und ERROR: Ansible could not initialize the preferred locale oder ERROR: Ansible requires the locale encoding to be UTF-8. LC_ALL=C wird abgelehnt; ist keine Locale-Variable gesetzt, gilt die C-Locale als C.UTF-8. volant selbst prüft nichts.
install ersetzt keine Datei und keinen Link, die es nicht angelegt hat, außer mit --force. Liegt ein anderes Programm dieses Namens in Ihrem PATH, sagt es das: note: /usr/bin/ansible-vault is hidden by this link, DIR comes first in PATH, wenn der Link gewinnt, oder note: ... still runs first, DIR comes later in PATH, wenn nicht. So entfernen Sie die Links:
volant shims removeremove löscht nur Links, die auf eine Datei namens volant zeigen, und lässt alles andere.
Ein CI-Skript wie dieses läuft unverändert, sobald die Links existieren, ohne ansible auf dem Rechner:
ansible-inventory -i hosts.ini --list > inventory.jsonansible-vault view group_vars/all/secrets.yml --vault-password-file ci-passansible-playbook -i hosts.ini site.ymlWas gleich ist
Abschnitt betitelt „Was gleich ist“Bei ansible, ansible-vault und ansible-inventory wurden die Ausgabe, die auf den Befehlsseiten aufgeführten Optionen und die Exit-Codes gegen ansible-core 2.19.12 gemessen. Hinter jeder Aussage steht ein Test.
| Aussage | Wo sie geprüft wird |
|---|---|
volant adhoc gibt die Bytes des Callbacks minimal, den [ERROR]-Block und die Formen -o und -t aus, mit den Exit-Codes der Referenz |
die Szenario-Goldens adhoc-* und crates/volant/tests/adhoc_cli.rs |
Der Name ansible führt volant adhoc aus |
the_ansible_name_runs_adhoc |
Der Name ansible-playbook führt volant playbook aus |
a_link_named_ansible_playbook_behaves_as_the_playbook_subcommand |
volant vault liefert die Meldungen, Exit-Codes, Dateimodi und Dateien von ansible-vault |
crates/volant/tests/vault_cli.rs und die Szenario-Goldens vault-* für die Vault-Daten, die ein Playbook liest |
| Eine Datei, die das eine Werkzeug verschlüsselt, entschlüsselt das andere, für die Standard-ID und für ein Label | a_file_one_tool_encrypts_the_other_decrypts |
volant inventory gibt die JSON- und YAML-Bytes von ansible-inventory aus: Schlüsselreihenfolge, Einrückung von vier Leerzeichen, PyYAML-Anker |
crates/volant/tests/inventory_golden.rs über golden/inventories/cases.yml und inventory_cli.rs |
volant config gibt aus, was das Werkzeug ausgibt |
crates/volant/tests/tools_cli.rs |
volant galaxy nimmt die Optionen von ansible-galaxy an und macht dessen erste Prüfungen mit denselben Meldungen |
crates/volant/src/galaxy/tests.rs und galaxy_golden.rs gegen einen falschen Galaxy-Server |
volant pull gibt den Playbook-Lauf und die Zeile von -o wie ansible-pull aus und checkt ohne Python aus |
a_pull_prints_what_the_reference_pull_prints und a_pull_checks_out_and_runs_without_python in console_pull.rs |
volant console gibt auf einer Pipe für seine Befehle, Module und Shell-Zeilen aus, was ansible-console ausgibt, und braucht für native Module kein Python |
the_console_reads_its_commands_from_a_pipe und the_console_runs_without_python in console_pull.rs |
Die Links, die install anlegt, die Zeilen, die es ausgibt, und was remove stehen lässt |
crates/volant/tests/shims.rs |
| Welche Namen auf welchen Befehl abgebildet werden, und kein anderer | die Tests in crates/volant/src/cli/program.rs |
Die Optionen, die jeder native Befehl akzeptiert, stehen auf seiner eigenen Seite: volant adhoc, volant vault, volant inventory und volant pull. Eine Option, die dort nicht steht, wird abgelehnt, nie ignoriert.
Was abweicht
Abschnitt betitelt „Was abweicht“- Der Hilfetext ist der von Volant. Er wird nie mit der Referenz verglichen.
--versiongibtansible [core 2.19.12](oder den Programmnamen) und die Pfade aus. Die Zeilen zu Python, Jinja und PyYAML entfallen, wenn Volant keinen Interpreter mit ansible-core findet, weil--versionnichts installiert. Siehevolant adhoc.executable locationin--versionist das Programm, wie es gestartet wurde:volantoder der Link. Siehevolant doc.ansible-inventory --tomlbraucht kein Python-Paket, wo die Referenztomli-wbraucht, und einnull-Wert ergibt eine[ERROR]-Zeile statt eines Tracebacks (beide enden mit 250). Siehevolant inventory.volant pullgibt seine ersten zwei Zeilen vor dem aus, was seine Schritte ausgeben, und sein Checkout startet kein Python. Siehevolant pull.volant config dumpzeigtCOLLECTIONS_PATHSals von der Umgebung gesetzt, sobald die Runtime ein Verzeichniscollections/hat. Siehevolant config.ansible-vault viewläuft nur in einem Terminal über einen Pager, mitPAGER, dannANSIBLE_PAGER, dann[defaults] pager, dannless. Siehe Vault.volant adhocundvolant playbooknutzen Volants Engine, daher gelten die Unterschiede, die in Läuft mein Playbook? und aufvolant adhocaufgeführt sind.
Exit-Codes
Abschnitt betitelt „Exit-Codes“| Befehl | 0 | 1 | 2 | 4 | 5 | 250 |
|---|---|---|---|---|---|---|
volant adhoc |
jeder Host war erfolgreich oder wurde übersprungen | kein Host mehr als Ziel, oder eine falsche meta-Aktion |
ein Host ist fehlgeschlagen, oder ein Aufruffehler | ein Host war nicht erreichbar, oder etwas, das diese Version noch nicht unterstützt | eine ungültige Einstellung, oder kein Argument für command |
ein Argument, das kein gültiges JSON ist |
volant vault |
erledigt | ein Dateifehler, etwa create auf eine vorhandene Datei |
ein Aufruffehler | eine falsche Option, etwa zwei Dateien mit --output |
||
volant inventory |
ausgegeben | ein Aufruffehler | keine Aktion oder zwei Aktionen, oder ein falsches Ziel von --host oder --graph |
volant playbook verwendet die Codes auf Exit-Codes. Die drei Werkzeuge, die in der Runtime von ansible-core laufen, liefern den eigenen Code des Werkzeugs, oder 1 mit einer Zeile [ERROR]:, wenn sich der Interpreter nicht starten lässt. volant pull endet mit 2, wenn der Checkout fehlschlägt, mit 5 bei einem Optionsfehler oder wenn kein Playbook gefunden wird, und sonst mit dem Code des Playbooks.