hylandsoftware/tagd

VMware Harbor标签清理守护程序（tagd）

tagd是一款自动化工具，用于清理VMware Harbor容器 registry中的旧镜像标签，帮助运维人员维护 registry整洁、释放存储空间。它支持灵活的规则配置，适配不同项目和仓库的标签保留需求。

核心功能

• 自动清理Harbor registry中的旧标签，支持干运行（仅生成报告）和破坏性模式（实际删除）
• 全局忽略特定项目、仓库或标签（如latest）
• 提供默认规则，同时允许添加自定义规则（按项目、仓库、标签正则匹配）
• 支持通过本地配置文件或Spring Cloud Config Server管理规则
• 验证规则配置的有效性
• 可选将清理结果发送至Slack兼容的webhook

使用场景

• 定期清理Harbor registry中过时的镜像标签，减少存储空间占用
• 统一管理多项目/仓库的标签保留策略，避免手动清理的繁琐
• 集成到自动化运维流程，提升效率

配置说明

配置文件格式（YAML）

yaml
# 全局忽略的项目、仓库、标签（精确匹配）
ignoreGlobally:
  projects: []
  repos: []
  tags: ['latest']
# 默认规则（无匹配规则时生效）
defaultRule:
  project: '.*'      # 匹配项目的正则表达式
  repo: '.*'         # 匹配仓库的正则表达式
  tag: '.*'          # 匹配标签的正则表达式
  ignore: ['latest'] # 始终保留的标签
  keep: 10           # 保留的标签数量（按创建时间排序）
# 自定义规则列表
rules:
- project: '.*'
  repo: '.*'
  tag: '.*'
  ignore: ['latest']
  keep: 10

规则验证

使用check命令验证配置有效性：

bash
dotnet ./dist/Harbor.Tagd.dll check --config-file rules.yml --verbosity verbose

部署示例

Docker干运行（仅生成报告）

bash
docker run -it --rm -v $(pwd)/config.yml:/config.yml hylandsoftware/tagd \
    --config-file /config.yml \
    --endpoint <你的Harbor服务器地址> \
    --user <服务用户> \
    --password <服务用户密码>

Docker实际删除标签

bash
docker run -it --rm -v $(pwd)/config.yml:/config.yml hylandsoftware/tagd \
    --config-file /config.yml \
    --endpoint <你的Harbor服务器地址> \
    --user <服务用户> \
    --password <服务用户密码> \
    --destructive

发送结果到Slack

bash
docker run -it --rm -v $(pwd)/config.yml:/config.yml hylandsoftware/tagd \
    --config-file /config.yml \
    --endpoint <你的Harbor服务器地址> \
    --user <服务用户> \
    --password <服务用户密码> \
    --destructive \
    --notify-slack https://hooks.slack.com/services/XXX/YYY/ZZZ

许可证

tagd基于MIT许可证开源，详情见https://github.com/HylandSoftware/Harbor.Tagd/blob/master/LICENSE%E3%80%82%E4%BE%9D%E8%B5%96%E7%9A%84nuget%E5%8C%85%E5%8F%AF%E8%83%BD%E6%9C%89%E4%B8%8D%E5%90%8C%E8%AE%B8%E5%8F%AF%E8%AF%81%EF%BC%8C%E8%AF%B7%E5%8F%82%E8%80%83%E5%90%84%E5%8C%85%E8%AF%B4%E6%98%8E%E3%80%82