blacklabelops/logrotate

Docker化Logrotate镜像

镜像概述

该镜像将Logrotate工具容器化，作为边车容器为Docker容器提供日志轮转功能。它可自动扫描指定目录的日志文件，执行轮转、压缩、删除旧日志等操作，帮助用户高效管理容器日志。

核心功能

• 按时间间隔（小时/日/周/月/年）轮转日志
• 按文件大小触发轮转（如10M、100G）
• 配置日志保留数量（默认5份）
• 支持日志压缩（compress/nocompress）
• 自定义日志文件后缀（默认.log，可扩展为json/xml等）
• 指定旧日志存储目录
• 自定义Cron调度规则
• 时区设置（默认UTC）
• 禁用配置自动更新

使用场景

1. Docker容器日志管理：为高日志量容器提供自动轮转
2. Kubernetes集群：通过DaemonSet部署到所有节点，统一管理节点日志
3. 开发/测试环境：快速配置日志策略，避免日志过大占用空间

配置说明

环境变量列表

部署示例

基础用法（每日轮转Docker日志）

bash
docker run -d \
  -v /var/lib/docker/containers:/var/lib/docker/containers \
  -v /var/log/docker:/var/log/docker \
  -e "LOGS_DIRECTORIES=/var/lib/docker/containers /var/log/docker" \
  blacklabelops/logrotate

按小时轮转并压缩

bash
docker run -d \
  -v /var/lib/docker/containers:/var/lib/docker/containers \
  -v /var/log/docker:/var/log/docker \
  -e "LOGS_DIRECTORIES=/var/lib/docker/containers /var/log/docker" \
  -e "LOGROTATE_INTERVAL=hourly" \
  -e "LOGROTATE_COMPRESSION=compress" \
  blacklabelops/logrotate

Kubernetes DaemonSet部署

创建logrotate_ds.yaml：

yaml
apiVersion: apps/v1
kind: DaemonSet
metadata:
  name: logrotate
spec:
  selector:
    matchLabels:
      app: logrotate
  template:
    metadata:
      labels:
        app: logrotate
    spec:
      containers:
      - name: logrotate
        image: blacklabelops/logrotate
        volumeMounts:
        - name: docker-containers
          mountPath: /var/lib/docker/containers
        - name: docker-log
          mountPath: /var/log/docker
        env:
        - name: LOGS_DIRECTORIES
          value: "/var/lib/docker/containers /var/log/docker"
        - name: LOGROTATE_INTERVAL
          value: "daily"
        - name: LOGROTATE_COPIES
          value: "7"
      volumes:
      - name: docker-containers
        hostPath: {path: /var/lib/docker/containers}
      - name: docker-log
        hostPath: {path: /var/log/docker}

部署命令：kubectl create -f logrotate_ds.yaml

参考链接

• Logrotate官方文档
• Docker官网
• Docker用户指南