wangsha.docker-graphite
docker-graphite
Rol de Ansible para gestionar y ejecutar el contenedor de docker graphite.
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 instalada una versión reciente de docker-py
y docker
.
Ejemplos
Instala este módulo desde Ansible Galaxy en el directorio './roles':
ansible-galaxy install wangsha.docker-graphite -p ./roles
Úsalo en un playbook de la siguiente manera, asumiendo que ya tienes docker configurado:
- hosts: 'servers'
roles:
- role: 'wangsha.docker-graphite'
become: true
graphite_storage_schemas_extra:
statsd: |
priority = 110
pattern = ^stats.*
retentions = 10s:6h,1m:7d,10m:1y
Echa un vistazo al archivo defaults/main.yml para las variables del rol que se pueden sobrescribir.
Si necesitas un playbook para configurar Docker, consulta el rol Galaxy angstwad.docker_ubuntu.
La imagen de docker predeterminada utilizada es hopsoft/graphite-statsd.
La imagen contiene tanto graphite como statsd. Para desactivar statsd, elimina los mapeos de puerto correspondientes.
La cuenta de autenticación básica es root/root
. Modifica docker_graphite_htpasswd_users
para cambiar las cuentas predeterminadas.
Mapeos de volumen 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_graphite_directory_volumes
y docker_graphite_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 creen correctamente antes de lanzar los contenedores.
Para personalizar los mapeos de archivos del host, actualiza docker_graphite_file_volumes
.
Este rol creará automáticamente los directorios principales de los archivos y copiará la plantilla
al máquina host. La convención de nombres para la plantilla es <nombre_del_archivo_host>.<extensión_del_archivo_host>.j2
.
Para copiar la plantilla desde tus propios directorios de ansible, establece docker_graphite_template_path
.
Ejemplo de configuración:
docker_graphite_file_volumes:
- '/opt/myapp/conf/settings.conf:/etc/myapp/conf/settings.conf:ro'
docker_graphite_template_path: /path/to/ansible/project/templates/
# asegúrate de que el archivo /path/to/ansible/project/templates/settings.conf.j2 existe.
Licencia
Información del Autor
- wangsha
Ansible role to install graphite docker container.
ansible-galaxy install wangsha.docker-graphite