volant pull
Hace el checkout de un repositorio con git y ejecuta su playbook en esta máquina, como ansible-pull, sin Python para el checkout.
volant pull es el ansible-pull de ansible-core 2.19.12, escrito en Rust. Hace el checkout de un repositorio en la máquina donde se ejecuta y luego ejecuta un playbook de ese repositorio contra la misma máquina. Está pensado para ejecutarse desde cron. El checkout necesita git y no Python. El playbook se ejecuta con el motor de Volant, como lo ejecuta volant playbook, y solo instala el runtime administrado si el playbook necesita 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...]Los pasos
Sección titulada «Los pasos»-Unombra el repositorio y-del directorio donde se extrae. El directorio por defecto es~/.ansible/pull/<fqdn>($ANSIBLE_HOME/pull/<fqdn>), donde<fqdn>es el nombre completo de la máquina. Un-drelativo se vuelve absoluto.- El comando imprime
Starting Ansible Pull at <fecha y hora>y luego su propia línea de comandos. - El checkout clona el repositorio, o lo trae y actualiza el árbol de trabajo, como hace el módulo
gitcondepth=1. El clon es superficial salvo con--full, y termina en la rama, la etiqueta o el commit que nombra-C. El resultado se imprime como lo imprimeansible -m git:localhost | CHANGED => {...}conbeforeyafter, oSUCCESScuando nada cambió. Un fallo imprime el bloque[ERROR]yFAILED!, y el comando sale con 2. Los cambios locales en archivos seguidos hacen fallar el checkout, salvo con--clean. - Se elige el playbook. Cada playbook nombrado en la línea de comandos se busca en el checkout. Sin nombres, se usa el primero que exista entre
<fqdn>.yml,<hostname>.ymlylocal.yml. Si no se encuentra nada, el comando avisa por cada archivo que falta y sale con 5 yCould not find a playbook to run. - El playbook se ejecuta desde el checkout como
ansible-playbook -c local. Se limita alocalhost, a los nombres de la máquina y a127.0.0.1, o a-lcuando se da. Cada fuente-ique existe en el checkout, o que contiene una coma, se pasa. El código de salida es el del playbook.
Los dos pasos escriben en la salida estándar, avisos y errores incluidos, porque ansible-pull los copia ahí. Los avisos del propio comando, para -f y para un playbook que falta, van al error estándar.
Opciones
Sección titulada «Opciones»| Opción | Efecto |
|---|---|
-o, --only-if-changed |
Ejecutar el playbook solo si el checkout cambió algo. Si no, imprimir Repository has not changed, quitting: b'...', con la salida del checkout como literal bytes de Python, y salir con 0. |
-s N, --sleep N |
Esperar un número aleatorio de segundos, de 0 a N-1, antes del checkout, e imprimir Sleeping for <n> seconds... cuando ese número no es 0. Un valor que no es un número positivo sale con 5. |
-f, --force |
Cuando el checkout falla, avisar Unable to update repository. Continuing with (forced) run of playbook. y ejecutar el playbook del checkout anterior. |
--clean |
Descartar los cambios locales del checkout (force=yes). |
--purge |
Borrar el checkout después de ejecutar el playbook, sea cual sea su resultado. |
--full |
Clonar toda la historia. |
-C REV, --checkout REV |
La rama, la etiqueta o el commit que se extrae. |
--verify-commit |
Verificar la firma GPG del commit extraído, o de la etiqueta, y parar si no se verifica. |
--track-subs |
Llevar los submódulos al último commit de su rama. |
--accept-host-key |
Aceptar una clave de host desconocida del servidor ssh del repositorio. |
--private-key FILE |
La clave ssh que se usa para el repositorio. |
-m MODULE |
git, el valor por defecto, se ejecuta de forma nativa. subversion, hg y bzr ejecutan ese módulo con volant adhoc, que necesita el runtime administrado. Cualquier otro nombre sale con 5. |
-e, -t, --skip-tags, -l, --check, --diff, --flush-cache, -K, --become-password-file, --connection-password-file, --vault-id, --vault-password-file, -v |
Se pasan a la ejecución del playbook. -e y -v también llegan al checkout. |
-u, -c, -T, las opciones de argumentos de ssh, -k, -J, -M y --list-hosts se aceptan y no hacen nada, como en ansible-pull.
Diferencias con ansible-pull
Sección titulada «Diferencias con ansible-pull»- En una tubería,
ansible-pullimprime sus dos primeras líneas después de todo lo que imprimieron sus pasos, porque su propia salida pasa por un búfer. Volant las imprime primero, como hacen los dos en una terminal. - El checkout se ejecuta una vez, en
localhost. Cuando un archivo-iexiste antes del checkout y lista esta máquina con su propio nombre,ansible-pulltambién hace el checkout en ese host. - Con
-i, el resultado del checkout de la referencia también contieneansible_facts.discovered_interpreter_python, con un aviso sobre el intérprete encontrado. El checkout nativo no inicia Python, así que no se imprime ninguno de los dos. - El nombre completo sale de resolver el nombre de la máquina y luego su dirección. Cuando el nombre canónico no tiene punto y uno de sus alias sí,
socket.getfqdn()de Python toma el alias y Volant no. - Con
-v, la línea sobre el archivo de configuración va antes de los avisos del checkout. En una tubería, el orden de la referencia depende del momento. --purgeinforma de un directorio que no puede borrar con la redacción del error del sistema operativo.