Aller au contenu
Installer

Démarrage rapide

Exécutez un premier playbook sur votre propre machine, puis sur un hôte distant par SSH.

Cette page suppose que volant est dans votre PATH. Sinon, commencez par Installation.

  1. Créez un inventaire avec un seul hôte, joint sans SSH :

    inventory.ini
    localhost ansible_connection=local
  2. Écrivez 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. Exécutez-le. volant playbook prend les mêmes arguments que ansible-playbook :

    Fenêtre de terminal
    volant playbook -i inventory.ini site.yml

La sortie est celle que vous connaissez d’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

L’hôte a besoin d’un serveur SSH et d’un compte sur lequel vous pouvez vous connecter avec une clé. Il n’a pas besoin de Volant : le contrôleur envoie son agent, un petit programme d’environ 1.2 MB, avec la première tâche et le garde dans ~/.ansible/tmp sur l’hôte pour l’exécution suivante.

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"
Fenêtre de terminal
volant playbook -i inventory.ini site.yml

Votre ~/.ssh/config s’applique, parce que Volant lance le ssh que vous avez déjà. Un fichier de clé ou un ssh-agent est le moyen le plus simple de se connecter. Pour utiliser un mot de passe, passez -k ou définissez ansible_password.

Volant lit un projet Ansible tel quel. Lancez-le depuis le répertoire du projet, ou faites pointer -i vers l’inventaire :

  • ansible.cfg est lu aux mêmes endroits que sous Ansible, et les variables ANSIBLE_* s’appliquent. Voir Configuration.
  • Les inventaires en INI, en YAML ou sous forme de script, avec group_vars/ et host_vars/ à côté, fonctionnent sans changement. Voir Inventaires et Priorité et facts.
  • Les fichiers et variables chiffrés avec vault sont déchiffrés quand vous passez --ask-vault-pass ou un fichier de mot de passe vault. Voir Vault.
  • Les rôles sont trouvés dans roles/ et dans roles_path, avec leurs valeurs par défaut, leurs handlers et leurs dépendances. Voir Rôles, includes et imports.
  • Les collections fonctionnent une fois installées avec volant runtime install --collections.

Avant la première vraie exécution, vérifiez ce que cette version ne sait pas faire avec Mon playbook va-t-il s’exécuter ?. Cette page lit le playbook et liste ce qu’une exécution ferait, sans se connecter à rien.

Volant trouve les rôles, group_vars et host_vars là où Ansible les trouve :

  • ansible.cfg
  • inventory.ini
  • site.yml
  • Répertoiregroup_vars/
    • all.yml
    • web.yml
  • Répertoirehost_vars/
    • web1.yml
  • Répertoireroles/
    • Répertoirenginx/
      • defaults/main.yml
      • handlers/main.yml
      • tasks/main.yml