首页
/ WhatsUpDocker中Docker Compose自动更新配置指南

WhatsUpDocker中Docker Compose自动更新配置指南

2025-07-05 04:43:20作者:郁楠烈Hubert

WhatsUpDocker(简称WUD)是一个实用的Docker容器监控工具,能够自动检测容器镜像的更新情况。本文将详细介绍如何正确配置WUD的Docker Compose触发器功能,实现容器镜像的自动更新。

核心配置要点

在配置WUD的Docker Compose触发器时,有几个关键配置项需要注意:

  1. 触发器类型定义:必须明确指定触发器类型为DOCKERCOMPOSE
  2. 文件路径设置:需要正确映射主机上的docker-compose.yml文件路径到容器内
  3. 更新策略配置:可以设置更新阈值(threshold)和是否自动更新(auto)等参数

典型配置示例

以下是一个完整的WUD配置示例,展示了如何为一个名为"maintainerr"的项目设置自动更新:

version: '3'

services:
  whatsupdocker:
    image: fmartinou/whats-up-docker
    container_name: wud
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /home/docker/docker_compose_projects:/docker_compose_projects
    environment:
      - WUD_TRIGGER_DOCKERCOMPOSE_MAINTAINERR_THRESHOLD=minor
      - WUD_TRIGGER_DOCKERCOMPOSE_MAINTAINERR_BACKUP=true
      - WUD_TRIGGER_DOCKERCOMPOSE_MAINTAINERR_FILE=/docker_compose_projects/maintainerr/docker-compose.yml
      - WUD_TRIGGER_DOCKERCOMPOSE_MAINTAINERR_AUTO=true

配置参数详解

  1. THRESHOLD参数:决定触发更新的版本级别

    • major:仅主版本更新时触发
    • minor:次版本及以上更新时触发(推荐设置)
    • patch:任何版本更新都触发
  2. BACKUP参数:设置为true时,WUD会在更新前自动备份原docker-compose文件

  3. FILE参数:必须指向容器内可访问的docker-compose.yml文件路径

  4. AUTO参数:设置为true时允许自动更新,false则只通知不自动更新

项目配置要求

被监控的项目需要在docker-compose.yml中添加特定标签才能被WUD识别:

services:
    maintainerr:
        image: ghcr.io/jorenn92/maintainerr:2.8.0
        labels:
          - 'wud.tag.include=^\d+\.\d+\.\d+$$'
          - 'wud.link.template=https://github.com/jorenn92/Maintainerr/releases/tag/v$${major}.$${minor}.$${patch}'

其中wud.tag.include定义了版本号的正则匹配模式,wud.link.template则指定了版本更新链接模板。

常见问题解决

  1. 触发器不显示在UI中:通常是由于使用了旧版本镜像导致,建议更新到最新版本

  2. 路径映射问题:确保主机上的docker-compose文件路径正确映射到容器内

  3. 权限问题:WUD容器需要有权限读写目标docker-compose文件

通过以上配置,WhatsUpDocker可以有效地监控并自动更新Docker Compose项目,大大简化了容器维护工作。

登录后查看全文
热门项目推荐
相关项目推荐