volant pull
Fait le checkout d'un dépôt avec git et exécute son playbook sur cette machine, comme ansible-pull, sans Python pour le checkout.
volant pull est l’ansible-pull d’ansible-core 2.19.12, écrit en Rust. Il fait le checkout d’un dépôt sur la machine où il tourne, puis exécute un playbook de ce dépôt sur cette même machine. Il est fait pour tourner depuis cron. Le checkout demande git et pas Python. Le playbook tourne avec le moteur de Volant, comme volant playbook l’exécute, et n’installe le runtime géré que si le playbook a besoin de Python.
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...]Les étapes
Section intitulée « Les étapes »-Unomme le dépôt et-dle répertoire où il est extrait. Le répertoire par défaut est~/.ansible/pull/<fqdn>($ANSIBLE_HOME/pull/<fqdn>), où<fqdn>est le nom complet de la machine. Un-drelatif est rendu absolu.- La commande affiche
Starting Ansible Pull at <date et heure>, puis sa propre ligne de commande. - Le checkout clone le dépôt, ou le récupère et met à jour l’arbre de travail, comme le module
gitle fait avecdepth=1. Le clone est superficiel sauf avec--full, et finit sur la branche, l’étiquette ou le commit que nomme-C. Le résultat est affiché commeansible -m gitl’affiche :localhost | CHANGED => {...}avecbeforeetafter, ouSUCCESSquand rien n’a changé. Un échec affiche le bloc[ERROR]etFAILED!, et la commande sort avec 2. Des modifications locales de fichiers suivis font échouer le checkout, sauf avec--clean. - Le playbook est choisi. Chaque playbook nommé sur la ligne de commande est cherché dans le checkout. Sans nom, c’est le premier qui existe parmi
<fqdn>.yml,<hostname>.ymletlocal.yml. Quand rien n’est trouvé, la commande avertit pour chaque fichier absent et sort avec 5 etCould not find a playbook to run. - Le playbook tourne depuis le checkout comme
ansible-playbook -c local. Il est limité àlocalhost, aux noms de la machine et à127.0.0.1, ou à-lquand il est donné. Chaque source-iqui existe dans le checkout, ou qui contient une virgule, est transmise. Le code de sortie est celui du playbook.
Les deux étapes écrivent sur la sortie standard, avertissements et erreurs compris, parce qu’ansible-pull les y recopie. Les avertissements de la commande elle-même, pour -f et pour un playbook absent, vont sur la sortie d’erreur.
| Option | Effet |
|---|---|
-o, --only-if-changed |
N’exécuter le playbook que si le checkout a changé quelque chose. Sinon afficher Repository has not changed, quitting: b'...', avec la sortie du checkout en littéral bytes de Python, et sortir avec 0. |
-s N, --sleep N |
Attendre un nombre aléatoire de secondes, de 0 à N-1, avant le checkout, et afficher Sleeping for <n> seconds... quand ce nombre n’est pas 0. Une valeur qui n’est pas un nombre positif sort avec 5. |
-f, --force |
Quand le checkout échoue, avertir Unable to update repository. Continuing with (forced) run of playbook. et exécuter le playbook du checkout précédent. |
--clean |
Abandonner les modifications locales du checkout (force=yes). |
--purge |
Supprimer le checkout après l’exécution du playbook, quel que soit son résultat. |
--full |
Cloner tout l’historique. |
-C REV, --checkout REV |
La branche, l’étiquette ou le commit à extraire. |
--verify-commit |
Vérifier la signature GPG du commit extrait, ou de l’étiquette, et s’arrêter si elle ne se vérifie pas. |
--track-subs |
Mettre les sous-modules au dernier commit de leur branche. |
--accept-host-key |
Accepter une clé d’hôte inconnue du serveur ssh du dépôt. |
--private-key FILE |
La clé ssh utilisée pour le dépôt. |
-m MODULE |
git, le défaut, tourne en natif. subversion, hg et bzr exécutent ce module par volant adhoc, qui demande le runtime géré. Tout autre nom sort avec 5. |
-e, -t, --skip-tags, -l, --check, --diff, --flush-cache, -K, --become-password-file, --connection-password-file, --vault-id, --vault-password-file, -v |
Transmises à l’exécution du playbook. -e et -v vont aussi au checkout. |
-u, -c, -T, les options d’arguments ssh, -k, -J, -M et --list-hosts sont acceptées et ne font rien, comme dans ansible-pull.
Différences avec ansible-pull
Section intitulée « Différences avec ansible-pull »- Sur un tube,
ansible-pullaffiche ses deux premières lignes après tout ce que ses étapes ont affiché, parce que sa propre sortie passe par un tampon. Volant les affiche en premier, comme les deux le font sur un terminal. - Le checkout tourne une fois, sur
localhost. Quand un fichier-iexiste avant le checkout et liste cette machine sous son propre nom,ansible-pullfait aussi le checkout sur cet hôte. - Avec
-i, le résultat du checkout de la référence contient aussiansible_facts.discovered_interpreter_python, avec un avertissement sur l’interpréteur trouvé. Le checkout natif ne lance pas Python, donc ni l’un ni l’autre n’est affiché. - Le nom complet vient de la résolution du nom de la machine, puis de son adresse. Quand le nom canonique n’a pas de point et qu’un de ses alias en a un,
socket.getfqdn()de Python prend l’alias, et Volant non. - Avec
-v, la ligne sur le fichier de configuration vient avant les avertissements du checkout. Sur un tube, l’ordre de la référence dépend du moment. --purgesignale un répertoire qu’il ne peut pas supprimer avec la formulation de l’erreur du système d’exploitation.