Debian软件包的版本控制如何实现

Debian软件包的版本控制实现

一 版本号结构与比较规则

• 命名与组成
  • 二进制包文件名遵循：name_version-revision_arch.deb。其中 version 是上游版本，revision 是 Debian 修订号（打包脚本、补丁、构建流程的变更），arch 为目标架构（如 amd64、arm64、all）。示例：nginx_1.20.1-1ubuntu3_amd64.deb。内核或内核模块包也沿用该约定，例如 2.6.15-28-amd64-generic 中的 -28 属于 Debian 修订部分。
• 比较与排序
  • 版本比较由 dpkg --compare-versions 实现，遵循 Debian 的版本比较算法（处理组件顺序、波浪号、补丁级等）。必要时可用该工具进行人工判定。
• Epoch 机制
  • 当上游版本号发生重大倒退或重排，需要强制提升优先级时，可在 Version 字段使用 epoch:version-revision 形式（例如 2:1.0.0-1）。Epoch 的优先级高于版本与修订，能确保正确的升级/回滚顺序。

二 仓库与发行版通道的版本流转

• 发行版通道
  • unstable（sid）：持续接收新包与新版本，作为开发入口；testing：从 unstable 按策略自动迁入；stable：冻结后发布，除安全与严重缺陷外基本不变化。
• 自动迁移与约束（由 britney 等迁移工具实施）
  • 基本规则：不降级（迁移版本不能低于 testing 现有版本）；不破坏可安装性（不使仓库中既有包变得不可装）；保持协同安装性；通常要求无严重 RC 缺陷；对多架构支持一致；迁移时源码与二进制需成对。
  • 时间与质量门槛：常见门槛包括包在 unstable 的“停留时间”（如约 2/5/10 天的分级门槛）、缺陷清零、架构全覆盖等，以降低风险。

三 运维侧的版本选择与锁定

• 查询与安装指定版本
  • 查看可用版本：apt list --all-versions ；安装指定版本：apt install =；若存在强依赖，需同步指定关联包版本以避免冲突。
• 防止意外升级
  • 版本锁定：apt-mark hold ；解除锁定：apt-mark unhold 。适用于生产环境固化版本、回滚后防止被升级。
• 变更生效与索引
  • 添加/更换源后执行 apt update 以刷新索引；安装或回滚前可用 apt-cache depends 检查依赖关系，确保可安装性与一致性。

四 打包侧的版本控制实践

• 何时递增修订号
  • 仅修改打包脚本（如 debian/rules、control）、打补丁、变更打包流程或变更打包依赖时，递增 debian_revision（例如从 -1 到 -2），而保持 upstream_version 不变。
• 何时递增上游版本
  • 上游发布新版本时，更新 upstream_version 并将 debian_revision 重置为 -1（或相应发行版前缀的起始值）。
• 何时使用 Epoch
  • 当上游版本号出现回退、格式重排或需要强制覆盖默认比较结果时，引入 epoch 并谨慎递增，同时在变更日志中记录充分理由。
• 多架构与一致性
  • 确保各架构构建结果一致、依赖可满足；若某架构暂不可用，不应阻塞迁移，但应在可构建后补齐，以避免破坏仓库可安装性。