:sourcedir: ../../../

= Ansible-template

Template Sammlung zur einfachen automation mit Ansible innerhalb der Gitlab CI.

Erwartet das $SSH_PRIVATE_KEY in den Gitlab CI Variablen gesetzt ist.

.Angebotene Templates:
|===
|Name |Description
|.ansible_lint | Ruft den Linter von Ansible auf.
Der Output wird dann in der CI gezeigt und kann den Stil der Playbooks verbessern.
|.ansible_playbook_validate | Validiert, ob die Playbooks ausgeführt werden können und syntaktisch Sinn ergeben.
|.ansible_playbook_run | Führt die Playbooks auf dem Inventar aus.
|===

.Variables
|===
|Name |Description | Default Value
|SSH_PRIVATE_KEY | SSH Key der von Ansible benutzt wird, um sich im Inventar anzumelden.
!!
Nicht in .gitlab.yml setzen. Statt dessen durch den CI Maintainer in den Gitlab Settings setzen lassen. | Nicht gesetzt. Muss in den Gitlab CI Variablen in den Settings gesetzt werden.
|PLAYBOOK_PATH | Path zum Playbook das ausgeführt werden soll  | "playbook.yml"
|INVENTORY_PATH | Path zum Inventory das ausgeführt werden soll  | "inventory.yml"
|EXTRA_ARGS  | Extra Argumente für die Scripte | ""
|===

.Ansible-template
[source,yaml]
----
include::{sourcedir}/ansible.gitlab-ci.yml[]
----