wangsha.docker-grafana

docker-grafana

Ansible-Rolle zur Verwaltung und Ausführung des Grafana-Docker-Containers.

Anforderungen

Diese Rolle wurde nur auf Ubuntu 14.04 getestet. Da sie Ansible's Docker-Modul verwendet, müssen Sie sicherstellen, dass eine aktuelle Version von docker-py und docker installiert ist.

Beispiele

Installieren Sie dieses Modul von Ansible Galaxy im Verzeichnis './roles':

ansible-galaxy install wangsha.docker-grafana -p ./roles

Verwenden Sie es in einem Playbook wie folgt, vorausgesetzt, Sie haben Docker bereits eingerichtet:

- hosts: 'servers'
  roles:
    - role: 'wangsha.docker-grafana'
      become: true

Werfen Sie einen Blick in die defaults/main.yml für Rollvariablen, die überschrieben werden können. Eine vollständige Liste der Umgebungsvariablen finden Sie hier.

Beispielkonfiguration, die die Anmeldung über GitHub ermöglicht.

- role: docker-grafana
      docker_grafana_ports:
        - 8080:3000
      docker_grafana_env:
        GF_SECURITY_ADMIN_USER: myadmin
        GF_SECURITY_ADMIN_PASSWORD: myadmin
        GF_USERS_ALLOW_SIGN_UP: true
        GF_SERVER_ROOT_URL: http://localhost:8080/
        GF_AUTH_GITHUB_ALLOW_SIGN_UP: true
        GF_AUTH_GITHUB_ENABLED: true
        GF_AUTH_GITHUB_SCOPES: user:email,read:org
        GF_AUTH_GITHUB_CLIENT_ID: XXXX
        GF_AUTH_GITHUB_CLIENT_SECRET: XXXX
        GF_AUTH_GITHUB_ALLOWED_ORGANIZATIONS: yourgithuborganization

Wenn Sie ein Playbook benötigen, um Docker selbst einzurichten, werfen Sie einen Blick auf angstwad.docker_ubuntu Galaxy-Rolle.

Das verwendete Standard-Docker-Image ist grafana/grafana. Der Standardport ist 3000, das Admin-Konto ist admin/admin.

Benutzerdefinierte Volumen-Mappings

Docker erlaubt es, ein Verzeichnis oder eine Datei des Hosts als Datenvolumen zu mounten. Diese Rolle bindet Hostverzeichnisse, um die Daten des Containers persistent zu halten, und Hostdateien, um das Verhalten des Containers zu konfigurieren. docker_grafana_directory_volumes und docker_grafana_file_volumes sind die beiden Variablen zur Steuerung der Volumen-Mappings. Wenn Sie das Mapping anpassen möchten, befolgen Sie das Format <host directory>:<container directory>:<mapping mode>, um sicherzustellen, dass die Hostverzeichnisse vor dem Start der Container korrekt erstellt werden.

Um die Host-Dateimappings anzupassen, aktualisieren Sie docker_grafana_file_volumes. Diese Rolle wird automatisch übergeordnete Verzeichnisse für die Datei erstellen und die Vorlage auf die Hostmaschine kopieren. Die Benennungskonvention für Vorlagen lautet <host_file_name>.<host_file_extension>.j2. Um die Vorlage aus Ihren eigenen Ansible-Verzeichnissen zu kopieren, setzen Sie docker_grafana_template_path.

Beispielkonfiguration:

docker_grafana_file_volumes:
  - '/opt/myapp/conf/settings.conf:/etc/myapp/conf/settings.conf:ro'
docker_grafana_template_path: /path/to/ansible/project/templates/
# Stellen Sie sicher, dass die Datei /path/to/ansible/project/templates/settings.conf.j2 existiert.