docker-graphite

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

Exigences

Ce rôle n'a été testé que sur Ubuntu 14.04. Comme il utilise le module Docker d'Ansible, assurez-vous qu'une version 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-graphite -p ./roles

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

- hosts: 'serveurs'
  roles:
    - role: 'wangsha.docker-graphite'
      become: true
      graphite_storage_schemas_extra:
        statsd: |
          priority = 110
          pattern = ^stats.*
          retentions = 10s:6h,1m:7d,10m:1y

Consultez le fichier defaults/main.yml pour les variables de rôle qui peuvent être remplacées.

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 hopsoft/graphite-statsd. Cette image contient à la fois graphite et statsd. Pour désactiver statsd, retirez les correspondances de port. Le compte d'authentification de base est root/root. Modifiez docker_graphite_htpasswd_users pour changer les comptes par défaut.

Mappages de volumes personnalisés

Docker permet de monter un répertoire ou un fichier hôte comme 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. docker_graphite_directory_volumes et docker_graphite_file_volumes sont les deux variables pour contrôler les mappages de volume. Si vous souhaitez personnaliser le mappage, veuillez suivre le format <répertoire hôte>:<répertoire conteneur>:<mode de mappage> pour vous assurer 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_graphite_file_volumes. Ce rôle créera automatiquement les répertoires parents des fichiers et copiera le modèle vers la machine hôte. La convention de nommage pour le modèle est <nom_fichier_hôte>.<extension_fichier_hôte>.j2. Pour copier des modèles depuis vos propres répertoires Ansible, définissez docker_graphite_template_path.

Exemple de configuration :

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

Licence

MIT

Informations sur l'auteur

• wangsha