clockworksoul/docker-gc-cron

docker-gc-cron

docker-gc-cron容器会定期运行Spotify的https://github.com/spotify/docker-gc%EF%BC%8C%E8%87%AA%E5%8A%A8%E6%B8%85%E7%90%86%E6%9C%AA%E4%BD%BF%E7%94%A8%E7%9A%84%E5%AE%B9%E5%99%A8%E5%92%8C%E9%95%9C%E5%83%8F%E3%80%82%E7%89%B9%E5%88%AB%E9%80%82%E7%94%A8%E4%BA%8E%E9%9C%80%E8%A6%81%E6%9E%84%E5%BB%BA%E6%88%96%E6%8B%89%E5%8F%96%E5%A4%A7%E9%87%8FDocker%E9%95%9C%E5%83%8F%E5%92%8C%E5%AE%B9%E5%99%A8%E7%9A%84%E7%B3%BB%E7%BB%9F%EF%BC%8C%E5%A6%82CI%E8%8A%82%E7%82%B9%E3%80%82%E9%BB%98%E8%AE%A4%E6%AF%8F%E5%A4%A9%E5%8D%88%E5%A4%9C%E8%BF%90%E8%A1%8C%EF%BC%8C%E5%8F%AF%E9%80%9A%E8%BF%87%E6%A0%87%E5%87%86%60cron%60%E8%AF%AD%E6%B3%95%E7%B2%BE%E7%A1%AE%E6%8C%87%E5%AE%9A%E6%89%A7%E8%A1%8C%E6%97%B6%E9%97%B4%E5%92%8C%E5%85%B6%E4%BB%96%E8%A1%8C%E4%B8%BA%E3%80%82%E4%BB%93%E5%BA%93%E7%9A%84%60compose%60%E7%9B%AE%E5%BD%95%E4%B8%AD%E6%8F%90%E4%BE%9B%E4%BA%86%60docker-compose.yml%60%E6%96%87%E4%BB%B6%EF%BC%8C%E7%AE%80%E5%8C%96%E9%83%A8%E7%BD%B2%E8%BF%87%E7%A8%8B%E3%80%82

快速安装

bash
$ wget https://raw.githubusercontent.com/clockworksoul/docker-gc-cron/master/compose/docker-gc-exclude
$ wget https://raw.githubusercontent.com/clockworksoul/docker-gc-cron/master/compose/docker-compose.yml
$ docker-compose up -d

这将拉取并运行与本地Docker守护进程关联的docker-gc-cron镜像。默认情况下，垃圾回收进程每晚午夜执行，但可通过修改CRON属性轻松更改（见下文）。使用此docker-compose.yml文件时，docker-gc-exclude文件是必需的。

支持的环境设置

该容器支持https://github.com/spotify/docker-gc%E7%9A%84%E6%89%80%E6%9C%89%E8%AE%BE%E7%BD%AE%EF%BC%8C%E4%BB%A5%E5%8F%8A%E7%94%A8%E4%BA%8E%E4%BF%AE%E6%94%B9%E6%B8%85%E7%90%86%E9%A2%91%E7%8E%87%E7%9A%84%E9%A2%9D%E5%A4%96%E8%AE%BE%E7%BD%AE%E3%80%82%E4%BB%A5%E4%B8%8B%E5%A4%A7%E9%83%A8%E5%88%86%E6%96%87%E6%A1%A3%E5%80%9F%E9%89%B4%E5%B9%B6%E4%BF%AE%E6%94%B9%E8%87%AAhttps://github.com/spotify/docker-gc/blob/master/README.md#excluding-images-from-garbage-collection%E3%80%82

所有环境变量均可通过获取并修改docker-compose.yml文件来使用。

修改清理计划

默认情况下，docker-gc-cron进程每天午夜（cron表达式"0 0 * * *"）运行。可通过CRON设置覆盖此计划：

bash
docker run -d -v /var/run/docker.sock:/var/run/docker.sock -e CRON="0 */6 * * *" clockworksoul/docker-gc-cron

强制删除多标签镜像

默认情况下，若镜像在多个仓库中标记，Docker不会删除该镜像。在CI环境等需要构建、重新标记和推送镜像的场景下，可启用强制标志覆盖此默认行为：

bash
docker run -d -v /var/run/docker.sock:/var/run/docker.sock -e FORCE_IMAGE_REMOVAL=1 clockworksoul/docker-gc-cron

保留每个仓库的最小镜像数量

可设置保留每个仓库的最近镜像数量。例如，开发中持续重建镜像时，可保留最新版本。通过MINIMUM_IMAGES_TO_SAVE环境变量设置，如保留最近3个镜像：

bash
docker run -d -v /var/run/docker.sock:/var/run/docker.sock -e MINIMUM_IMAGES_TO_SAVE=3 clockworksoul/docker-gc-cron

强制删除容器

默认情况下，清理容器时遇到错误，Docker会报告错误并保留容器，可能导致容器堆积。设置以下环境变量可强制删除容器：

bash
docker run -d -v /var/run/docker.sock:/var/run/docker.sock -e FORCE_CONTAINER_REMOVAL=1 clockworksoul/docker-gc-cron

排除最近退出的容器和镜像

默认情况下，docker-gc不会删除退出时间少于3600秒（1小时）的容器，以及创建时间少于3600秒的镜像。如需调整（如保留几天用于调试），通过GRACE_PERIOD_SECONDS变量修改：

bash
docker run -d -v /var/run/docker.sock:/var/run/docker.sock -e GRACE_PERIOD_SECONDS=86400 clockworksoul/docker-gc-cron

清理孤立容器卷

已删除容器留下的孤立卷会逐渐占用磁盘空间。默认不清理孤立卷，设置CLEAN_UP_VOLUMES=1可在docker-gc执行后自动清理悬空卷（通过docker volume rm $(docker volume ls -qf dangling=true)实现）：

bash
docker run -d -v /var/run/docker.sock:/var/run/docker.sock -e CLEAN_UP_VOLUMES=1 clockworksoul/docker-gc-cron

模拟运行

默认情况下，docker-gc会执行删除操作。设置DRY_RUN=1可测试命令选项，不实际删除容器和镜像：

bash
docker run -d -v /var/run/docker.sock:/var/run/docker.sock -e DRY_RUN=1 clockworksoul/docker-gc-cron