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.
Ejecuta un playbook en esta máquina
Sección titulada «Ejecuta un playbook en esta máquina»-
Crea un inventario con un host, al que se llega sin SSH:
inventory.ini localhost ansible_connection=local -
Escribe un playbook:
site.yml - hosts: localhostgather_facts: falsetasks:- name: Who am I?command: id -unregister: me- name: Say hellodebug:msg: "Hello from {{ me.stdout }}" -
Ejecútalo.
volant playbookacepta los mismos argumentos queansible-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=0Ejecútalo en un host remoto
Sección titulada «Ejecútalo en un host remoto»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.
[web]web1 ansible_host=192.0.2.10 ansible_user=deploy- 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"volant playbook -i inventory.ini site.ymlSe 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.
Tu proyecto existente
Sección titulada «Tu proyecto existente»Volant lee un proyecto de Ansible tal como está. Ejecútalo desde el directorio del proyecto, o apunta -i al inventario:
ansible.cfgse lee de los mismos lugares que con Ansible, y las variablesANSIBLE_*se aplican. Consulta Configuración.- Los inventarios en formato INI, YAML o script, con
group_vars/yhost_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-passo un archivo con la contraseña de vault. Consulta Vault. - Los roles se encuentran en
roles/y enroles_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.
Una estructura de proyecto que funciona
Sección titulada «Una estructura de proyecto que funciona»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
Siguientes pasos
Sección titulada «Siguientes pasos»- ¿Se ejecutará mi playbook? comprueba un proyecto existente.
- Lo que Volant deja en tus máquinas enumera lo que escribe en el controlador y en los hosts.
- Ejecución de plays explica lo que ocurre entre la primera línea y el recap.
- Línea de comandos enumera todas las opciones.