logrotate
Ansible роль logrotate
Установите и настройте logrotate в вашей системе.
GitHub | GitLab | Загрузки | Версия |
---|---|---|---|
Пример Playbook
Этот пример взят из molecule/default/converge.yml
и тестируется при каждом пуше, запросе на слияние и релизе.
---
- name: Converge
hosts: all
become: true
gather_facts: true
vars:
logrotate_frequency: daily
logrotate_keep: 7
logrotate_compress: true
logrotate_entries:
- name: example
path: "/var/log/example/*.log"
- name: example-frequency
path: "/var/log/example-frequency/*.log"
frequency: weekly
- name: example-keep
path: "/var/log/example-keep/*.log"
keep: 14
- name: example-compress
path: "/var/log/example-compress/*.log"
compress: true
- name: example-copylog
path: "/var/log/example-copylog/*.log"
copylog: true
- name: example-copytruncate
path: "/var/log/example-copytruncate/*.log"
copytruncate: true
- name: example-delaycompress
path: "/var/log/example-delaycompress/*.log"
delaycompress: true
- name: example-script
path: "/var/log/example-script/*.log"
postrotate: killall -HUP some_process_name
- name: btmp
path: /var/log/btmp
missingok: true
frequency: monthly
create: true
create_mode: "0660"
create_user: root
create_group: utmp
dateext: true
dateformat: "-%Y-%m-%d"
keep: 1
- name: wtmp
path: /var/log/wtmp
missingok: true
frequency: monthly
create: true
create_mode: "0664"
create_user: root
create_group: utmp
minsize: 1M
maxsize: 128M
dateext: true
dateformat: "-%Y%m%d"
keep: 1
- name: dnf
path: /var/log/hawkey.log
missingok: true
notifempty: true
keep: 4
frequency: weekly
create: true
- name: example-sharedscripts
path: "/var/log/example-sharedscripts/*.log"
sharedscripts: true
- name: example-dateyesterday
state: present
path: "/var/log/example-dateyesterday/*.log"
dateyesterday: true
- name: example-absent
state: absent
# Отрицательные числа работают на некоторых дистрибутивах: `error: example-negative:10 bad rotation count '-1'\`
# - name: example-negative
# path: "/var/log/example-keep-negative/*.log"
# keep: -1
roles:
- role: robertdebock.logrotate
Машину необходимо подготовить. В CI это делается с помощью molecule/default/prepare.yml
:
---
- name: Prepare
hosts: all
become: true
gather_facts: false
roles:
- role: robertdebock.bootstrap
- role: robertdebock.cron
post_tasks:
- name: Создать каталог для логов
ansible.builtin.file:
path: "{{ item }}"
state: directory
mode: "0755"
loop:
- /var/log/example
- /var/log/example-frequency
- /var/log/example-keep
- /var/log/example-compress
- /var/log/example-copylog
- /var/log/example-copytruncate
- /var/log/example-delaycompress
- /var/log/example-script
- /var/log/example-sharedscripts
- /var/log/example-dateyesterday
- name: Создать файл журнала
ansible.builtin.copy:
dest: "{{ item }}"
content: "example"
mode: "0644"
loop:
- /var/log/example/app.log
- /var/log/example-frequency/app.log
- /var/log/example-keep/app.log
- /var/log/example-compress/app.log
- /var/log/example-copylog/app.log
- /var/log/example-copytruncate/app.log
- /var/log/example-delaycompress/app.log
- /var/log/example-script/app.log
- /var/log/example-sharedscripts/app.log
- /var/log/example-dateyesterday/app.log
- /var/log/btmp
- /var/log/wtmp
- /var/log/hawkey.log
Также смотрите полное объяснение и пример о том, как использовать эти роли.
Переменные роли
Значения по умолчанию для переменных заданы в defaults/main.yml
:
---
# файл по умолчанию для logrotate
# Как часто нужно вращать логи: ежедневно, еженедельно или ежемесячно.
logrotate_frequency: weekly
# Сколько файлов нужно хранить.
logrotate_keep: 4
# Должны ли сжатые логи быть сжаты?
logrotate_compress: true
# Использовать расширение даты в именах файлов журналов
logrotate_dateext: false
# Пользователь/Группа для сжатых файлов журналов (загружается в зависимости от ОС, если найдена, или задается вручную)
logrotate_user: "{{ _logrotate_user[ansible_distribution] | default(_logrotate_user['default']) }}"
logrotate_group: "{{ _logrotate_group[ansible_distribution] | default(_logrotate_group['default']) }}"
# Задать состояние сервиса
logrotate_service_state: "started"
logrotate_service_enabled: true
Требования
- Пакеты pip, указанные в requirements.txt.
Состояние используемых ролей
Следующие роли используются для подготовки системы. Вы можете подготовить свою систему другим способом.
Требование | GitHub | GitLab |
---|---|---|
robertdebock.bootstrap | ||
robertdebock.cron |
Контекст
Эта роль является частью многих совместимых ролей. Ознакомьтесь с документацией этих ролей для получения дополнительной информации.
Вот обзор связанных ролей:
Совместимость
Эта роль была протестирована на этих образах контейнеров:
контейнер | теги |
---|---|
Alpine | все |
Amazon | Кандидат |
EL | 9 |
Debian | все |
Fedora | все |
Ubuntu | все |
Минимальная версия Ansible, необходимая для работы, — 2.12. Тестирование было проведено для:
- Предыдущей версии.
- Текущей версии.
- Версии разработки.
Если вы обнаружите проблемы, пожалуйста, зарегистрируйте их в GitHub.
Лицензия
Информация об авторе
Пожалуйста, подумайте о финансировании меня.
ansible-galaxy install robertdebock/ansible-role-logrotate