cyre/docker-nightly-restart

容器自动更新与重启工具镜像

镜像概述

本Docker镜像提供容器环境的自动化维护功能，专注于每日定时更新容器镜像并重启指定的Docker服务或独立容器。通过预设的定时任务机制，减少手动操作成本，确保容器环境持续运行在最新状态，提升系统稳定性和安全性。

核心功能与特性

• 定时自动执行：基于crontab时间规则，每日自动触发容器更新与重启流程
• 多类型容器支持：兼容Docker Compose管理的服务和独立运行的容器
• 灵活目标配置：可精确指定需要更新的服务/容器，或排除特定容器
• 轻量级设计：基于精简基础镜像构建，资源占用低，运行效率高
• 配置化操作：通过环境变量自定义更新时间、目标范围和重启策略

使用场景与适用范围

• 个人或小型团队的Docker环境日常维护
• 需要定期更新应用镜像以获取最新功能或安全补丁的场景
• 希望减少手动执行docker pull和docker restart操作的用户
• 开发、测试或生产环境中需保持容器服务持续可用的场景
• 对容器更新频率有固定要求（如每日更新）的业务场景

使用方法与配置说明

基本使用条件

• 宿主环境需安装Docker Engine
• 容器需挂载Docker套接字以获得操作权限
• 建议配置持久化日志以便问题排查

环境变量配置

部署示例

1. Docker Run命令部署

bash
docker run -d \
  --name container-updater \
  --restart always \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /path/to/local/logs:/app/logs \  # 可选，持久化日志
  -e SCHEDULE="0 2 * * *" \          # 每日凌晨2点执行
  -e TARGET_SERVICES="web,api" \     # 仅更新web和api服务
  -e EXCLUDE_CONTAINERS="db,redis" \ # 排除数据库和缓存容器
  your-image-name:latest

2. Docker Compose配置

yaml
version: '3.8'

services:
  auto-updater:
    image: your-image-name:latest
    container_name: container-updater
    restart: always
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./logs:/app/logs  # 日志持久化
    environment:
      - SCHEDULE=0 4 * * *  # 每日凌晨4点执行
      - TARGET_CONTAINERS=frontend,backend  # 仅更新前端和后端容器
      - RESTART_POLICY=unless-stopped  # 非手动停止则自动重启

注意事项

• 挂载Docker套接字（/var/run/docker.sock）是必要操作，确保容器具有管理Docker的权限
• 生产环境建议通过EXCLUDE_CONTAINERS排除核心服务（如数据库），避免意外重启导致数据风险
• 首次运行时建议观察日志输出，确认定时任务是否按预期执行
• 若需修改定时任务时间，可通过docker exec进入容器修改crontab配置，或重新部署并更新SCHEDULE变量