Zum Inhalt springen
Installieren

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.

  1. Legen Sie ein Inventory mit einem Host an, der ohne SSH erreicht wird:

    inventory.ini
    localhost ansible_connection=local
  2. Schreiben Sie ein 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. Führen Sie es aus. volant playbook nimmt dieselben Argumente wie ansible-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=0

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.

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"
Terminal-Fenster
volant playbook -i inventory.ini site.yml

Ihre ~/.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.

Volant liest ein Ansible-Projekt so, wie es ist. Führen Sie es im Projektverzeichnis aus, oder richten Sie -i auf das Inventory:

  • ansible.cfg wird an denselben Stellen gelesen wie unter Ansible, und ANSIBLE_*-Variablen gelten. Siehe Konfiguration.
  • Inventories als INI, YAML oder Skript, mit group_vars/ und host_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-pass oder eine Vault-Passwortdatei übergeben. Siehe Vault.
  • Rollen werden in roles/ und in roles_path gefunden, samt ihren Defaults, Handlern und Abhängigkeiten. Siehe Rollen, Includes und Imports.
  • Collections funktionieren, sobald sie mit volant runtime install --collections installiert 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.

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