首页/开发/CI/CD 与发布速查/提交散列作为版本标识
构建与制品管理58 条

提交散列作为版本标识

用 commit SHA(常取前 7-12 位)标识构建来源:全球唯一、不可追溯伪造,适合内部构建与镜像标签。

CI/CD 与发布速查开发更新于 2026-10-12
形式gabc1234 / 完整 40 位 SHA
平台变量GitLab $CI_COMMIT_SHORT_SHA;GitHub ${{ github.sha }}
特点唯一但不排序、不表达兼容性,仅作溯源标识

打标签

打标签
docker build -t registry.example.com/app:sha-$(git rev-parse --short HEAD) .
生产环境建议「语义版本标签 + SHA 标签」双轨:对外可读、对内精确。

易错点

  • 以短 SHA 作为唯一发布版本:客户与支持团队无法读出轻重缓急,配合语义版本使用
  • 在镜像里覆盖同一 SHA 标签:SHA 标签一旦推送即应视为不可变

数据来源与参考

  • git 文档《git-rev-parse》
  • GitLab Docs《Predefined CI/CD variables》
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌