paulfantom.rpi_exporter

Ansible-Rolle: rpi_exporter

Beschreibung

Setze rpi-exporter mit Ansible ein.

Anforderungen

Ansible >= 2.7 (Es könnte auch mit früheren Versionen funktionieren, aber wir können das nicht garantieren)

Rollenvariablen

Alle variablen, die überschrieben werden können, sind in der Datei defaults/main.yml sowie in der folgenden Tabelle gespeichert.

Name	Standardwert	Beschreibung
`rpi_exporter_version`	0.6.0	Verpackte Version des rpi-exporters. Akzeptiert auch `latest` als Parameter.
`rpi_exporter_web_listen_address`	"0.0.0.0:9243"	Adresse, an der rpi_exporter lauscht
`rpi_exporter_system_group`	"rpi-exporter"	Systemgruppe, die zum Ausführen von rpi-exporter verwendet wird
`rpi_exporter_system_user`	"rpi-exporter"	Systembenutzer, der rpi-exporter ausführt

Beispiel

Playbook

Verwende es in einem Playbook wie folgt:

- hosts: alle
  roles:
    - paulfantom.rpi_exporter

Lokales Testen

Die bevorzugte Methode, um die Rolle lokal zu testen, ist die Verwendung von Docker und molecule (v2.x). Du musst Docker auf deinem System installieren. Siehe "Erste Schritte" für ein Docker-Paket, das für dein System geeignet ist. Wir verwenden tox, um den Prozess des Testens mit mehreren Ansible-Versionen zu vereinfachen. Um tox zu installieren, führe aus:

pip3 install tox

Um Tests mit allen Ansible-Versionen auszuführen (WARNUNG: Das kann einige Zeit in Anspruch nehmen):

tox

Um einen benutzerdefinierten Molecule-Befehl in einer benutzerdefinierten Umgebung mit nur dem Standardszenario auszuführen:

tox -e py35-ansible28 -- molecule test -s default

Für weitere Informationen über Molecule gehe zu ihren Dokumenten.

Wenn du Tests auf einem entfernten Docker-Host ausführen möchtest, gib einfach die Variable DOCKER_HOST an, bevor du die tox-Tests ausführst.

Travis CI

Die Kombination aus Molecule und Travis CI ermöglicht es uns, zu testen, wie neue PRs sich verhalten, wenn sie mit mehreren Ansible-Versionen und mehreren Betriebssystemen verwendet werden. Dies ermöglicht es uns auch, Testszenarien für verschiedene Rollen-Konfigurationen zu erstellen. Infolgedessen haben wir eine ziemlich große Testmatrix, die länger dauert als lokale Tests. Bitte sei geduldig.