如何重置Bitbucket Pipeline BUILD_NUMBER或设置低于当前值的构建编号

问题原因 #

该报错是Bitbucket Pipelines的原生设计限制：官方全局变量$BUILD_NUMBER不允许设置为低于现有历史构建的最大编号值，避免重复编号导致历史构建记录索引冲突。

可行解决方案 #

• 方案1：清空历史构建后重置
  进入对应仓库的Pipelines页面，删除所有状态的历史构建记录，历史记录完全清空后，再调用API设置你需要的初始$BUILD_NUMBER即可正常生效。注意：删除历史构建后对应的日志、产出物、运行记录都会永久清除，请提前做好备份。
• 方案2：使用自定义变量绕开限制
  无需修改官方默认的$BUILD_NUMBER，在仓库的Pipelines变量配置中新增自定义变量（例如CUSTOM_BUILD_NUMBER），初始值设置为你需要的数值。在流水线配置中自行维护该变量的递增逻辑，每次构建完成后调用变量更新接口修改该值即可，完全自主控制编号规则，不受官方构建号的最低值限制。
• 方案3：临时指定单次构建编号
  如果仅需要部分构建使用更低的编号，不需要全局修改构建号规则，可以直接在流水线脚本中硬编码编号值，或者通过流水线触发参数传入自定义编号，无需调整全局的$BUILD_NUMBER配置。

内容的提问来源于stack exchange，提问作者Bitwise DEVS