William-Yeh.fluentd

Przegląd Wersje Wgląd

williamyeh.fluentd dla Ansible Galaxy

Podsumowanie

Nazwa roli w Ansible Galaxy: williamyeh.fluentd

Ta rola Ansible ma następujące funkcje dla Fluentd:

Instalacja td-agent: stabilna paczka dystrybucyjna Fluentd, zarządzana przez Treasure Data, Inc.
Instalacja kilku wtyczek.
Podstawowa konfiguracja (prawdziwa konfiguracja powinna być pozostawiona plikom szablonów użytkownika; patrz sekcja Użycie poniżej).

Zmienne roli

Zmienne obowiązkowe

Brak.

Zmienne opcjonalne

Użytkownik może skonfigurować domyślne wartości:

# wersja td-agent; np. 2.3.4
# Zainstaluje domyślną (zwykle najnowszą stabilną) wersję, jeśli nie podano.
tdagent_version

# tablica wtyczek (z najnowszymi wersjami) do zainstalowania
tdagent_plugins

# słownik wtyczek (z określonymi wersjami) do zainstalowania
# pola słownika:
#   - klucz: notatka dla tej wtyczki
#   - wartość:
#     - nazwa:    nazwa wtyczki
#     - wersja: wersja wtyczki
tdagent_plugins_versions

Konfigurowalne pliki instalacyjne użytkownika - główna konfiguracja:

# plik konfiguracyjny (zwykle td-agent.conf) do zainstalowania,
# w odniesieniu do `playbook_dir`;
# plik zostanie skopiowany w dokładnej formie
tdagent_conf_copy

# plik konfiguracyjny (zwykle td-agent.conf.j2) do zainstalowania,
# w odniesieniu do `playbook_dir`;
# plik zostanie skopiowany przez system szablonów Ansible
tdagent_conf_template

Konfigurowalne pliki instalacyjne użytkownika - inne konfiguracje:

# inne szablony konfiguracyjne do zainstalowania w "/etc/td-agent/conf.d";
# pola słownika:
#   - klucz: notatka dla tej konfiguracji
#   - wartość:
#     - src:  plik szablonu w odniesieniu do `playbook_dir`
#     - dest: docelowy plik w odniesieniu do `/etc/td-agent/conf.d/`
tdagent_conf_others

Obsługuje

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

Użycie

Krok 1: dodaj rolę

Dodaj nazwę roli williamyeh.fluentd do swojego pliku playbook.

Krok 2: dodaj zmienne, jeśli potrzebne

Ustaw zmienne w swoim pliku playbook.

Prosty przykład:

---
# plik: 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

Krok 3: skopiuj plik konfiguracyjny użytkownika, jeśli to konieczne

Bardziej praktyczny przykład:

---
# plik: complex-playbook.yml

- hosts: all

  roles:
    - williamyeh.fluentd

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

    # skopiuj bez zmian
    tdagent_conf_copy: "files/td-agent.conf"

    # skopiuj przez system szablonów Ansible
    tdagent_conf_template: "templates/td-agent.conf.j2"

    # inne konfiguracje do skopiowania przez system szablonów Ansible
    tdagent_conf_others:
      prometheus_metrics:
        src:  templates/prometheus.conf.j2
        dest: prometheus.conf