apparle/watchtower

Watchtower (Podman兼容版) v1.7.1

镜像概述

本镜像为基于Watchtower v1.7.1的定制化构建版本，专门优化以支持Podman容器引擎，同时已合并PR !2072并禁用内存交换（mem swappiness）功能。Watchtower是一款容器自动化管理工具，核心功能为监控容器镜像的更新状态，当检测到基础镜像有新版本时，自动拉取更新并重启相关容器，确保容器始终运行最新版本。

核心功能与特性

1. Podman兼容性

• 原生支持Podman容器引擎，可直接与Podman API交互，替代Docker引擎环境下的容器监控与更新能力。

2. PR !2072合并

• 已集成PR !2072的代码改进（具体功能需参考该PR的官方描述），可能包含功能增强、bug修复或性能优化。

3. 内存交换禁用

• 禁用内存交换（mem swappiness=0），减少容器运行时对交换空间的依赖，降低因内存交换导致的性能波动，提升容器稳定性。

4. 基于Watchtower v1.7.1核心功能

• 保留Watchtower原生能力：自动检查镜像更新、支持定时任务调度、可配置清理旧镜像、多容器批量管理等。

使用场景与适用范围

适用场景

• Podman环境部署：需在Podman容器引擎下实现容器自动更新的场景。
• 性能敏感场景：对容器内存性能要求较高，需避免内存交换影响服务响应速度的业务（如数据库、API服务等）。
• 定制化需求：依赖PR !2072功能改进的特定容器管理场景。

不适用场景

• 依赖Docker专有特性（如Docker Swarm）的环境（本镜像专注Podman兼容）。
• 需启用内存交换功能的特殊容器部署需求。

使用方法与配置说明

前置条件

• 已安装Podman容器引擎（推荐v3.0+版本）。
• 容器需挂载Podman socket（通常路径：/var/run/podman/podman.sock）。

部署示例

1. Podman run命令部署

bash
podman run -d \
  --name watchtower \
  --volume /var/run/podman/podman.sock:/var/run/podman/podman.sock \
  --restart unless-stopped \
  [镜像名称] \
  --interval 300 \  # 检查间隔（秒），默认300秒（5分钟）
  --cleanup \       # 自动清理旧镜像
  --include-stopped  # 同时监控已停止的容器

2. Podman Compose配置示例

创建docker-compose.yml（或podman-compose.yml）：

yaml
version: '3'
services:
  watchtower:
    image: [镜像名称]
    container_name: watchtower
    volumes:
      - /var/run/podman/podman.sock:/var/run/podman/podman.sock
    restart: unless-stopped
    command: --interval 300 --cleanup

启动命令：podman-compose up -d

关键配置参数

常用命令行参数

环境变量

注意事项

• 确保Podman socket文件权限正确，容器需有读取权限（通常通过挂载时设置chmod 666或调整用户权限）。
• PR !2072的具体功能请参考Watchtower官方PR描述，以了解其带来的功能变更或修复内容。
• 禁用内存交换可能导致容器在内存不足时直接OOM（内存溢出），需确保宿主机有足够物理内存。