Rollenname

Hier folgt eine kurze Beschreibung der Rolle.

Anforderungen

Alle Voraussetzungen, die möglicherweise nicht von Ansible selbst oder der Rolle abgedeckt sind, sollten hier erwähnt werden. Wenn die Rolle beispielsweise das EC2-Modul verwendet, ist es sinnvoll zu erwähnen, dass das Paket boto 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 alle Variablen, die über Parameter an die Rolle übergeben werden können/sollten. Auch Variablen, die aus anderen Rollen und/oder dem globalen Bereich (d.h. hostvars, group vars usw.) gelesen werden, sollten hier erwähnt werden.

Abhängigkeiten

Hier sollte eine Liste anderer Rollen auf Galaxy stehen, sowie alle Details bezüglich der Parameter, die für andere Rollen gesetzt werden müssen, oder Variablen, die aus anderen Rollen verwendet werden.

Beispiel-Playbook

Es ist immer hilfreich für die Benutzer, ein Beispiel dafür einzufügen, wie man die Rolle verwendet (zum Beispiel mit Variablen, die als Parameter übergeben werden):

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

Lizenz

BSD

Autoreninformation

Ein optionaler Abschnitt für die Autoren der Rolle, um Kontaktinformationen oder eine Webseite hinzuzufügen (HTML ist nicht erlaubt).