Diun镜像更新监控工具从v0到v1版本迁移指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00501/article/details/148575147

Diun镜像更新监控工具从v0到v1版本迁移指南

diun crazy-max/diun: Diun 是一个用于自动更新 Docker 镜像的 Python 库，可以用于自动化更新 Docker 镜像和容器，支持多种 Docker 镜像仓库和容器运行时，可以用于自动化部署和更新 Docker 应用程序。项目地址: https://gitcode.com/gh_mirrors/di/diun

前言

Diun是一款优秀的容器镜像更新监控工具，它能够持续监控Docker镜像仓库中的镜像更新情况，并在发现新版本时及时通知用户。随着项目的不断发展，Diun从v0版本升级到了v1版本，带来了一些配置上的重要变更。本文将详细介绍这些变更内容，帮助用户顺利完成版本迁移。

配置变更详解

1. 注册表配置项重命名

在v0版本中，注册表配置使用registries字段，而在v1版本中，这个字段被重命名为regopts（Registry Options的缩写）。这个变更使字段名称更加语义化，明确表示了这部分配置是关于注册表选项的设置。

变更前(v0):

registries:
  someregistryoptions:
    username: foo
    password: bar

变更后(v1):

regopts:
  someregistryoptions:
    username: foo
    password: bar

2. 镜像列表配置项重命名

v0版本中的items字段在v1版本中被重命名为image。这个变更使配置更加直观，明确表示这部分是关于镜像的配置。

变更前(v0):

items:
  - image: docker.io/crazymax/nextcloud:latest

变更后(v1):

image:
  - name: docker.io/crazymax/nextcloud:latest

3. 镜像名称字段变更

在v0版本中，每个镜像项的镜像名称使用image字段，而在v1版本中，这个字段被重命名为name。这个变更使配置结构更加清晰，避免了字段名的重复使用。

4. 注册表ID字段变更

v0版本中使用registry_id来引用注册表配置，在v1版本中这个字段被重命名为regopts_id。这个变更保持了与注册表配置项重命名的一致性。

5. 操作系统和架构配置迁移

在v0版本中，watch.os和watch.arch是全局配置项，适用于所有镜像。v1版本将这些配置移动到了每个镜像项中，作为os和arch字段。这个变更提供了更大的灵活性，允许为每个镜像单独指定操作系统和架构。

变更前(v0):

watch:
  os: linux
  arch: amd64

变更后(v1):

image:
  - name: docker.io/crazymax/nextcloud:latest
    os: linux
    arch: amd64

完整配置示例对比

为了更清楚地展示这些变更，我们来看一个完整的配置示例对比：

v0版本配置示例:

watch:
  os: linux
  arch: amd64

registries:
  someregistryoptions:
    username: foo
    password: bar
    timeout: 20

items:
  - image: docker.io/crazymax/nextcloud:latest
    registry_id: someregistryoptions

v1版本配置示例:

regopts:
  someregistryoptions:
    username: foo
    password: bar
    timeout: 20

image:
  - name: docker.io/crazymax/nextcloud:latest
    regopts_id: someregistryoptions
    os: linux
    arch: amd64