Rollenname

Hier steht eine kurze Beschreibung der Rolle.

Anforderungen

Hier sollten alle Voraussetzungen erwähnt werden, die möglicherweise nicht durch Ansible selbst oder die Rolle abgedeckt sind. Wenn die Rolle zum Beispiel das EC2-Modul verwendet, ist es sinnvoll 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 vorhanden sind und jeder Variablen, die über Parameter an die Rolle übergeben werden können/sollten. Alle Variablen, die aus anderen Rollen und/oder dem globalen Scope (z.B. Hostvars, Gruppenvariablen usw.) gelesen werden, sollten ebenfalls hier erwähnt werden.

Abhängigkeiten

Eine Liste von anderen Rollen, die auf Galaxy gehostet werden, sollte hier stehen, sowie alle Einzelheiten zu Parametern, die möglicherweise 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 Nutzer, ein Beispiel zu haben, wie man die Rolle verwendet (zum Beispiel, mit übergebenen Variablen als Parameter):

- hosts: server
  roles:
     - { role: username.rolename, x: 42 }

Lizenz

BSD

Autoreninformation

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