You've already forked ansible-role-rsyslog
87 lines
2.3 KiB
Markdown
87 lines
2.3 KiB
Markdown
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.
|