Ir al contenido
Instalar

Guía rápida

Ejecuta un primer playbook en tu propia máquina y después en un host remoto por SSH.

Esta página da por hecho que volant está en tu PATH. Si no es así, empieza por la instalación.

  1. Crea un inventario con un host, al que se llega sin SSH:

    inventory.ini
    localhost ansible_connection=local
  2. Escribe un playbook:

    site.yml
    - hosts: localhost
    gather_facts: false
    tasks:
    - name: Who am I?
    command: id -un
    register: me
    - name: Say hello
    debug:
    msg: "Hello from {{ me.stdout }}"
  3. Ejecútalo. volant playbook acepta los mismos argumentos que ansible-playbook:

    Ventana de terminal
    volant playbook -i inventory.ini site.yml

La salida es la que ya conoces de Ansible:

PLAY [localhost] ***************************************************************
TASK [Who am I?] ***************************************************************
changed: [localhost]
TASK [Say hello] ***************************************************************
ok: [localhost] => {
"msg": "Hello from alice"
}
PLAY RECAP *********************************************************************
localhost : ok=2 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0

El host necesita un servidor SSH y una cuenta en la que puedas iniciar sesión con una clave. No necesita Volant: el controlador sube su agente, un programa pequeño de unos 1.2 MB, con la primera tarea y lo guarda en ~/.ansible/tmp del host para la ejecución siguiente.

inventory.ini
[web]
web1 ansible_host=192.0.2.10 ansible_user=deploy
site.yml
- hosts: web
tasks:
- name: Show the distribution
debug:
msg: "{{ ansible_distribution }} {{ ansible_distribution_version }}"
- name: Make sure the release directory exists
become: true
file:
path: /srv/app
state: directory
mode: "0755"
Ventana de terminal
volant playbook -i inventory.ini site.yml

Se aplica tu ~/.ssh/config, porque Volant ejecuta el ssh que ya tienes. Un archivo de clave o un ssh-agent es la forma más sencilla de iniciar sesión. Para usar una contraseña, pasa -k o define ansible_password.

Volant lee un proyecto de Ansible tal como está. Ejecútalo desde el directorio del proyecto, o apunta -i al inventario:

  • ansible.cfg se lee de los mismos lugares que con Ansible, y las variables ANSIBLE_* se aplican. Consulta Configuración.
  • Los inventarios en formato INI, YAML o script, con group_vars/ y host_vars/ a su lado, funcionan sin cambios. Consulta Inventarios y Precedencia y facts.
  • Los archivos y variables cifrados con vault se descifran cuando pasas --ask-vault-pass o un archivo con la contraseña de vault. Consulta Vault.
  • Los roles se encuentran en roles/ y en roles_path, con sus defaults, handlers y dependencias. Consulta Roles, includes e imports.
  • Las colecciones funcionan una vez instaladas con volant runtime install --collections.

Antes de la primera ejecución real, comprueba qué no puede hacer esta versión con ¿Se ejecutará mi playbook?. Lee el playbook y enumera lo que haría una ejecución sin conectarse a nada.

Volant encuentra los roles, group_vars y host_vars donde los encuentra Ansible:

  • ansible.cfg
  • inventory.ini
  • site.yml
  • Directoriogroup_vars/
    • all.yml
    • web.yml
  • Directoriohost_vars/
    • web1.yml
  • Directorioroles/
    • Directorionginx/
      • defaults/main.yml
      • handlers/main.yml
      • tasks/main.yml