linkyard/logrotate

logrotate

这是一个基于Alpine Linux的Docker容器，集成了logrotate工具，用于管理和轮转日志文件。

配置说明

只需将包含日志的目录挂载到容器的/logs路径，并可通过以下环境变量配置日志轮转特性：

• LOGROTATE_FILE_PATTERN（默认值：*.log）：/logs目录下需要被logrotate轮转的日志文件模式
• LOGROTATE_TRUNCATE（默认值：copytruncate）：日志轮转的截断行为，可设为copytruncate（复制后截断）或nocopytruncate（不复制直接截断）
• LOGROTATE_COMPRESS（默认值：nocompress）：轮转文件的压缩行为，可设为nocompress（不压缩）或compress（压缩）
• LOGROTATE_ROTATE（默认值：5）：logrotate的rotate选项，指定保留的轮转文件数量
• LOGROTATE_SIZE（默认值：50M）：logrotate的size选项，指定触发轮转的日志文件大小

若需使用自定义logrotate配置，可将logrotate.conf文件挂载到容器的/etc/logrotate.conf路径。此时上述环境变量将不再生效。

默认情况下，logrotate每15分钟运行一次。可通过环境变量LOGROTATE_CRON覆盖cron调度。可使用Alpine Linux预定义的周期（15min、hourly、daily、weekly或monthly），或指定cron表达式，如5 4 * * *（每天04:05运行）。不确定cron表达式语法时，可参考工具如crontab guru。

使用示例

bash
docker run \
  -v /path/to/my/logs:/logs \
  -e LOGROTATE_FILE_PATTERN="*.log" \
  # 不保留轮转文件，仅在日志超过配置大小时截断
  -e LOGROTATE_ROTATE="0" \
  # 每5分钟运行一次logrotate
  -e LOGROTATE_CRON="*/5 * * * *" \
  linkyard:logrotate

说明

本镜像与已停止维护的https://github.com/blacklabelops/logrotate类似，但使用和维护更为简单。

使用方法

该镜像双重发布（GitHub和私有GCR仓库）。

bash
docker run ***-ghcr.xuanyuan.run/linkyard/logrotate

或

bash
docker run ***-gcr.xuanyuan.run/linkyard-***/linkyard-cloud/logrotate