imroc/logrotate

imroc/logrotate 镜像文档

镜像概述

imroc/logrotate是一个多平台Docker容器，基于logrotate工具构建，主要用于日志轮转管理。该镜像设计为可作为sidecar容器运行，尤其适用于Kubernetes环境中与其他服务协同工作，自动处理日志文件的轮转、压缩和保留。

• Docker镜像地址：https://hub.docker.com/repository/docker/imroc/logrotate/general
• GitHub仓库：https://github.com/imroc/docker-logrotate

核心功能与特性

• 多平台支持：适配多种架构的Docker环境
• Sidecar模式：可作为辅助容器与主服务共享日志目录，独立处理日志轮转
• 灵活调度：通过cron表达式配置日志轮转的执行周期
• 可配置参数：支持自定义日志文件路径模式、轮转触发大小、保留文件数量等
• 轻量级：基于精简基础镜像，资源占用低

使用场景

• Kubernetes集群中为各类服务（如Nginx、应用服务等）提供日志轮转能力
• 需要自动管理容器内日志文件大小，防止磁盘空间耗尽的场景
• 需按固定周期或文件大小触发日志轮转、压缩和清理的场景

配置说明

crond配置

通过以下环境变量配置日志轮转的调度策略：

logrotate配置

可通过挂载logrotate.conf文件到/etc/logrotate.conf进行自定义配置，或通过以下环境变量配置：

使用示例：轮转Nginx Ingress Controller日志

以下是在Kubernetes环境中，为ingress-nginx控制器配置logrotate sidecar的示例（通过Helm chart的values.yaml配置）：

yaml
controller:
  config:
    access-log-path: /var/log/nginx/nginx_access.log  # 配置Nginx访问日志路径
    error-log-path: /var/log/nginx/nginx_error.log    # 配置Nginx错误日志路径
  extraVolumes:
    - name: log  # 定义共享日志卷
      emptyDir: {}
  extraVolumeMounts:
    - name: log  # 挂载共享日志卷到Nginx容器
      mountPath: /var/log/nginx
  extraContainers:  # 添加logrotate sidecar容器
    - name: logrotate
      image: imroc/logrotate:latest
      imagePullPolicy: IfNotPresent
      env:
        - name: LOGROTATE_FILE_PATTERN
          value: "/var/log/nginx/nginx_*.log"  # 匹配Nginx日志文件
        - name: LOGROTATE_FILESIZE
          value: "20M"  # 文件达到20M时触发轮转
        - name: LOGROTATE_FILENUM
          value: "10"   # 保留10个轮转文件
        - name: CRON_EXPR
          value: "*/1 * * * *"  # 每分钟执行一次轮转检查
        - name: CROND_LOGLEVEL
          value: "7"  # 设置crond日志级别为7
      volumeMounts:
        - name: log  # 共享日志目录，与Nginx容器访问同一日志文件
          mountPath: /var/log/nginx