cloudalchemy.fluentd

Descripción general Versiones Perspectivas

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

# Rol de Ansible: fluentd

[![Estado de la construcción](https://travis-ci.org/cloudalchemy/ansible-fluentd.svg?branch=master)](https://travis-ci.org/cloudalchemy/ansible-fluentd)
[![Licencia: MIT](https://img.shields.io/badge/license-MIT%20License-brightgreen.svg)](https://opensource.org/licenses/MIT)
[![Rol de Ansible](http://img.shields.io/badge/ansible%20role-cloudalchemy.fluentd-blue.svg)](https://galaxy.ansible.com/cloudalchemy/fluentd/)
[![Etiqueta de 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)

## ¡Importante!

Ya no estamos apoyando este rol, lo que significa que no aceptaremos PRs ni nuevos problemas. No eliminaremos este repositorio, pero te animamos a que cambies a alternativas como [idealista/fluentd-role](https://github.com/idealista/fluentd-role).

## Descripción

Instala y gestiona el reenvío y la agregación de logs de [fluentd](https://github.com/fluent/fluentd).

## Requisitos

- Ansible >= 2.7 (Podría funcionar en versiones anteriores, pero no lo garantizamos).

## Variables del rol

Todas las variables que se pueden sobrescribir están almacenadas en el archivo [defaults/main.yml](defaults/main.yml) y también en la tabla a continuación.

| Nombre                | Valor por defecto | Descripción                                                                   |
| --------------------- | ---------------- | ----------------------------------------------------------------------------- |
| `fluentd_custom_conf` | []               | Rutas a plantillas de configuración personalizadas. [Ejemplos de configuración](https://github.com/fluent/fluentd/tree/master/example). |
| `fluentd_plugins`     | []               | Lista de plugins adicionales                                                   |

## Ejemplo

### Playbook

Úsalo en un playbook de la siguiente manera:
```yaml
- hosts: all
  become: true
  roles:
    - cloudalchemy.fluentd

Sitio de demostración

Proporcionamos un sitio de demostración para una solución de monitoreo completa basada en prometheus y grafana. El repositorio con el código y enlaces a instancias en funcionamiento está disponible en GitHub y el sitio está alojado en DigitalOcean.

Pruebas locales

La forma preferida de probar el rol localmente es usar Docker y molecule (v2.x). Tendrás que instalar Docker en tu sistema. Consulta "Comenzar" para obtener un paquete de Docker adecuado para tu sistema. Usamos tox para simplificar el proceso de pruebas en múltiples versiones de Ansible. Para instalar tox ejecuta:

pip3 install tox

Para ejecutar pruebas en todas las versiones de Ansible (ADVERTENCIA: esto puede llevar tiempo):

tox

Para ejecutar un comando de molecula personalizado en un entorno personalizado solo con el escenario de prueba predeterminado:

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

Para más información sobre molecule, visita su documentación.

Si deseas ejecutar pruebas en un host de Docker remoto, solo especifica la variable DOCKER_HOST antes de ejecutar las pruebas de tox.

Travis CI

Combinar molecule y travis CI nos permite probar cómo se comportarán las nuevas PRs cuando se usen con múltiples versiones de Ansible y múltiples sistemas operativos. Esto también nos permite crear escenarios de prueba para diferentes configuraciones de rol. Como resultado, tenemos una matriz de pruebas bastante grande que llevará más tiempo que las pruebas locales, así que, por favor, ten paciencia.