Rollenname

Hier kommt eine kurze Beschreibung der Rolle hin.

Anforderungen

Alle Voraussetzungen, die möglicherweise nicht durch Ansible selbst oder die Rolle abgedeckt sind, sollten hier erwähnt werden. Wenn die Rolle beispielsweise das EC2-Modul verwendet, ist es sinnvoll, in diesem Abschnitt darauf hinzuweisen, dass das Boto-Paket erforderlich ist.

Rollenvariablen

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

Abhängigkeiten

Eine Liste anderer Rollen, die auf Galaxy gehostet sind, sollte hier aufgeführt werden, sowie alle Details zu Parametern, die für andere Rollen gesetzt werden müssen, oder Variablen, die aus anderen Rollen verwendet werden.

Beispiel-Playbook

Ein Beispiel, wie man deine Rolle verwendet (zum Beispiel mit Variablen, die als Parameter übergeben werden), ist auch für die Benutzer hilfreich:

- 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 anzugeben (HTML ist nicht erlaubt).