Schnellstart
Führen Sie ein erstes Playbook auf Ihrem eigenen Rechner aus und dann auf einem entfernten Host über SSH.
Diese Seite setzt voraus, dass volant in Ihrem PATH liegt. Ist das nicht der Fall, beginnen Sie mit der Installation.
Ein Playbook auf diesem Rechner ausführen
Abschnitt betitelt „Ein Playbook auf diesem Rechner ausführen“-
Legen Sie ein Inventory mit einem Host an, der ohne SSH erreicht wird:
inventory.ini localhost ansible_connection=local -
Schreiben Sie ein Playbook:
site.yml - hosts: localhostgather_facts: falsetasks:- name: Who am I?command: id -unregister: me- name: Say hellodebug:msg: "Hello from {{ me.stdout }}" -
Führen Sie es aus.
volant playbooknimmt dieselben Argumente wieansible-playbook:Terminal-Fenster volant playbook -i inventory.ini site.yml
Die Ausgabe kennen Sie von 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=0Auf einem entfernten Host ausführen
Abschnitt betitelt „Auf einem entfernten Host ausführen“Der Host braucht einen SSH-Server und ein Konto, bei dem Sie sich mit einem Schlüssel anmelden können. Er braucht Volant nicht: Der Controller lädt seinen Agent, ein kleines Programm von etwa 1,2 MB, mit dem ersten Task hoch und behält ihn für den nächsten Lauf in ~/.ansible/tmp auf dem Host.
[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.ymlIhre ~/.ssh/config gilt, weil Volant das ssh ausführt, das Sie bereits haben. Eine Schlüsseldatei oder ein ssh-agent ist der einfachste Weg zur Anmeldung. Für ein Passwort übergeben Sie -k oder setzen ansible_password.
Ihr bestehendes Projekt
Abschnitt betitelt „Ihr bestehendes Projekt“Volant liest ein Ansible-Projekt so, wie es ist. Führen Sie es im Projektverzeichnis aus, oder richten Sie -i auf das Inventory:
ansible.cfgwird an denselben Stellen gelesen wie unter Ansible, undANSIBLE_*-Variablen gelten. Siehe Konfiguration.- Inventories als INI, YAML oder Skript, mit
group_vars/undhost_vars/daneben, funktionieren unverändert. Siehe Inventories und Rangfolge und Facts. - Mit Vault verschlüsselte Dateien und Variablen werden entschlüsselt, wenn Sie
--ask-vault-passoder eine Vault-Passwortdatei übergeben. Siehe Vault. - Rollen werden in
roles/und inroles_pathgefunden, samt ihren Defaults, Handlern und Abhängigkeiten. Siehe Rollen, Includes und Imports. - Collections funktionieren, sobald sie mit
volant runtime install --collectionsinstalliert sind.
Prüfen Sie vor dem ersten echten Lauf mit Läuft mein Playbook?, was dieses Release nicht kann. Die Seite liest das Playbook und listet auf, was ein Lauf tun würde, ohne sich mit irgendetwas zu verbinden.
Ein Projektlayout, das funktioniert
Abschnitt betitelt „Ein Projektlayout, das funktioniert“Volant findet Rollen, group_vars und host_vars dort, wo Ansible sie findet:
- ansible.cfg
- inventory.ini
- site.yml
Ordnergroup_vars/
- all.yml
- web.yml
Ordnerhost_vars/
- web1.yml
Ordnerroles/
Ordnernginx/
- defaults/main.yml
- handlers/main.yml
- tasks/main.yml
Nächste Schritte
Abschnitt betitelt „Nächste Schritte“- Läuft mein Playbook? prüft ein bestehendes Projekt.
- Was Volant auf Ihren Rechnern ablegt listet auf, was es auf dem Controller und den Hosts schreibt.
- Plays ausführen erklärt, was zwischen der ersten Zeile und dem Recap geschieht.
- Kommandozeile listet jede Option auf.