William-Yeh.fluentd

Aperçu Versions Perspectives

williamyeh.fluentd pour Ansible Galaxy

Résumé

Nom du rôle dans Ansible Galaxy : williamyeh.fluentd

Ce rôle Ansible a les fonctionnalités suivantes pour Fluentd :

Installer td-agent : le paquet de distribution stable de Fluentd maintenu par Treasure Data, Inc.
Installer plusieurs plugins.
Configuration de base (la vraie configuration doit être laissée à l'utilisateur via des fichiers modèle ; voir la section Utilisation ci-dessous).

Variables du rôle

Variables obligatoires

Aucune.

Variables optionnelles

Valeurs par défaut configurables par l'utilisateur :

# version de td-agent ; par exemple, 2.3.4
# Installera la version par défaut (généralement la dernière stable) si non spécifiée.
tdagent_version

# un tableau de plugins (avec les dernières versions) à installer
tdagent_plugins

# un dictionnaire de plugins (avec des versions spécifiées) à installer
# champs du dictionnaire :
#   - clé : mémo pour ce plugin
#   - valeur :
#     - nom : nom du plugin
#     - version : version du plugin
tdagent_plugins_versions

Fichiers de configuration installables par l'utilisateur - configuration principale :

# fichier conf (généralement td-agent.conf) à installer,
# relatif à `playbook_dir` ;
# le fichier sera copié tel quel
tdagent_conf_copy

# fichier conf (généralement td-agent.conf.j2) à installer,
# relatif à `playbook_dir` ;
# le fichier sera copié via le système de modèles d'Ansible
tdagent_conf_template

Fichiers de configuration installables par l'utilisateur - autres configurations :

# autres modèles de configuration à installer dans "/etc/td-agent/conf.d" ;
# champs du dictionnaire :
#   - clé : mémo pour cette configuration
#   - valeur :
#     - src : fichier modèle relatif à `playbook_dir`
#     - dest : fichier cible relatif à `/etc/td-agent/conf.d/`
tdagent_conf_others

Gestionnaires

reload td-agent
restart td-agent
stop td-agent

Utilisation

Étape 1 : ajouter le rôle

Ajoutez le nom de rôle williamyeh.fluentd à votre fichier de playbook.

Étape 2 : ajouter des variables, si nécessaire

Définissez les variables dans votre fichier de playbook.

Exemple simple :

---
# fichier : simple-playbook.yml

- hosts: all

  roles:
    - williamyeh.fluentd

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

    tdagent_plugins_versions:
      prometheus:
        name: fluent-plugin-prometheus
        version: 0.1.2
      flowcounter:
        name: fluent-plugin-flowcounter
        version: 0.4.1

Étape 3 : copier le fichier de configuration de l'utilisateur, si nécessaire

Exemple plus pratique :

---
# fichier : complex-playbook.yml

- hosts: all

  roles:
    - williamyeh.fluentd

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

    # copier tel quel
    tdagent_conf_copy: "files/td-agent.conf"

    # copier via le système de modèles d'Ansible
    tdagent_conf_template: "templates/td-agent.conf.j2"

    # autres configurations à copier via le système de modèles d'Ansible
    tdagent_conf_others:
      prometheus_metrics:
        src:  templates/prometheus.conf.j2
        dest: prometheus.conf