initial import

README.md

@@ -0,0 +1,74 @@
+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.