cloudalchemy.fluentd

Aperçu Versions Perspectives

<a href="https://www.fluentd.org">
    <img src="https://www.fluentd.org/assets/img/miscellany/fluentd-logo.png" alt="logo fluentd" title="fluentd" align="right" height="60" />
</a>

# Rôle Ansible : fluentd

[![État de build](https://travis-ci.org/cloudalchemy/ansible-fluentd.svg?branch=master)](https://travis-ci.org/cloudalchemy/ansible-fluentd)
[![Licence : MIT](https://img.shields.io/badge/license-MIT%20License-brightgreen.svg)](https://opensource.org/licenses/MIT)
[![Rôle Ansible](http://img.shields.io/badge/ansible%20role-cloudalchemy.fluentd-blue.svg)](https://galaxy.ansible.com/cloudalchemy/fluentd/)
[![Tag GitHub](https://img.shields.io/github/tag/cloudalchemy/ansible-fluentd.svg)](https://github.com/cloudalchemy/ansible-fluentd/tags)
[![IRC](https://img.shields.io/badge/irc.freenode.net-%23cloudalchemy-yellow.svg)](https://kiwiirc.com/nextclient/#ircs://irc.freenode.net/#cloudalchemy)

## Important !

Nous ne supportons plus ce rôle, ce qui signifie que nous n'accepterons plus les demandes de tirage ni les nouveaux problèmes. Nous ne supprimerons pas ce dépôt, mais nous vous encourageons vivement à passer à des alternatives telles que [idealista/fluentd-role](https://github.com/idealista/fluentd-role)

## Description

Installez et gérez le collecteur et agrégateur de logs [fluentd](https://github.com/fluent/fluentd).

## Exigences

- Ansible >= 2.7 (Cela peut fonctionner sur des versions précédentes, mais nous ne pouvons pas le garantir)

## Variables de rôle

Toutes les variables qui peuvent être remplacées sont stockées dans le fichier [defaults/main.yml](defaults/main.yml) ainsi que dans le tableau ci-dessous.

| Nom                  | Valeur par défaut | Description                        |
| -------------------- | ----------------- | ---------------------------------- |
| `fluentd_custom_conf` | []                | Chemins vers des modèles de configuration personnalisés. [Exemples de configuration](https://github.com/fluent/fluentd/tree/master/example). |
| `fluentd_plugins`    | []                | Liste des plugins supplémentaires   |

## Exemple

### Playbook

Utilisez-le dans un playbook comme suit :
```yaml
- hosts: all
  become: true
  roles:
    - cloudalchemy.fluentd

Site de démonstration

Nous fournissons un site de démonstration pour une solution de surveillance complète basée sur prometheus et grafana. Le dépôt avec le code et les liens vers des instances en cours d'exécution est disponible sur github et le site est hébergé sur DigitalOcean.

Tests locaux

La méthode préférée pour tester le rôle localement est d'utiliser Docker et molecule (v2.x). Vous devez installer Docker sur votre système. Consultez "Commencer" pour un paquet Docker adapté à votre système. Nous utilisons tox pour simplifier le processus de test sur plusieurs versions d'ansible. Pour installer tox, exécutez :

pip3 install tox

Pour exécuter des tests sur toutes les versions d'ansible (AVERTISSEMENT : cela peut prendre un certain temps)

tox

Pour exécuter une commande molecule personnalisée sur un environnement personnalisé avec seulement le scénario de test par défaut :

tox -e py35-ansible28 -- molecule test -s default

Pour plus d'informations sur molecule, consultez leur documentation.

Si vous souhaitez exécuter des tests sur un hôte Docker distant, spécifiez simplement la variable DOCKER_HOST avant d'exécuter les tests tox.

Travis CI

Combiner molecule et travis CI nous permet de tester comment de nouvelles demandes de tirage se comporteront lorsqu'elles sont utilisées avec plusieurs versions d'ansible et plusieurs systèmes d'exploitation. Cela nous permet également de créer des scénarios de test pour différentes configurations de rôle. En conséquence, nous avons une matrice de tests assez grande qui prendra plus de temps que les tests locaux, alors soyez patient.