Giter VIP home page Giter VIP logo

ansible-role-rsyslog's Introduction

#######################################################################################################

❗ DEPRECATION ❗

This repository and the role associated are deprecated in favor of the Manala Ansible Collection

You will find informations on its usage on the collection repository

#######################################################################################################

Ansible Role: Rsyslog Build Status

Report issues and send Pull Requests in the main Ansible Role repository

This role will deal with the setup of Rsyslog.

It's part of the Manala Ansible stack but can be used as a stand alone component.

Requirements

None.

Dependencies

None.

Installation

Ansible 2+

Using ansible galaxy cli:

ansible-galaxy install manala.rsyslog

Using ansible galaxy requirements file:

- src: manala.rsyslog

Role Handlers

Name Type Description
rsyslog restart Service Restart rsyslog service

Role Variables

Name Default Type Description
manala_rsyslog_install_packages ~ Array Dependency packages to install
manala_rsyslog_install_packages_default ['rsyslog'] Array Default dependency packages to install
manala_rsyslog_config_template 'config/_default.j2' String Configuration base template path
manala_rsyslog_config ~ Array/String Configuration directives
manala_rsyslog_configs_exclusive false Array Additional configurations exclusivity
manala_rsyslog_configs_dir '/etc/rsyslog.d' String Additional configurations directory path
manala_rsyslog_configs_defaults {} Array Additional configurations defaults
manala_rsyslog_configs [] Array Additional configurations directives

Configuration example

Content based

manala_rsyslog_config: |
  $FileOwner root
  $FileGroup adm
  $FileCreateMode 0640
  $DirCreateMode 0755
  $Umask 0022

Template based

manala_rsyslog_config_template: my/rsyslog.conf.j2

Dict's array parameters based (deprecated):

manala_rsyslog_config_template: config/default.prod.j2
manala_rsyslog_config:
  - $ModLoad imklog: false
  - $ModLoad immark: true
  - |
    *.=info;*.=notice;*.=warn;\
        auth,authpriv.none;\
        cron,daemon.none;\
        mail,news.none    -/var/log/messages

Configs

manala_rsyslog_configs allows you to define rsyslog configuration files using template and config, or raw content.

A state (present|absent|ignore) can be provided.

manala_rsyslog_configs:
  # Config based
  - file: config.conf
    config:
      foo.*: -/var/log/foo.log
      bar.*: -/var/log/bar.log
  # Content based
  - file: content.conf
    config: |
      foo.* -/var/log/foo.log
      bar.* -/var/log/bar.log
  # Template based (file name based on template)
  - template: rsyslog/bar.conf.j2
    config:
      foo: bar
  # Template based (force file name)
  - file: baz.conf
    template: rsyslog/bar.conf.j2
    config:
      foo: bar
  # Dicts array template based (deprecated)
  - file: foo.conf
    template: configs/rules.prod.j2
    config:
      - auth,authpriv.*           /var/log/auth.log
      - '*.*;auth,authpriv.none   -/var/log/syslog'
      - daemon.*                  -/var/log/daemon.log
      - kern.*                    -/var/log/kern.log
      - mail.*                    -/var/log/mail.log
      - user.*                    -/var/log/user.log
  # Ensure config is absent
  - file: absent.conf
    state: absent # "present" by default
  # Ignore config
  - file: ignore.conf
    state: ignore
  # Flatten configs
  - "{{ my_custom_configs_array }}"

manala_rsyslog_configs_exclusive allow you to clean up existing rsyslog configuration files into directory defined by the manala_rsyslog_configs_dir key. Made to be sure no old or manually created files will alter current configuration.

manala_rsyslog_configs_exclusive: true

Example playbook

- hosts: all
  roles:
    - role: manala.rsyslog

Licence

MIT

Author information

Manala (http://www.manala.io/)

ansible-role-rsyslog's People

Contributors

greedybro avatar nervo avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.