wangsha.docker-grafana

docker-grafana

Rôle Ansible pour gérer et exécuter le conteneur Docker Grafana.

Exigences

Ce rôle a été testé uniquement sur Ubuntu 14.04. Puisqu'il utilise le module Docker d'Ansible, vous devez vous assurer qu'une version relativement récente de docker-py et docker est installée.

Exemples

Installez ce module depuis Ansible Galaxy dans le répertoire './roles' :

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

Utilisez-le dans un playbook comme suit, en supposant que vous avez déjà configuré Docker :

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

Consultez le defaults/main.yml pour voir les variables de rôle qui peuvent être remplacées. La liste complète des variables d'environnement peut être trouvée ici

Configuration exemple permettant l'inscription via GitHub.

- 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: votreorganisationgithub

Si vous avez besoin d'un playbook pour configurer Docker lui-même, consultez le rôle Galaxy angstwad.docker_ubuntu.

L'image Docker par défaut utilisée est grafana/grafana. Le port par défaut est 3000, et le compte administrateur est admin/admin.

Mappages de volumes personnalisés

Docker permet de monter un répertoire ou un fichier hôte en tant que volume de données. Ce rôle monte des répertoires hôtes pour conserver les données du conteneur et des fichiers hôtes pour configurer le comportement du conteneur. Les variables docker_grafana_directory_volumes et docker_grafana_file_volumes contrôlent les mappages de volumes. Si vous souhaitez personnaliser le mappage, veuillez suivre le format <répertoire_hôte>:<répertoire_conteneur>:<mode_de_mappage> pour garantir que les répertoires hôtes sont correctement créés avant de lancer les conteneurs.

Pour personnaliser les mappages de fichiers hôtes, mettez à jour docker_grafana_file_volumes. Ce rôle créera automatiquement les répertoires parents des fichiers et copiera le modèle sur la machine hôte. La convention de nommage pour le modèle est <nom_fichier_hôte>.<extension_fichier_hôte>.j2. Pour copier un modèle depuis vos propres répertoires Ansible, définissez docker_grafana_template_path.

Configuration Exemple :

docker_grafana_file_volumes:
  - '/opt/myapp/conf/settings.conf:/etc/myapp/conf/settings.conf:ro'
docker_grafana_template_path: /chemin/vers/projet/ansible/templates/
# assurez-vous que le fichier /chemin/vers/projet/ansible/templates/settings.conf.j2 existe.