juliendufresne.influxdb
Role de Ansible InfluxDB
Instalación y gestión de InfluxDB completamente configurable.
Puedes gestionar tus usuarios y bases de datos con las variables influxdb_users
y influxdb_databases
.
Plataformas soportadas
Distribución | Última fecha de revisión | Desde cero | Idempotencia |
---|---|---|---|
CentOS 7.2.1511 (Core) | 2016-08-06 18:40:07 | ||
Debian 7.10 (wheezy) | 2016-08-06 18:41:39 | ||
Debian 8.4 (jessie) | 2016-08-06 18:43:44 | ||
Ubuntu 12.04 (precise) | 2016-08-06 18:45:21 | ||
Ubuntu 14.04 (trusty) | 2016-08-06 18:47:32 | ||
Ubuntu 15.04 (vivid) | 2016-08-06 18:49:37 | ||
Ubuntu 15.10 (wily) | 2016-08-06 18:51:39 | ||
Ubuntu 16.04 (xenial) | 2016-08-06 18:53:35 |
Tabla generada con test-ansible-roles
Requisitos
Este rol requiere Ansible 2.1.0+ (apt_repository usa filename)
Módulo influxdb_user
Este rol contiene un módulo para gestionar a tus usuarios de InfluxDB. Puede:
- Asegurar que un usuario esté presente o ausente
- Crear un usuario administrador o un usuario normal
- Gestionar los permisos de acceso a las bases de datos del usuario (NO, LECTURA, ESCRITURA o TODOS los privilegios)
- Agregar tus permisos especificados a los existentes
Para más información sobre este módulo, consulta su documentación dedicada
Nota: Puedes usar este módulo de forma independiente o a través de la variable
influxdb_users
Variables del rol
Todas las variables tienen un valor predeterminado. Este rol se puede ejecutar con la configuración predeterminada.
opciones globales
Nombre | Descripción | Predeterminado |
---|---|---|
influxdb_install_user | Qué usuario se usará para la instalación. | "root" |
influxdb_user | Usuario de InfluxDB | "influxdb" |
influxdb_group | Grupo de InfluxDB | "influxdb" |
influxdb_config_dir | Donde se encuentran los archivos de configuración | "/etc/influxdb" |
influxdb_config_file | Nombre del archivo de configuración | "influxdb.conf" |
influxdb_users | Permite gestionar usuarios (ver abajo) | [] |
influxdb_databases | Permite gestionar bases de datos (ver abajo) | ["_internal"] |
Gestionando usuarios
La variable influxdb_users
permite gestionar la creación de usuarios y la gestión de derechos.
Para cada entrada, el script:
- crea el usuario si no existe
- actualiza la contraseña del usuario si ha cambiado
- otorga el rol de administrador si el
tipo
está configurado comoadmin
- revoca cualquier derecho de base de datos previamente definido
- otorga los derechos especificados a cada base de datos.
Ejemplo:
influxdb_users:
- name: admin
admin: yes
password: admin
- name: grafana
password: grafana
grants: "measurement:READ" # Otorga acceso de LECTURA a la tabla de medidas para el usuario grafana
- type: user
name: telegraf
password: telegraf
grants: "measurement:WRITE" # Otorga acceso de ESCRITURA a la tabla de medidas para el usuario telegraf
- name: john
password: john
grants: "measurement:ALL" # Otorga acceso de LECTURA y ESCRITURA a la tabla de medidas para el usuario telegraf
Por razones de seguridad, no se eliminan bases de datos.
Gestionando bases de datos
Asegura que las bases de datos listadas en influxdb_databases
estén creadas.
Ejemplo:
influxdb_databases:
- "_internal"
- "grafana"
Por razones de seguridad, no se eliminan bases de datos.
Opciones del archivo de configuración
Cada parámetro en el archivo de configuración se puede especificar.
Formato de variable: influxdb__<block-name>__<parameter_in_snake_case>
Nombre | Descripción | Predeterminado |
---|---|---|
influxdb_config__meta__dir | "/var/lib/influxdb/meta" | |
influxdb_config__meta__retention_autocreate | "true" | |
influxdb_config__meta__logging_enabled | "true" | |
influxdb_config__meta__pprof_enabled | "false" | |
influxdb_config__meta__lease_duration | "1m0s" | |
influxdb_config__data__enabled | "true" | |
influxdb_config__data__dir | "/var/lib/influxdb/data" | |
influxdb_config__data__wal_dir | "/var/lib/influxdb/wal" | |
influxdb_config__data__wal_logging_enabled | "true" | |
influxdb_config__data__data_logging_enabled | "true" | |
influxdb_config__data__query_log_enabled | "true" | |
influxdb_config__data__cache_max_memory_size | 524288000 | |
influxdb_config__data__cache_snapshot_memory_size | 26214400 | |
influxdb_config__data__cache_snapshot_write_cold_duration | "1h" | |
influxdb_config__data__compact_min_file_count | 3 | |
influxdb_config__data__compact_full_write_cold_duration | "24h" | |
influxdb_config__data__max_points_per_block | 1000 | |
influxdb_config__cluster__shard_writer_timeout | "5s" | |
influxdb_config__cluster__write_timeout | "10s" | |
influxdb_config__cluster__max_concurrent_queries | 0 | |
influxdb_config__cluster__query_timeout | "0s" | |
influxdb_config__cluster__max_select_point | 0 | |
influxdb_config__cluster__max_select_series | 0 | |
influxdb_config__cluster__max_select_buckets | 0 | |
influxdb_config__retention__enabled | "true" | |
influxdb_config__retention__check_interval | "30s" | |
influxdb_config__shard_precreation__enabled | "true" | |
influxdb_config__shard_precreation__check_interval | "10m" | |
influxdb_config__shard_precreation__advance_period | "30m" | |
influxdb_config__monitor__store_enabled | "true" | |
influxdb_config__monitor__store_database | "_internal" | |
influxdb_config__monitor__store_interval | "10s" | |
influxdb_config__admin__enabled | "true" | |
influxdb_config__admin__bind_address | ":8083" | |
influxdb_config__admin__https_enabled | "false" | |
influxdb_config__admin__https_certificate | "/etc/ssl/influxdb.pem" | |
influxdb_config__http__enabled | "true" | |
influxdb_config__http__bind_address | ":8086" | |
influxdb_config__http__auth_enabled | "false" | |
influxdb_config__http__log_enabled | "true" | |
influxdb_config__http__write_tracing | "false" | |
influxdb_config__http__pprof_enabled | "false" | |
influxdb_config__http__https_enabled | "false" | |
influxdb_config__http__https_certificate | "/etc/ssl/influxdb.pem" | |
influxdb_config__http__max_row_limit | 10000 | |
influxdb_config__graphite__enabled | "false" | |
influxdb_config__graphite__bind_address | ":2003" | |
influxdb_config__graphite__database | "graphite" | |
influxdb_config__graphite__protocol | "tcp" | |
influxdb_config__graphite__batch_size | 5000 | |
influxdb_config__graphite__batch_pending | 10 | |
influxdb_config__graphite__batch_timeout | "1s" | |
influxdb_config__graphite__consistency_level | "one" | |
influxdb_config__graphite__separator | "." | |
influxdb_config__graphite__udp_read_buffer | 0 | |
influxdb_config__graphite__tags | [] | |
influxdb_config__graphite__templates | [] | |
influxdb_config__collectd__enabled | "false" | |
influxdb_config__collectd__bind_address | ":25826" | |
influxdb_config__collectd__database | "collectd" | |
influxdb_config__collectd__batch_size | 5000 | |
influxdb_config__collectd__batch_pending | 10 | |
influxdb_config__collectd__batch_timeout | "10s" | |
influxdb_config__collectd__read_buffer | 0 | |
influxdb_config__collectd__typesdb | "/usr/share/collectd/types.db" | |
influxdb_config__opentsdb__enabled | "false" | |
influxdb_config__opentsdb__bind_address | ":4242" | |
influxdb_config__opentsdb__database | "opentsdb" | |
influxdb_config__opentsdb__retention_policy | "" | |
influxdb_config__opentsdb__consistency_level | "one" | |
influxdb_config__opentsdb__tls_enabled | "false" | |
influxdb_config__opentsdb__certificate | "/etc/ssl/influxdb.pem" | |
influxdb_config__opentsdb__batch_size | 1000 | |
influxdb_config__opentsdb__batch_pending | 5 | |
influxdb_config__opentsdb__batch_timeout | "1s" | |
influxdb_config__opentsdb__log_point_errors | "true" | |
influxdb_config__udp__enabled | "false" | |
influxdb_config__udp__bind_address | ":8089" | |
influxdb_config__udp__database | "udp" | |
influxdb_config__udp__retention_policy | "" | |
influxdb_config__udp__batch_size | 5000 | |
influxdb_config__udp__batch_pending | 10 | |
influxdb_config__udp__batch_timeout | "1s" | |
influxdb_config__udp__read_buffer | 0 | |
influxdb_config__udp__udp_payload_size | 65536 | |
influxdb_config__continuous_queries__log_enabled | "true" | |
influxdb_config__continuous_queries__enabled | "true" | |
influxdb_config__continuous_queries__run_interval | "1s" |
Dependencias
Ninguna.
Ejemplo de Playbook
Incluir un ejemplo de cómo usar tu rol (por ejemplo, con variables pasadas como parámetros) es siempre útil para los usuarios:
- hosts: servers
roles:
- { role: juliendufresne.influxdb }
Licencia
MIT / BSD
Información del Autor
Este rol fue creado en 2016 por Julien Dufresne.
Fully configurable influxdb installation for Debian/Ubuntu Linux.
ansible-galaxy install juliendufresne.influxdb