Bitbucket Pipelines手动运行流水线能否添加变量说明文档?
Bitbucket Pipelines自定义流水线变量说明文档支持情况
目前Bitbucket Pipelines的Web UI手动运行自定义流水线时,不支持在变量输入表单区域添加自定义描述文档(不管是表单上方的全局说明,还是单个变量旁的字段描述都不行)。
你当前能用到的配置项只有这些:
- 给自定义流水线设置
name:在bitbucket-pipelines.yml里定义自定义流水线时,通过name字段设置显示在Web UI的流水线名称,能简单说明流水线的核心功能 - 变量配置:只能给每个变量设置
default默认值、allowed-values可选值列表,以及标记required: true(必填),但无法为变量添加文字描述
如果要避免其他用户误解参数要求或流水线功能,可以试试这些替代方法:
- 把关键说明塞进流水线
name里,比如写成部署到预发布环境 [必填:版本号格式vX.X.X,如v1.2.3],虽然长度有限但直观 - 给变量起语义化名称,比如用
RELEASE_VERSION代替VER,减少理解成本 - 在
bitbucket-pipelines.yml的自定义流水线块上方添加详细注释,配合团队内部同步(比如在团队群、内部文档里提醒大家查看配置注释) - 把流水线的完整参数规则、功能说明整理到团队内部文档中,在流水线名称里提示参考该文档
内容的提问来源于stack exchange,提问作者benjimin
相关产品推荐
相关产品推荐

