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

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项目，大大简化了容器维护工作。