wangsha.docker-grafana

Descripción general Versiones Perspectivas

docker-grafana

Rol de Ansible para gestionar y ejecutar el contenedor docker de grafana.

Requisitos

Este rol solo ha sido probado en Ubuntu 14.04. Dado que utiliza el módulo docker de Ansible, necesitarás asegurarte de que tienes una versión reciente de docker-py y docker instalados.

Ejemplos

Instala este módulo desde Ansible Galaxy en el directorio './roles':

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

Úsalo en un playbook de la siguiente manera, asumiendo que ya tienes Docker configurado:

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

Consulta el defaults/main.yml para ver las variables del rol que se pueden sobrescribir. La lista completa de variables de entorno se puede encontrar aquí

Configuración de ejemplo que permite el registro a través de 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: tuorganizacionengithub

Si necesitas un playbook para configurar Docker, consulta el rol de Galaxy angstwad.docker_ubuntu.

La imagen docker predeterminada utilizada es grafana/grafana. El puerto por defecto es 3000, la cuenta del administrador es admin/admin.

Mapeos de volúmenes personalizados

Docker permite montar un directorio o un archivo del host como volumen de datos. Este rol monta directorios del host para persistir datos del contenedor y archivos del host para configurar el comportamiento del contenedor. docker_grafana_directory_volumes y docker_grafana_file_volumes son las dos variables para controlar los mapeos de volúmenes. Si deseas personalizar el mapeo, sigue el formato <directorio_del_host>:<directorio_del_contenedor>:<modo_de_mapeo> para asegurarte de que los directorios del host se crean correctamente antes de lanzar contenedores.

Para personalizar los mapeos de archivos del host, actualiza docker_grafana_file_volumes. Este rol creará automáticamente los directorios padre de los archivos y copiará la plantilla a la máquina host. La convención de nombres para la plantilla es <nombre_del_archivo_del_host>.<extensión_del_archivo_del_host>.j2. Para copiar la plantilla desde tus propios directorios de Ansible, establece docker_grafana_template_path.

Ejemplo de configuración:

docker_grafana_file_volumes:
  - '/opt/myapp/conf/settings.conf:/etc/myapp/conf/settings.conf:ro'
docker_grafana_template_path: /ruta/a/tu/proyecto/ansible/templates/
# asegúrate de que el archivo /ruta/a/tu/proyecto/ansible/templates/settings.conf.j2 exista.