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.
Exécuter un playbook sur cette machine
Section intitulée « Exécuter un playbook sur cette machine »-
Créez un inventaire avec un seul hôte, joint sans SSH :
inventory.ini localhost ansible_connection=local -
Écrivez un playbook :
site.yml - hosts: localhostgather_facts: falsetasks:- name: Who am I?command: id -unregister: me- name: Say hellodebug:msg: "Hello from {{ me.stdout }}" -
Exécutez-le.
volant playbookprend les mêmes arguments queansible-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=0L’exécuter sur un hôte distant
Section intitulée « L’exécuter sur un hôte distant »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.
[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.ymlVotre ~/.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.
Votre projet existant
Section intitulée « Votre projet existant »Volant lit un projet Ansible tel quel. Lancez-le depuis le répertoire du projet, ou faites pointer -i vers l’inventaire :
ansible.cfgest lu aux mêmes endroits que sous Ansible, et les variablesANSIBLE_*s’appliquent. Voir Configuration.- Les inventaires en INI, en YAML ou sous forme de script, avec
group_vars/ethost_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-passou un fichier de mot de passe vault. Voir Vault. - Les rôles sont trouvés dans
roles/et dansroles_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.
Une arborescence de projet qui fonctionne
Section intitulée « Une arborescence de projet qui fonctionne »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
Étapes suivantes
Section intitulée « Étapes suivantes »- Mon playbook va-t-il s’exécuter ? vérifie un projet existant.
- Ce que Volant laisse sur vos machines liste ce qu’il écrit sur le contrôleur et sur les hôtes.
- Exécution des plays explique ce qui se passe entre la première ligne et le récapitulatif.
- Ligne de commande liste toutes les options.