Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/arillso/ansible.logrotate

Installs and configures logrotate
https://github.com/arillso/ansible.logrotate

ansible ansible-role hacktoberfest logratate

Last synced: about 2 months ago
JSON representation

Installs and configures logrotate

Host: GitHub
URL: https://github.com/arillso/ansible.logrotate
Owner: arillso
License: mit
Created: 2017-10-05T22:23:43.000Z (about 7 years ago)
Default Branch: master
Last Pushed: 2023-08-17T18:32:10.000Z (over 1 year ago)
Last Synced: 2024-05-08T00:23:26.084Z (8 months ago)
Topics: ansible, ansible-role, hacktoberfest, logratate
Language: HTML
Homepage:
Size: 79.1 KB
Stars: 28
Watchers: 6
Forks: 46
Open Issues: 11
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE

Awesome Lists containing this project

README

# Ansible Role: logrotate

[![Build Status](https://img.shields.io/travis/arillso/ansible.logrotate.svg?branch=master&style=popout-square)](https://travis-ci.org/arillso/ansible.logrotate) [![license](https://img.shields.io/github/license/mashape/apistatus.svg?style=popout-square)](https://sbaerlo.ch/licence) [![Ansible Galaxy](https://img.shields.io/badge/ansible--galaxy-logrotate-blue.svg?style=popout-square)](https://galaxy.ansible.com/arillso/logrotate) [![Ansible Role](https://img.shields.io/ansible/role/d/23110.svg?style=popout-square)](https://galaxy.ansible.com/arillso/logrotate)

## Description

Installs and configures logrotate.

## Installation

```bash
ansible-galaxy install arillso.logrotate
```

## Requirements

None.

## Role Variables

### include files

Path to the include files.

```yml
logrotate_include_dir: /etc/logrotate.d
```

### logrotate_global_config

Enable/disable global configuration of `/etc/logrotate.conf`.

```yml
logrotate_global_config: true
```

### logrotate_use_hourly_rotation

Enable/disable hourly rotation with cron.

```yml
logrotate_use_hourly_rotation: false
```

### logrotate options

List of global options.

```yml
logrotate_options:
- weekly
- rotate 4
- create
- dateext
- su root syslog
```

### Package

Package name to install `logrotate`.

```yml
logrotate_package: logrotate
```

### default config

Logrotate for `wtmp`:

```yml
logrotate_wtmp_enable: true
logrotate_wtmp:
logs:
- /var/log/wtmp
options:
- missingok
- monthly
- create 0664 root utmp
- rotate 1
```

Logrotate for `btmp`:

```yml
logrotate_btmp_enable: true
logrotate_btmp:
logs:
- /var/log/btmp
options:
- missingok
- monthly
- create 0660 root utmp
- rotate 1
```

### Applications config

More log files can be added that will logorate.

```yml
logrotate_applications: []
```

#### Example

The following options are available.

```yml
logrotate_applications:
- name: name-your-log-rotate-application
definitions:
- logs:
- /var/log/apt/term.log
- /var/log/apt/history.log
options:
- su user group
- rotate 12
- monthly
- missingok
- notifempty
postrotate:
- /path/to/some/script
```

## Dependencies

None

## Example Playbook

```yml
- hosts: all
roles:
- arillso.logrotate
```

## Author

- [Simon Bärlocher](https://sbaerlocher.ch)

## License

This project is under the MIT License. See the [LICENSE](https://sbaerlo.ch/licence) file for the full license text.