craftercms/logrotate

CrafterCMS LogRotate Docker镜像

概述

CrafterCMS LogRotate Docker镜像是专为CrafterCMS应用设计的日志轮转工具镜像，用于自动化管理CrafterCMS应用生成的日志文件。通过日志轮转、压缩和清理策略，确保日志文件大小可控，避免磁盘空间被过度占用，保障系统稳定运行。

核心功能与特性

• 自动化日志轮转：根据预设条件（如文件大小、时间间隔）自动触发日志文件轮转，防止单个日志文件过大
• 日志压缩存储：对轮转后的历史日志文件进行压缩处理，显著节省磁盘存储空间
• 过期日志清理：支持配置日志保留期限，自动删除超过期限的日志文件，避免无效日志堆积
• CrafterCMS适配：针对CrafterCMS应用的日志路径和格式进行优化，确保日志轮转流程与应用无缝集成

使用场景与适用范围

适用于所有基于Docker部署的CrafterCMS环境，包括：

• 生产环境：长期运行的CrafterCMS实例，需稳定管理大量业务日志
• 测试环境：频繁生成测试日志的开发测试场景
• 企业部署：需要符合日志管理规范的企业级应用部署

尤其适合对磁盘空间敏感、需要自动化日志维护的场景，减轻运维人员手动管理日志的工作量。

使用方法与配置说明

基本部署命令

通过Docker命令直接运行镜像，需挂载CrafterCMS日志目录和LogRotate配置文件：

bash
docker run -d \
  --name craftercms-logrotate \
  -v /host/path/to/craftercms/logs:/var/log/craftercms \  # 挂载CrafterCMS日志目录（宿主机路径:容器内路径）
  -v /host/path/to/logrotate.conf:/etc/logrotate.d/craftercms \  # 挂载自定义LogRotate配置文件
  craftercms/logrotate:latest

配置文件说明

LogRotate的轮转策略通过配置文件定义，典型配置示例（logrotate.conf）：

conf
/var/log/craftercms/*.log {
  daily          # 轮转频率：每日轮转
  size 50M       # 触发条件：当日志文件达到50MB时强制轮转
  rotate 14      # 保留14个历史日志文件
  compress       # 对轮转后的日志进行gzip压缩
  delaycompress  # 延迟压缩（保留最新轮转日志未压缩，便于紧急查看）
  missingok      # 日志文件不存在时不报错
  notifempty     # 日志文件为空时不执行轮转
  create 0644 crafter crafter  # 创建新日志文件时设置权限和属主
}

关键配置参数说明

注意事项

• SNAPSHOT镜像限制：标记为SNAPSHOT的镜像版本仅提供给CrafterCMS企业版用户，社区版用户请使用正式发布版本（非SNAPSHOT标签）。
• 配置自定义：根据实际日志生成量调整size和rotate参数，避免日志轮转过于频繁或保留过多历史日志。
• 权限配置：确保容器对挂载的日志目录具有读写权限，建议与CrafterCMS应用使用相同的用户组ID。