Instalación
Instala Volant con un solo comando, comprueba qué necesitan el controlador y los hosts, y mantenlo al día.
Instalar
Sección titulada «Instalar»curl -fsSL https://volant.sh/install.sh | shEl 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:
volant --versionSi tu shell no encuentra volant, añade ~/.local/bin a tu PATH. El script imprime la línea que debes añadir cuando falta.
Opciones
Sección titulada «Opciones»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. |
curl -fsSL https://volant.sh/install.sh | VOLANT_VERSION=v0.1.0-alpha.10 shConservar 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.
curl -fsSL https://volant.sh/install.sh | sh -s -- --shimscurl -fsSL https://volant.sh/install.sh | VOLANT_SHIMS=1 shNombres 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.
En GitHub Actions
Sección titulada «En GitHub Actions»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.ymluses: 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.
Qué obtienes
Sección titulada «Qué obtienes»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.
Compilaciones y plataformas
Sección titulada «Compilaciones y plataformas»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.
En un contenedor
Sección titulada «En un contenedor»La compilación estática no necesita nada de la imagen, así que funciona en un contenedor construido FROM scratch:
FROM scratchCOPY volant /volantENTRYPOINT ["/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.
Qué necesitan las máquinas
Sección titulada «Qué necesitan las máquinas»- Linux o macOS.
- El cliente OpenSSH en tu
PATH. Volant ejecutasshpor sí mismo, así que se aplica tu~/.ssh/config. curlowget, ytar, la primera vez que un playbook necesita Python.- Para usar el script de instalación o descomprimir una versión a mano,
curl,tar,sha256sumoshasum, yxzen 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.
- Linux, x86_64 o arm64.
- Un servidor SSH y una cuenta en la que puedas iniciar sesión con una clave o un ssh-agent.
- Un intérprete de Python 3 para los módulos de Python y la recopilación de facts. El host no necesita ansible-core: Volant envía cada archivo que importa un módulo.
sudosi usasbecome.
No hay que instalar nada a mano. El controlador sube el agente con la primera tarea y lo guarda en caché en ~/.ansible/tmp.
Actualizar
Sección titulada «Actualizar»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.
Otras formas de instalar
Sección titulada «Otras formas de instalar»# Only pre-releases exist so far, so name the version.cargo binstall volant@0.1.0-alpha.10Descarga 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.
Cada versión de la página de versiones tiene un archivo por plataforma, con el nombre volant-<target>.tar.xz como en la tabla anterior, y un archivo .sha256 a su lado. Descomprímelo (requiere xz) y pon volant en tu PATH:
tar -xJf volant-x86_64-unknown-linux-musl.tar.xzinstall -m 755 volant-x86_64-unknown-linux-musl/volant ~/.local/bin/volantcargo install --git https://github.com/lorica-labs/volant volantUna compilación desde el código fuente no lleva los agentes, porque se compilan de forma cruzada para los hosts. Apunta VOLANT_AGENT_DIR a un directorio que los contenga, o constrúyelos desde una copia del repositorio: cargo build deja un agente local junto al controlador, y just agent-musl construye el de Linux x86_64. just smoke-embedded muestra cómo una compilación de versión los integra.
Desinstalar
Sección titulada «Desinstalar»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:
volant runtime remove --allvolant shims removerm -rf ~/.local/share/volant ~/.local/bin/volant ~/.local/bin/volant-playbook ~/.cache/volantssh web1 'rm -rf ~/.ansible/tmp/volant-*'