tianon/uscan-helper

debian/watch Docker版本监控配置

概述

本配置文件用于Debian维护流程中的uscan工具，监控Docker上游项目（https://github.com/docker/docker%EF%BC%89%E7%9A%84%E7%89%88%E6%9C%AC%E6%9B%B4%E6%96%B0%E3%80%82%E9%80%9A%E8%BF%87%E5%AE%9A%E4%B9%89%E7%89%88%E6%9C%AC%E5%8F%B7%E5%A4%84%E7%90%86%E8%A7%84%E5%88%99%E5%92%8C%E4%B8%8B%E8%BD%BD%E9%93%BE%E6%8E%A5%E6%A8%A1%E5%BC%8F%EF%BC%8C%E5%AE%9E%E7%8E%B0%E8%87%AA%E5%8A%A8%E6%A3%80%E6%B5%8B%E6%96%B0%E7%89%88%E6%9C%AC%E3%80%81%E6%A0%87%E5%87%86%E5%8C%96%E7%89%88%E6%9C%AC%E5%8F%B7%E6%A0%BC%E5%BC%8F%E5%8F%8A%E7%94%9F%E6%88%90%E7%AC%A6%E5%90%88Debian%E8%A7%84%E8%8C%83%E7%9A%84%E6%BA%90%E6%96%87%E4%BB%B6%E5%90%8D%E7%A7%B0%EF%BC%8C%E8%BE%85%E5%8A%A9Docker%E7%9B%B8%E5%85%B3Debian%E5%8C%85%EF%BC%88%E5%A6%82%60docker.io%60%EF%BC%89%E7%9A%84%E6%9B%B4%E6%96%B0%E7%BB%B4%E6%8A%A4%E3%80%82

核心功能与特性

版本监控

• 监控源：通过https://uscan.tianon.xyz/github.com/docker/docker代理访问Docker GitHub仓库的版本信息
• 版本匹配：自动识别GitHub标签中符合v(\d\S*)\.tar\.gz格式的上游版本压缩包

版本号处理

• dversionmangle：处理本地版本号，移除Debian特定后缀（如debian、dfsg、ds、deb及后续数字），示例：1.11.2~ds1 → 1.11.2
• uversionmangle：标准化上游预发布版本号，将RC、rc、pre、dev、beta、alpha等前缀转换为Debian兼容格式，示例：1.12.1-rc2 → 1.12.1~rc2
• filenamemangle：重命名下载文件为Debian源文件格式，示例：v1.12.1.tar.gz → docker.io_1.12.1.orig.tar.gz

自动化检测

• 对比本地版本（从debian/changelog获取）与上游版本，自动识别新版本并报告下载链接

使用场景

• Debian/Ubuntu系统中Docker相关软件包（如docker.io）的维护工作
• 自动化跟踪Docker上游版本更新，减少手动检查新版本的工作量
• 确保Debian包版本号与上游版本号的兼容性和标准化

配置说明

配置文件结构

version=3
opts=\
dversionmangle=s/[+~](debian|dfsg|ds|deb)\d*$//,\
uversionmangle=s/(\d)[_\.\-\+]?((RC|rc|pre|dev|beta|alpha)\d*)$/$1~$2/,\
filenamemangle=s/.+\/v(\d\S*)\.tar\.gz/docker.io_$1.orig.tar.gz/ \
  https://uscan.tianon.xyz/github.com/docker/docker https://github.com/.*/v(\d\S*)\.tar\.gz debian ./debian/repack.sh

参数详解

• version=3：指定uscan配置文件格式版本3
• opts：配置选项集合
  • dversionmangle：本地版本号处理正则，移除Debian特定后缀
  • uversionmangle：上游版本号处理正则，标准化预发布版本标识
  • filenamemangle：下载文件重命名规则，生成docker.io_<version>.orig.tar.gz格式文件名
• URL配置：监控地址与下载链接模板，指定从GitHub获取tar.gz格式的源码包

使用方法

检查版本更新

执行uscan命令扫描上游版本：

console
uscan --verbose --report

命令输出解读

• 显示本地版本（从debian/changelog读取）与上游最新版本对比
• 列出所有匹配的上游版本链接（按版本号降序排列）
• 若检测到新版本，提示下载链接，如：

  uscan: Newest version of docker.io on remote site is 1.12.1, local version is 1.11.2~ds1
  (mangled local version is 1.11.2)
  uscan:    => Newer package available from
        https://github.com/docker/docker/archive/v1.12.1.tar.gz
  

注意事项

• 配置中注释提到/tags分页过早导致历史版本丢失，故使用uscan.tianon.xyz代理获取完整版本列表
• 需确保系统已安装devscripts包（包含uscan工具）
• 定期执行uscan以保持对上游版本的跟踪，及时发现新版本更新