William-Yeh.fluentd

Descripción general Versiones Perspectivas

williamyeh.fluentd para Ansible Galaxy

Resumen

Nombre del rol en Ansible Galaxy: williamyeh.fluentd

Este rol de Ansible tiene las siguientes características para Fluentd:

Instalar td-agent: el paquete de distribución estable de Fluentd mantenido por Treasure Data, Inc.
Instalar varios plugins.
Configuración básica (*la configuración real debe dejarse a los archivos de plantilla del usuario; vea la sección Uso a continuación).

Variables del Rol

Variables obligatorias

Ninguna.

Variables opcionales

Definiciones configurables por el usuario:

# versión de td-agent; por ejemplo, 2.3.4
# Se instalará la versión predeterminada (generalmente la última estable) si no se especifica.
tdagent_version

# un array de plugins (con las últimas versiones) a instalar
tdagent_plugins

# un diccionario de plugins (con versiones específicas) a instalar
# campos del diccionario:
#   - clave: nota para este plugin
#   - valor:
#     - nombre:    nombre del plugin
#     - versión: versión del plugin
tdagent_plugins_versions

Archivos de configuración instalables por el usuario - configuración principal:

# archivo de conf (usualmente td-agent.conf) a instalar,
# relativo a `playbook_dir`;
# el archivo se copiará tal cual
tdagent_conf_copy

# archivo de conf (usualmente td-agent.conf.j2) a instalar,
# relativo a `playbook_dir`;
# el archivo se copiará a través del sistema de plantillas de Ansible
tdagent_conf_template

Archivos de configuración instalables por el usuario - otras configuraciones:

# otras plantillas de conf a instalar en "/etc/td-agent/conf.d";
# campos del diccionario:
#   - clave: nota para esta configuración
#   - valor:
#     - src:  archivo de plantilla relativo a `playbook_dir`
#     - dest: archivo objetivo relativo a `/etc/td-agent/conf.d/`
tdagent_conf_others

Manejadores

recargar td-agent
reiniciar td-agent
detener td-agent

Uso

Paso 1: agregar rol

Agrega el nombre del rol williamyeh.fluentd a tu archivo de playbook.

Paso 2: agregar variables, si las hay

Establecer vars en tu archivo de playbook.

Ejemplo simple:

---
# archivo: simple-playbook.yml

- hosts: all

  roles:
    - williamyeh.fluentd

  vars:
    tdagent_plugins:
      - fluent-plugin-multiprocess
      - fluent-plugin-forest
      - fluent-plugin-elasticsearch

    tdagent_plugins_versions:
      prometheus:
        nombre: fluent-plugin-prometheus
        versión: 0.1.2
      flowcounter:
        nombre: fluent-plugin-flowcounter
        versión: 0.4.1

Paso 3: copiar el archivo de configuración del usuario, si es necesario

Ejemplo más práctico:

---
# archivo: complex-playbook.yml

- hosts: all

  roles:
    - williamyeh.fluentd

  vars:
    tdagent_plugins:
      - fluent-plugin-multiprocess
      - fluent-plugin-flowcounter
      - fluent-plugin-elasticsearch

    # copia tal cual
    tdagent_conf_copy: "files/td-agent.conf"

    # copia a través del sistema de plantillas de Ansible
    tdagent_conf_template: "templates/td-agent.conf.j2"

    # otras configuraciones a copiar a través del sistema de plantillas de Ansible
    tdagent_conf_others:
      prometheus_metrics:
        src:  templates/prometheus.conf.j2
        dest: prometheus.conf