stakater/logrotate

Docker化Logrotate

镜像概述

Dockerized Logrotate是一个容器化的日志轮转工具，基于Logrotate实现，用于自动管理和轮转日志文件。通过Docker容器部署，可便捷集成到各类环境中，解决日志文件过大、占用存储空间等问题，确保日志管理自动化和规范化。

核心功能与特性

• 自定义配置支持：允许挂载外部Logrotate配置文件，灵活定义日志轮转规则（如轮转频率、保留数量、压缩方式等）
• 定时执行机制：默认每天UTC 00:00执行日志轮转，可通过环境变量自定义执行时间
• 容器化部署：轻量级容器，易于集成到Docker或Kubernetes环境，无需在主机直接安装Logrotate

使用场景

• 容器化应用日志管理：对Docker容器输出的日志文件进行自动轮转
• 主机日志集中管理：通过挂载主机日志目录，统一管理系统或应用日志
• 开发/测试环境日志清理：自动清理临时日志，避免存储空间耗尽

使用方法与配置说明

基本运行要求

• 需将Logrotate配置文件挂载到容器内的/etc/logrotate.d目录
• 若需自定义执行时间，通过CRON_SCHEDULE环境变量设置cron表达式

部署示例

Docker Run命令

bash
docker run -d \
  -v $(pwd)/config/:/etc/logrotate.d/ \  # 挂载本地配置目录到容器内配置目录
  -e CRON_SCHEDULE="0 1 * * *" \        # 可选：自定义执行时间（示例为每天UTC 01:00）
  stakater/logrotate

配置文件说明

Logrotate配置文件需放置在本地$(pwd)/config/目录下，遵循Logrotate配置语法。示例配置（如app-log.conf）：

/path/to/logs/*.log {
  daily
  rotate 7
  compress
  delaycompress
  missingok
  notifempty
}

• daily：每天轮转
• rotate 7：保留7个日志文件
• compress：压缩轮转后的日志
• missingok：日志文件不存在时不报错

环境变量说明

参考资料

• Logrotate配置文件编写指南：[***]