对于由 push、commit.add 触发的构建，值为分支推送前远端仓库该分支最近一次提交的 sha，若是新建分支，值为 0000000000000000000000000000000000000000
对于 branch.create 触发的构建，值为 0000000000000000000000000000000000000000

CNB_COMMIT

构建时对应的代码 sha

对于 push、commit.add、branch.create 触发的构建，是最后一次提交的 sha
对于 tag_push、tag_deploy.* 触发的构建，是该 tag 最后一次提交的 sha
对于 auto_tag、branch.delete、issue.* 类事件，是主分支最后一次提交的 sha
对于 pull_request.merged 触发的构建，是合并后的 sha
对于 pull_request.target、pull_request.mergeable 触发的构建，是目标分支最后一次提交的 sha
对于 pull_request、pull_request.approved、pull_request.changes_requested、pull_request.comment，代码尚未真正合并，取源分支最后一次提交的 sha，但构建时会进行预合并，即合并后的内容会作为最终结果
对于 云原生开发、自定义事件 触发的构建，是指定分支的最后一次提交的 sha

CNB_COMMIT_SHORT

CNB_COMMIT 的缩写，取其前 8 位字符

CNB_COMMIT_MESSAGE

CNB_COMMIT 对应的提交信息

CNB_COMMIT_MESSAGE_TITLE

CNB_COMMIT_MESSAGE 的 title 部分，即首行

CNB_COMMITTER

CNB_COMMIT 对应的提交者

CNB_COMMITTER_EMAIL

CNB_COMMITTER 对应的邮箱

CNB_NEW_COMMITS_COUNT

对于由 commit.add 触发的构建，值为新增的 Commits 的数量。

可结合 git log -n 查看新增的 Commits。

CNB_IS_TAG

对于分支为 Tag 的构建，值为 ture

CNB_TAG_MESSAGE

Tag message：对于分支为 Tag 的构建, 会有该环境变量
否则值为空字符串

CNB_TAG_RELEASE_TITLE

Release 标题：对于分支为 Tag 的构建, 如果 Release 标题不为空，才会有值
否则值为空字符串

CNB_TAG_RELEASE_DESC

Release 描述：对于分支为 Tag 的构建, 且 Release 描述不为空，才会有值
否则值为空字符串

CNB_TAG_IS_RELEASE

Tag 是否存在对应的 Release：对于分支为 Tag 的构建，如果 Tag 存在对应的 Release，则为 true
否则为 false

CNB_TAG_IS_PRE_RELEASE

对于分支为 Tag 的构建，若存在对应的 Release，且 Release 为预发布，则值为 true
否则为 false

CNB_IS_NEW_BRANCH

当前分支是否属于一个新创建的分支，默认为 false

CNB_IS_NEW_BRANCH_WITH_UPDATE

当前分支是否属于一个新创建的分支，且带有新 commit，默认为 false

仓库类变量

CNB_REPO_SLUG

目标仓库路径，格式为 group_slug/repo_name，group_slug/sub_gourp_slog/.../repo_name

CNB_REPO_SLUG_LOWERCASE

目标仓库路径小写格式

CNB_REPO_NAME

目标仓库名称

CNB_REPO_NAME_LOWERCASE

目标仓库名称小写格式

CNB_REPO_ID

目标仓库的 id

CNB_REPO_URL_HTTPS

目标仓库仓库 https 地址

构建类变量

CNB_BUILD_ID

当前构建的流水号，全局唯一

CNB_BUILD_WEB_URL

当前构建的日志地址

CNB_BUILD_START_TIME

当前构建的开始时间，UTC 格式，示例 2025-08-21T09:13:45.803Z

CNB_BUILD_USER

当前构建的触发者用户名

CNB_BUILD_USER_NICKNAME

当前构建的触发者昵称

CNB_BUILD_USER_EMAIL

当前构建的触发者邮箱

CNB_BUILD_USER_ID

当前构建的触发者 id

CNB_BUILD_USER_NPC_SLUG

当前构建若为 NPC 触发，则为 NPC 所属仓库的路径

CNB_BUILD_USER_NPC_NAME

当前构建若为 NPC 触发，则为 NPC 角色名

CNB_BUILD_STAGE_NAME

当前构建的 stage 名称

CNB_BUILD_JOB_NAME

当前构建的 job 名称

CNB_BUILD_JOB_KEY

当前构建的 job key，同 stage 下唯一

CNB_BUILD_WORKSPACE

自定义 shell 脚本执行的工作空间根目录

CNB_BUILD_FAILED_MSG

流水线构建失败的错误信息，可在 failStages 中使用

CNB_BUILD_FAILED_STAGE_NAME

流水线构建失败的 stage 的名称，可在 failStages 中使用

CNB_PIPELINE_NAME

当前 pipeline 的 name，没声明时为空

CNB_PIPELINE_KEY

当前 pipeline 的索引 key，例如 pipeline-0

CNB_PIPELINE_ID

当前 pipeline 的 id，全局唯一字符串

CNB_PIPELINE_DOCKER_IMAGE

当前 pipeline 所使用的 docker image，如：alpine:latest

CNB_PIPELINE_STATUS

当前流水线的构建状态，可在 endStages 中查看，其可能的值包括：

success：表示流水线构建成功完成。
error：表示流水线构建过程中发生了错误。
cancel：表示流水线构建被取消。

CNB_PIPELINE_MAX_RUN_TIME

流水线最大运行时间，单位为毫秒

CNB_RUNNER_IP

当前 pipeline 所在 Runner 的 ip

CNB_CPUS

当前构建流水线可以使用的最大 CPU 核数

CNB_MEMORY

当前构建流水线可以使用的最大 内存 大小，单位为 GiB

CNB_IS_RETRY

当前构建是否由 rebuild 触发

HUSKY_SKIP_INSTALL

兼容 ci 环境下 husky

合并类变量

CNB_PULL_REQUEST

对于由 pull_request、pull_request.update、pull_request.target 触发的构建，值为 true
否则值为 false

CNB_PULL_REQUEST_LIKE

对于由 合并类事件 触发的构建，值为 true
否则值为 false

CNB_PULL_REQUEST_PROPOSER

对于由 合并类事件 触发的构建，值为提出 PR 者名称
否则值为空字符串

CNB_PULL_REQUEST_TITLE

对于由 合并类事件 触发的构建，值为提 PR 时候填写的标题
否则值为空字符串

CNB_PULL_REQUEST_BRANCH

对于由 合并类事件 触发的构建，值为发起 PR 的源分支名称
否则值为空字符串

CNB_PULL_REQUEST_SHA

对于由 合并类事件 触发的构建，值为当前 PR 源分支最新的提交 sha
否则值为空字符串

CNB_PULL_REQUEST_TARGET_SHA

对于由 合并类事件 触发的构建，值为当前 PR 目标分支最新的提交 sha
否则值为空字符串

CNB_PULL_REQUEST_MERGE_SHA

对于由 pull_request.merged 事件触发的构建，值为当前 PR 合并后的 sha
对于由 pull_request、pull_request.update、pull_request.target、pull_request.mergeable、pull_request.comment 触发的构建，值为当前 PR 预合并后的 sha
否则值为空字符串