首页/开发/CI/CD 与发布速查/构建号与流水线序号
构建与制品管理58 条

构建号与流水线序号

单调递增的构建编号(CI_PIPELINE_IID / GITHUB_RUN_NUMBER / BUILD_NUMBER)用于区分同名版本的多次构建,方便追溯与排序。

CI/CD 与发布速查开发更新于 2026-10-12
平台变量GitLab $CI_PIPELINE_IID(项目内递增);GitHub ${{ github.run_number }};Jenkins $BUILD_NUMBER
用途构建产物命名、发布记录排序、问题定位
注意构建号不跨平台可比,只用于同一系统的顺序标识

组合版本

组合版本
VERSION="1.8.0+build.${CI_PIPELINE_IID:-local}"
echo "$VERSION" > dist/version.txt
把构建号写进制品元数据(如 version.txt),线上核对版本时一查即明。

易错点

  • 用构建号直接当发布版本:语义缺失、跨流水线不可比,只作补充标识
  • 重置流水线后构建号回绕:发布记录出现重复编号,历史查询需以制品 digest 为准

数据来源与参考

  • GitLab Docs《Predefined CI/CD variables》
  • GitHub Docs《Contexts》
  • Jenkins Docs《Environment variables》
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌