Ir al contenido
Instalar

Instalación

Instala Volant con un solo comando, comprueba qué necesitan el controlador y los hosts, y mantenlo al día.

Ventana de terminal
curl -fsSL https://volant.sh/install.sh | sh

El script funciona en Linux y macOS, en x86_64 y arm64. En Linux usa la compilación estática. Necesita curl, tar y sha256sum o shasum, además de xz en Linux. Descarga la versión más reciente para tu máquina, comprueba su suma SHA-256, la descomprime en ~/.local/share/volant y enlaza volant y volant-playbook en ~/.local/bin. El script no pide acceso de root y no escribe nada fuera de esos dos directorios. Lo que Volant escribe después, al ejecutarse, está en Lo que Volant deja en tus máquinas. Puedes leer el script antes de ejecutarlo. Windows todavía no es compatible: un controlador en Windows está en la hoja de ruta.

No necesitas tener Ansible instalado. En la primera ejecución que necesite Python, Volant descarga su propia copia de Python y ansible-core, unos 155 MB, y la guarda en ~/.local/share/volant/runtime. Imprime una línea cuando lo hace. Lo que Volant deja en tus máquinas enumera todo lo que escribe.

Comprueba que ha funcionado:

Ventana de terminal
volant --version

Si tu shell no encuentra volant, añade ~/.local/bin a tu PATH. El script imprime la línea que debes añadir cuando falta.

El script lee cuatro variables de entorno y acepta una opción, --shims, que hace lo que hace VOLANT_SHIMS=1:

Variable Valor por defecto Qué cambia
VOLANT_VERSION la versión más reciente La versión que se instala, como v0.1.0-alpha.10.
VOLANT_HOME ~/.local/share/volant Dónde se descomprimen las versiones.
VOLANT_BIN_DIR ~/.local/bin Dónde van los enlaces volant y volant-playbook.
VOLANT_SHIMS sin definir Con 1, enlaza también los nombres ansible-*. Mira más abajo.
Ventana de terminal
curl -fsSL https://volant.sh/install.sh | VOLANT_VERSION=v0.1.0-alpha.10 sh

Conservar tus líneas de comandos de ansible

Sección titulada «Conservar tus líneas de comandos de ansible»

Con --shims, el script también enlaza los nueve nombres de programa de ansible-core con volant, para que tus líneas de comandos existentes sigan funcionando: ansible, ansible-config, ansible-console, ansible-doc, ansible-galaxy, ansible-inventory, ansible-playbook, ansible-pull y ansible-vault.

Ventana de terminal
curl -fsSL https://volant.sh/install.sh | sh -s -- --shims
curl -fsSL https://volant.sh/install.sh | VOLANT_SHIMS=1 sh

Nombres de comandos de ansible lista qué ejecuta cada nombre y qué difiere. El script nunca los instala por defecto. Ejecuta volant shims install, que deja intacto un archivo o enlace que no creó y avisa cuando un Ansible real del PATH queda oculto o sigue ejecutándose primero. Si un nombre no se pudo enlazar, el script imprime some ansible-* names were not linked, see above y aun así sale con 0, porque Volant está instalado.

La acción setup-volant instala Volant en un workflow. Ejecuta el script de instalación de arriba, así que comprueba la misma suma SHA-256, y añade el directorio del enlace volant al PATH de los pasos siguientes. Funciona en runners de Linux y macOS.

steps:
- uses: actions/checkout@v7
- uses: lorica-labs/volant/setup-volant@main
with:
version: v0.1.0-alpha.13
shims: true
- run: ansible-playbook -i inventory.yml site.yml

uses: acepta una rama, una etiqueta o un commit del repositorio volant. La acción está en cada versión publicada después de 0.1.0-alpha.13. Fija también version, para que una versión nueva no cambie lo que ejecuta el workflow.

Entrada Por defecto Qué hace
version la versión más reciente La versión que se instala, por ejemplo v0.1.0-alpha.13.
shims false Enlaza también los nombres ansible-*, como --shims.
runtime false Instala el runtime gestionado en este paso en lugar de en la primera ejecución que lo necesite.
collections vacío Colecciones que se instalan en el runtime, como con volant runtime install --collections: nombres con un :version opcional, o un archivo requirements, separados por espacios o saltos de línea.
python vacío Define VOLANT_PYTHON. Las ejecuciones usan entonces ese intérprete y nunca instalan el runtime.

Con runtime o collections, la acción guarda el directorio del runtime en caché con actions/cache. La clave de la caché se forma con el sistema y la arquitectura del runner, la versión de Volant, las colecciones y el contenido de cualquier archivo requirements entre ellas, así que una ejecución posterior con las mismas entradas restaura el runtime en lugar de descargarlo.

La versión tiene dos ejecutables. volant lleva dentro los agentes que sube a tus hosts. Un agente es un programa pequeño que ejecuta tus tareas en un host. No hay nada más que instalar ni nada que mantener a su lado:

Archivo Qué es
volant El controlador, el comando que ejecutas.
volant-playbook El mismo controlador con un nombre que se parece a ansible-playbook.
ansible, ansible-vault y los otros siete nombres Enlaces opcionales a volant, solo con --shims. Consulta Nombres de comandos de ansible.

En el primer uso, el controlador escribe sus agentes en ~/.cache/volant/agents/<version>/, o bajo $XDG_CACHE_HOME si está definida: el agente de tu propia máquina, que usa ansible_connection=local, y los que sube a hosts Linux x86_64 y arm64. Las ejecuciones siguientes los reutilizan, y una copia que no coincide con el agente integrado en el controlador se vuelve a escribir.

Cada versión incluye un archivo por plataforma. Linux tiene una compilación estática y otra con glibc. macOS tiene una sola, que enlaza las bibliotecas del sistema.

Plataforma Archivo Enlazado Mínimo Necesita además
Linux x86_64, estática volant-x86_64-unknown-linux-musl.tar.xz Estático. Sin libc. Cualquier Linux cliente ssh, Python para los módulos de Python
Linux x86_64, glibc volant-x86_64-unknown-linux-gnu.tar.xz Dinámico, solo glibc glibc 2.17 cliente ssh, Python para los módulos de Python
Linux arm64, estática volant-aarch64-unknown-linux-musl.tar.xz Estático. Sin libc. Cualquier Linux cliente ssh, Python para los módulos de Python
Linux arm64, glibc volant-aarch64-unknown-linux-gnu.tar.xz Dinámico, solo glibc glibc 2.17 cliente ssh, Python para los módulos de Python
macOS, Apple silicon volant-aarch64-apple-darwin.tar.xz Dinámico, solo bibliotecas del sistema macOS 11 cliente ssh, Python para los módulos de Python
macOS, Intel volant-x86_64-apple-darwin.tar.xz Dinámico, solo bibliotecas del sistema macOS 10.12 cliente ssh, Python para los módulos de Python

Las dos compilaciones de Linux ejecutan el mismo código y llevan los mismos agentes. La estática funciona en cualquier distribución, incluidas Alpine y un contenedor sin libc. La de glibc necesita glibc 2.17 o posterior, lo que cubre Debian 8, Ubuntu 14.04, RHEL y CentOS 7 y todo lo posterior, y recibe las actualizaciones de seguridad de la libc del sistema.

El script de instalación siempre toma la compilación estática en Linux. volant-installer.sh toma la de glibc con glibc 2.17 o posterior y la estática en cualquier otro Linux. cargo binstall toma la de glibc en cualquier host con glibc y la estática en Alpine. En un host con glibc anterior a 2.17, descarga el archivo estático a mano.

La compilación estática no necesita nada de la imagen, así que funciona en un contenedor construido FROM scratch:

FROM scratch
COPY volant /volant
ENTRYPOINT ["/volant"]

Una imagen scratch no tiene ssh, ni Python, ni shell, ni /etc/passwd. Con solo el controlador dentro, un playbook puede ejecutarse con connection: local y usar command con argv. Las conexiones SSH necesitan un cliente ssh en la imagen, los módulos de Python y la recopilación de facts necesitan Python, y shell y raw necesitan un shell. El controlador guarda el agente que extrae en ~/.cache/volant, o bajo $XDG_CACHE_HOME si está definida: dale un directorio en el que pueda escribir.

  • Linux o macOS.
  • El cliente OpenSSH en tu PATH. Volant ejecuta ssh por sí mismo, así que se aplica tu ~/.ssh/config.
  • curl o wget, y tar, la primera vez que un playbook necesita Python.
  • Para usar el script de instalación o descomprimir una versión a mano, curl, tar, sha256sum o shasum, y xz en Linux.

Para los módulos que se ejecutan en Python, Volant usa un Python 3 con ansible-core. Si no encuentra ninguno, descarga el suyo (unos 155 MB), comprueba cada archivo contra un hash fijado y lo guarda en ~/.local/share/volant/runtime. Una ejecución que lo hace imprime una línea. Si ya tienes un Python así, Volant puede usarlo: Qué intérprete usa una ejecución da el orden. Consulta El runtime administrado.

Volant tiene un comando para cada programa de ansible-core, y el script de instalación puede enlazar los nombres ansible-* a ellos. Nombres de comandos de ansible dice cuáles se ejecutan en Volant y cuáles ejecutan la herramienta propia de ansible-core desde el runtime administrado.

Un playbook compuesto solo por command, shell, raw y módulos que se ejecutan en el controlador, con gather_facts: false, no necesita Python en absoluto.

Vuelve a ejecutar el comando de instalación. Instala la versión más reciente junto a las que ya tienes y apunta los enlaces a ella. Las versiones anteriores se quedan en ~/.local/share/volant, así que volver atrás es cuestión de definir VOLANT_VERSION.

Ventana de terminal
# Only pre-releases exist so far, so name the version.
cargo binstall volant@0.1.0-alpha.10

Descarga un binario de la versión con sus agentes incluidos. En un host con glibc es la compilación de glibc, y en Alpine la estática.

Elimina el directorio de la versión, los enlaces y las cachés del controlador. En cada host, la caché del agente es un directorio por cada cuenta con la que actuó la ejecución. Nada más cambia en tu proyecto, así que volver a ansible-playbook no requiere nada adicional:

Ventana de terminal
volant runtime remove --all
volant shims remove
rm -rf ~/.local/share/volant ~/.local/bin/volant ~/.local/bin/volant-playbook ~/.cache/volant
ssh web1 'rm -rf ~/.ansible/tmp/volant-*'