logrotate

gabops.logrotate

Installs and configures logrotate.

Requirements

None.

Role Variables

Variable	Default value	Description
logrotate_packages	[]	Defines the list of packages to be installed in order to install logrotate. Note that this role handles the packages to install already, however, this variable exists for allowing you to declare your own list of packages if required.
logrotate_enable_repo	""	Defines the repo to be enabled when installing the packages defined in `logrotate_packages` variable. Note that this option only works in RedHat family distributions.
logrotate_config_global	[]	Defines the configuration to be applied on `/etc/logrotate.conf` note that if this variable is empty as it is by default, the file `logtorate.conf` will not be modified at all.
logrotate_config_files	[]	Defines the individual logrotate configurations to be applied. See `Notes` and `Example playbook` for more information.

Notes:

All configurations defined in logrotate_config_files will be applied over the default directory /etc/logrotate.d. This behaviour can be changed if in the variable logrotate_config_global you declare the include directive. So, for example, if you define:

logrotate_config_global:
  - include
  - weekly
  - rotate 4
  - create
  - dateext
  - include /etc/customdir

The role will detect automatically the path on the include directive and will use that instead of the default /etc/logrotate.d.

All configurations defined in logrotate_config_files will be added to individual files using the value defined in name as filename.
The parameters every definition in logrotate_config_files requires are:

logrotate_config_files:
  - name: ""        # => Mandatory.
    state: ""       # => Optional: possible values are present or absent. If not declared it will be pesent by default.
    path: ""        # => Mandatory (This can be string or list!).
    directives: ""  # => Mandatory.

Dependencies

None.

Example Playbook

    - hosts: servers
      vars:
        logrotate_config_global:
          - weekly
          - rotate 4
          - create
          - dateext
          - include /etc/logrotate.d

        logrotate_config_files:
          - name: messages
            state: absent
            path: /var/log/messages
            directives: |
              rotate 5
              weekly
              postrotate
                /usr/bin/killall -HUP syslogd
              endscript

          - name: httpd
            path:
              - /var/log/httpd/access.log
              - /var/log/httpd/error.log
            directives: |
              rotate 5
              mail [email protected]
              size 100k
              sharedscripts
              postrotate
                /usr/bin/killall -HUP httpd
              endscript

      roles:
         - role: gabops.logrotate