Rollenname

Hier steht eine kurze Beschreibung der Rolle.

Anforderungen

Hier sollten alle Voraussetzungen erwähnt werden, die möglicherweise nicht von Ansible selbst oder der Rolle abgedeckt sind. Zum Beispiel, wenn die Rolle das EC2-Modul verwendet, könnte es sinnvoll sein, in diesem Abschnitt zu erwähnen, dass das Boto-Paket erforderlich ist.

Rollenvariablen

Hier sollte eine Beschreibung der einstellbaren Variablen für diese Rolle stehen, einschließlich aller Variablen, die in defaults/main.yml, vars/main.yml und allen Variablen vorhanden sind, die über Parameter an die Rolle übergeben werden können/sollten. Alle Variablen, die aus anderen Rollen und/oder dem globalen Bereich (z. B. hostvars, group vars usw.) gelesen werden, sollten hier ebenfalls erwähnt werden.

Abhängigkeiten

Hier sollte eine Liste anderer in Galaxy gehosteter Rollen stehen, sowie alle Details zu Parametern, die für andere Rollen gesetzt werden müssen, oder Variablen, die aus anderen Rollen verwendet werden.

Beispiel-Playbook

Es ist immer schön für die Benutzer, ein Beispiel für die Verwendung Ihrer Rolle (zum Beispiel, mit als Parameter übergebenen Variablen) einzuschließen:

- hosts: servers
  roles:
     - { role: benutzername.rollenname, x: 42 }

Lizenz

BSD

Autoreninformation

Ein optionaler Abschnitt, in dem die Autoren der Rolle Kontaktinformationen oder eine Website einfügen können (HTML ist nicht erlaubt).