Files
ansible-role-rsyslog/README.md

75 lines
2.3 KiB
Markdown
Raw Normal View History

2015-04-20 01:46:12 +02:00
ansible-rsyslog
=========
This role installs and configures rsyslog.
Requirements
------------
None at this time.
Default Role Variables
--------------
By default this role will provide a minimal configuration
*rsyslog_main_config*: Main config file path (default: "/etc/rsyslog.conf")
*rsyslog_include_path*: Path of additional config stanzas (default: "/etc/rsyslog.d")
*rsyslog_file_mode*: Default mode for configuration files (default: "0640")
*rsyslog_file_create_mode*: Default mode for new files created by rsyslog (default "0640")
*rsyslog_umask*: Specify the rsyslogd processes' umask (default "0022")
*rsyslog_abort_on_unclean_config*: Check config syntax on startup and abort if unclean (default: off)
*rsyslog_repeated_msg_reduction*: Reduce repeating messages (default: off)
*rsyslog_action_file_default_template*: Use the default, traditional logformat, as default for loggin (default: RSYSLOG_TraditionalFileFormat)
*rsyslog_action_file_template*: Define only when a custom logformat is neeed (default: undefined)
*rsyslog_priv_drop_to_user*: Name of the user rsyslog should run under after startup (default: undefined)
*rsyslog_priv_drop_to_group*: Name of the group rsyslog should run under after startup (default: undefined)
*rsyslog_default_config*: Setup a default basic configuration stanza (default: "True")
Dependencies
------------
None at this time.
Example Playbook
----------------
- name: Apply rsyslog role
remote_user: root
hosts: all
sudo: no
- role: rsyslog
items:
- name: "20-iptables"
lines:
- ':msg, contains, "iptables" /var/log/iptables.log'
- '& ~'
- name: "30-dovecot"
lines:
- 'if $programname == 'dovecot' and $syslogseverity <= '6' then ~'
- '& ~'
Supported Platforms
-------------------
* RHEL 6
* Archlinux
* Ubuntu Trusty
* Debian Wheezy
It will likely run on other platforms, just drop in vars/ a new file to support your os variant, vars are parsed in the following order/format:
* {{ ansible_distribution }}_{{ ansible_distribution_major_version }}.yml
* {{ ansible_distribution }}.yml
* {{ ansible_os_family }}_{{ ansible_distribution_major_version }}.yml
* {{ ansible_os_family }}.yml"
License
-------
GPLv2
Author Information
------------------
Alessio Cassibba (x-drum) http://blog.zerodev.it.