jaedle/cleanup-docker

Docker资源定期清理工具镜像

镜像概述和主要用途

本镜像旨在解决Docker环境中因资源堆积导致的磁盘空间不足问题。它通过定期执行Docker清理命令，自动删除未使用的容器、未绑定的卷和未使用的镜像，特别适用于GitLab构建worker等需要持续运行的Docker环境，防止长期运行后磁盘空间耗尽。

核心功能和特性

• 自动清理机制：容器启动时立即执行清理命令，之后按设定间隔重复清理
• 全面资源清理：执行以下命令清理Docker资源：

  sh
  docker container prune -f      # 删除所有未运行的容器
  docker volume prune -f         # 删除所有未绑定的卷
  docker image prune -a -f       # 删除所有未使用的镜像（包括无标签镜像）
  

• 可配置清理间隔：默认每24小时清理一次，支持通过环境变量自定义时间间隔
• 跨架构支持：提供amd64和arm32v7两种架构版本，适应不同硬件环境

使用场景和适用范围

• GitLab CI/CD构建worker节点
• 持续集成/持续部署(CI/CD)环境
• 产生大量临时Docker资源的服务器
• 任何需要自动维护Docker磁盘空间的环境

重要提示：仅适用于不依赖Docker卷存储持久化数据的场景，卷清理操作可能会删除重要数据。

使用方法和配置说明

基本要求

• 必须挂载Docker守护进程的Unix socket（/var/run/docker.sock）
• 确保环境中没有需要保留的未绑定卷数据

标准部署

amd64架构

sh
docker container run \
    -d \
    --restart unless-stopped \
    -v /var/run/docker.sock:/var/run/docker.sock \
    jaedle/cleanup-docker:latest

arm32v7架构

sh
docker container run \
    -d \
    --restart unless-stopped \
    -v /var/run/docker.sock:/var/run/docker.sock \
    jaedle/cleanup-docker:arm32v7

自定义清理间隔

通过CLEANUP_RATE环境变量设置清理间隔（单位：秒），默认值为86400秒（24小时）。

示例：每小时清理一次

sh
docker container run \
    -d \
    --restart unless-stopped \
    -e CLEANUP_RATE=3600 \
    -v /var/run/docker.sock:/var/run/docker.sock \
    jaedle/cleanup-docker:latest

参数说明

注意事项

• 卷清理会删除所有未绑定的卷，请确保环境中没有需要保留的卷数据
• 容器需要对Docker socket有访问权限，确保挂载路径正确
• 使用--restart unless-stopped策略可确保容器在主机重启后自动恢复运行
• 清理操作会删除未使用的镜像，包括构建缓存，可能会增加后续构建时间