云原生构建 内置了一些默认环境变量。这些变量只读不可写，即使在构建过程中尝试覆盖，也不会生效。

下文中的 合并类事件 包含以下几种：

• pull_request
• pull_request.update
• pull_request.target
• pull_request.approved
• pull_request.changes_requested
• pull_request.mergeable
• pull_request.merged
• pull_request.comment

了解更多 触发事件。

基础变量

变量概览

变量名	说明
CI	CI 标识，值为 true
CNB	CNB 标识，值为 true
CNB_WEB_PROTOCOL	Web 使用的协议
CNB_WEB_HOST	Web 使用的 HOST
CNB_WEB_ENDPOINT	Web 完整地址
CNB_API_ENDPOINT	API 完整地址
CNB_GROUP_SLUG	仓库所属组织路径
CNB_GROUP_SLUG_LOWERCASE	组织路径小写格式
CNB_EVENT	触发构建的事件名称
CNB_EVENT_URL	事件相关链接
CNB_BRANCH	分支名或 Tag 名
CNB_BRANCH_SHA	分支最近提交的 SHA
CNB_DEFAULT_BRANCH	仓库默认分支
CNB_TOKEN_USER_NAME	临时令牌对应的用户名
CNB_TOKEN	流水线运行期临时令牌
TWINE_USERNAME	PyPI 制品库用户名
TWINE_PASSWORD	PyPI 制品库密码
CNB_TOKEN_FOR_AI	AI 身份令牌
CNB_IS_CRONEVENT	是否为定时任务事件
CNB_DOCKER_REGISTRY	制品库 Docker 源地址
CNB_DOCKER_MODEL_REGISTRY	制品库 Docker Model 源地址
CNB_HELM_REGISTRY	制品库 Helm 源地址
CNB_HAS_LFS_FILES	是否存在 LFS 文件

CI

值为 true,用于标识当前环境为 CI 环境。

CNB

值为 true,用于标识当前环境为 CNB 构建环境。

CNB_WEB_PROTOCOL

当前 Web 使用的协议,取值为 http 或 https。

CNB_WEB_HOST

当前 Web 使用的 HOST。

CNB_WEB_ENDPOINT

当前 Web 使用的完整地址,包含协议、HOST、路径(如有)。

CNB_API_ENDPOINT

当前 API 完整地址,包含协议、HOST、路径(如有)。

可与 CNB_TOKEN 配合在 CI 中调用 API 接口。

CNB_GROUP_SLUG

仓库所属组织路径。

CNB_GROUP_SLUG_LOWERCASE

仓库所属组织路径的小写格式。

CNB_EVENT

值为触发构建的事件名称。

事件类型参见事件。

CNB_EVENT_URL

事件相关链接,取值规则如下:

触发事件	变量值
合并类事件	PR 的链接
Issue 类事件	Issue 的链接
其他事件	CNB_COMMIT 的链接

CNB_BRANCH

分支名或 Tag 名,取值规则如下:

触发事件	变量值
合并类事件	目标分支名
Tag类事件	Tag 名
其他事件	对应的分支名称

CNB_BRANCH_SHA

分支最近一次提交的 SHA,取值规则如下:

触发事件	变量值
branch.delete	无值
其他事件	CNB_BRANCH 最近一次提交的 SHA

CNB_DEFAULT_BRANCH

仓库默认分支。

CNB_TOKEN_USER_NAME

用户临时令牌对应的用户名，固定为 cnb。

CNB_TOKEN

用户在流水线运行期间使用的临时令牌,流水线结束后会自动销毁。该令牌可用于代码和制品的拉取、推送以及 API 调用。

权限分配

权限分配取决于触发流水线的事件类型，主要可分为以下三类：

• 开启工作模式的 NPC 事件
• 未开启工作模式的 NPC 事件或其他不可信事件（参考 不可信事件）
• 其他可信事件

开启工作模式的 NPC 事件：

权限项	说明
repo-code:rw	代码读写
repo-pr:rw	PR 读写
repo-issue:rw	Issue 读写
repo-notes:rw	评论读写
repo-contents:rw	内容读写
repo-basic-info:r	基本信息只读
account-profile:r	用户信息只读
account-engage:r	用户关注的仓库、关注者只读
registry-package:rw	制品库读写
repo-cnb-trigger:rw	触发器读写
repo-cnb-history:r	构建历史只读
repo-cnb-detail:r	构建详情只读

未开启工作模式的 NPC 事件或其他不可信事件：

权限项	说明
repo-code:r	代码只读
repo-pr:r	PR 只读
repo-issue:r	Issue 只读
repo-notes:rw	评论读写
repo-contents:r	内容只读
registry-package:r	制品库只读
account-profile:r	用户信息只读

其他可信事件：

权限项	说明
repo-code:rw	代码读写
repo-pr:rw	PR 读写
repo-issue:rw	Issue 读写
repo-notes:rw	评论读写
repo-contents:rw	内容读写
registry-package:rw	制品库读写
repo-cnb-trigger:rw	触发器读写
repo-cnb-history:r	构建历史只读
repo-cnb-detail:r	构建详情只读
repo-basic-info:r	基本信息,只读
repo-manage:r	仓库管理只读
account-profile:r	用户信息只读
account-engage:r	用户关注的仓库、关注者只读
group-resource:r	组织资源只读

权限说明

具体权限的含义可参考个人设置页面中的访问令牌部分。

安全限制

• 对于公开仓库的流水线，该令牌的权限会被限制为仅公开仓库/制品库。
• 对于 Fork 后仓库的流水线，该令牌的权限会被限制在当前仓库。
• 对于非跨仓 PR 场景下的 NPC 事件，该令牌的权限会被限制在当前仓库。

TWINE_USERNAME

PyPI 制品库用户名,同 CNB_TOKEN_USER_NAME。

TWINE_PASSWORD

PyPI 制品库密码,同 CNB_TOKEN。

CNB_TOKEN_FOR_AI

用于标识调用者为 AI 身份的用户令牌，其权限与作用范围与 CNB_TOKEN 完全一致。

仅支持以下事件类型，超出范围调用无效：

• 合并类事件：如 PR 、合并等事件
• Issue 生命周期事件：issue.open（创建）、issue.close（关闭）

使用场景示例：

在合并请求（PR）中发表 AI 生成的评论时，可通过该令牌调用发表评论的 OpenAPI 接口。 调用成功后，页面会显示 AI 标记，明确该评论由 AI 生成。

CNB_IS_CRONEVENT

是否为定时任务事件。

CNB_DOCKER_REGISTRY

制品库 Docker 源地址。

CNB_DOCKER_MODEL_REGISTRY

制品库 Docker model 源地址。

CNB_HELM_REGISTRY

制品库 Helm 源地址。

CNB_HAS_LFS_FILES

是否有 LFS 文件。

提示

若仓库清空了 LFS 文件，在 Git GC 前该变量仍会为 true。

提交类变量

提交类变量概览

变量名	说明
CNB_BEFORE_SHA	分支推送前最近一次提交的 SHA
CNB_COMMIT	构建对应的代码 SHA
CNB_COMMIT_SHORT	CNB_COMMIT 前 8 位字符
CNB_COMMIT_MESSAGE	提交信息
CNB_COMMIT_MESSAGE_TITLE	提交信息标题
CNB_COMMITTER	提交者
CNB_COMMITTER_EMAIL	提交者邮箱
CNB_NEW_COMMITS_COUNT	新增提交数量
CNB_IS_TAG	是否为 Tag 构建
CNB_TAG_MESSAGE	Tag 消息
CNB_TAG_RELEASE_TITLE	Release 标题
CNB_TAG_RELEASE_DESC	Release 描述
CNB_TAG_IS_RELEASE	Tag 是否有对应 Release
CNB_TAG_IS_PRE_RELEASE	是否为预发布 Release
CNB_IS_NEW_BRANCH	是否为新创建的分支
CNB_IS_NEW_BRANCH_WITH_UPDATE	是否为新分支且带新提交

CNB_BEFORE_SHA

分支推送前远端仓库该分支最近一次提交的 SHA。

取值规则:

触发事件	变量值
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.*、NPC 事件	主分支最后一次提交的 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

提示

对于 pull_request 等事件，代码尚未真正合并，因此这里取的是源分支最后一次提交的 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 的构建,值为 true。

CNB_TAG_MESSAGE

Tag 消息。

CNB_TAG_RELEASE_TITLE

Release 标题。

CNB_TAG_RELEASE_DESC

Release 描述。

CNB_TAG_IS_RELEASE

Tag 是否存在对应的 Release。

取值规则:

条件	变量值
分支为 Tag 且存在对应的 Release	true
其他情况	false

CNB_TAG_IS_PRE_RELEASE

是否为预发布 Release。

取值规则:

条件	变量值
分支为 Tag,存在对应的 Release,且为预发布	true
其他情况	false

CNB_IS_NEW_BRANCH

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

CNB_IS_NEW_BRANCH_WITH_UPDATE

当前分支是否属于一个新创建的分支,且带有新提交,默认为 false。

仓库类变量

仓库类变量概览

变量名	说明
CNB_REPO_SLUG	仓库路径
CNB_REPO_SLUG_LOWERCASE	仓库路径小写格式
CNB_REPO_NAME	仓库名称
CNB_REPO_NAME_LOWERCASE	仓库名称小写格式
CNB_REPO_ID	仓库 ID
CNB_REPO_URL_HTTPS	仓库 HTTPS 地址

CNB_REPO_SLUG

目标仓库路径,格式为 group_slug/repo_name 或 group_slug/sub_group_slug/.../repo_name。

CNB_REPO_SLUG_LOWERCASE

目标仓库路径的小写格式。

CNB_REPO_NAME

目标仓库名称。

CNB_REPO_NAME_LOWERCASE

目标仓库名称的小写格式。

CNB_REPO_ID

目标仓库的 ID。

CNB_REPO_URL_HTTPS

目标仓库的 HTTPS 地址。

CNB_FORK_FROM_REPO_SLUG

Fork 仓库的源仓库路径。

构建类变量

构建类变量概览

变量名	说明
CNB_BUILD_ID	构建流水号
CNB_BUILD_WEB_URL	构建日志地址
CNB_BUILD_START_TIME	构建开始时间
CNB_BUILD_USER	触发者用户名
CNB_BUILD_USER_NICKNAME	触发者昵称
CNB_BUILD_USER_EMAIL	触发者邮箱
CNB_BUILD_USER_ID	触发者 ID
CNB_BUILD_USER_NPC_SLUG	NPC 所属仓库路径
CNB_BUILD_USER_NPC_NAME	NPC 角色名
CNB_BUILD_STAGE_NAME	Stage 名称
CNB_BUILD_JOB_NAME	Job 名称
CNB_BUILD_JOB_KEY	Job Key
CNB_BUILD_WORKSPACE	工作空间根目录
CNB_BUILD_FAILED_MSG	构建失败错误信息
CNB_BUILD_FAILED_STAGE_NAME	失败的 Stage 名称
CNB_PIPELINE_NAME	Pipeline 名称
CNB_PIPELINE_KEY	Pipeline Key
CNB_PIPELINE_ID	Pipeline ID
CNB_PIPELINE_DOCKER_IMAGE	Pipeline Docker 镜像
CNB_PIPELINE_STATUS	Pipeline 构建状态
CNB_PIPELINE_MAX_RUN_TIME	流水线最大运行时间
CNB_RUNNER_IP	Runner IP
CNB_CPUS	可用 CPU 核数
CNB_MEMORY	可用内存大小
CNB_IS_RETRY	是否由 rebuild 触发
HUSKY_SKIP_INSTALL	Husky 兼容标识

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 的名称,没声明时为空。

CNB_PIPELINE_KEY

当前 Pipeline 的索引 Key,例如 pipeline-0。

CNB_PIPELINE_ID

当前 Pipeline 的 ID,全局唯一字符串。

CNB_PIPELINE_DOCKER_IMAGE

当前 Pipeline 所使用的 Docker 镜像,如 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	是否为 PR 触发
CNB_PULL_REQUEST_LIKE	是否为合并类事件触发
CNB_PULL_REQUEST_PROPOSER	PR 提出者
CNB_PULL_REQUEST_TITLE	PR 标题
CNB_PULL_REQUEST_DESCRIPTION	PR 描述
CNB_PULL_REQUEST_BRANCH	PR 源分支名称
CNB_PULL_REQUEST_SHA	PR 源分支最新 SHA
CNB_PULL_REQUEST_TARGET_SHA	PR 目标分支最新 SHA
CNB_PULL_REQUEST_MERGE_SHA	PR 合并后 SHA
CNB_PULL_REQUEST_SLUG	源仓库 Slug
CNB_PULL_REQUEST_ACTION	PR 操作类型
CNB_PULL_REQUEST_ID	PR 全局唯一 ID
CNB_PULL_REQUEST_IID	PR 仓库编号
CNB_PULL_REQUEST_REVIEWERS	评审人列表
CNB_PULL_REQUEST_REVIEW_STATE	评审状态
CNB_REVIEW_REVIEWED_BY	同意评审人列表
CNB_REVIEW_LAST_REVIEWED_BY	最后同意评审人
CNB_PULL_REQUEST_IS_WIP	PR 是否为 WIP

CNB_PULL_REQUEST

是否为 PR 触发。

取值规则:

触发事件	变量值
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_DESCRIPTION

PR 描述。

CNB_PULL_REQUEST_BRANCH

PR 源分支名称。

CNB_PULL_REQUEST_SHA

PR 源分支最新提交的 SHA。

CNB_PULL_REQUEST_TARGET_SHA

PR 目标分支最新提交的 SHA。

CNB_PULL_REQUEST_MERGE_SHA

PR 合并后的 SHA。

取值规则:

触发事件	变量值
pull_request.merged	PR 合并后的 SHA
pull_request、pull_request.update、pull_request.target、pull_request.mergeable、pull_request.comment	PR 预合并后的 SHA
其他事件	无值

CNB_PULL_REQUEST_SLUG

合并类事件,源仓库的仓库路径,格式为 group_slug/repo_name 或 group_slug/sub_group_slug/.../repo_name。

CNB_PULL_REQUEST_ACTION

PR 操作类型。

可能的值:

值	说明
opened	新建 PR
edited	PR 编辑
synchronize	源分支 push
submitted	评审
ready_for_merge	评审通过或 CI 状态变更时 PR 变成可合并

CNB_PULL_REQUEST_ID

PR 的全局唯一 ID。

CNB_PULL_REQUEST_IID

PR 在仓库中的编号 IID。

CNB_PULL_REQUEST_REVIEWERS

PR 评审人列表,多个以 , 分隔。

CNB_PULL_REQUEST_REVIEW_STATE

PR 评审状态。

取值规则:

条件	变量值
有评审者且有人通过评审	approve
有评审者但无人通过评审	unapprove
其他情况	无值

CNB_REVIEW_REVIEWED_BY

PR 下同意评审的评审人列表,多个以 , 分隔。

CNB_REVIEW_LAST_REVIEWED_BY

PR 下最后一个同意评审的评审人。

CNB_PULL_REQUEST_IS_WIP

PR 是否被设置为 WIP。

取值规则:

触发事件	变量值
合并类事件	true 或 false
其他事件	无值

云原生开发类变量

云原生开发类变量概览

变量名	说明
CNB_VSCODE_WEB_URL	云原生开发地址
CNB_VSCODE_MAX_RUN_TIME	云原生开发最大运行时间

CNB_VSCODE_WEB_URL

云原生开发地址,仅声明了 services: vscode 时存在。

CNB_VSCODE_MAX_RUN_TIME

云原生开发环境最大运行时间,单位为毫秒,仅声明了 services: vscode 时存在。

Issue 类变量

Issue 类变量概览

变量名	说明
CNB_ISSUE_ID	Issue 全局唯一 ID
CNB_ISSUE_IID	Issue 仓库编号
CNB_ISSUE_TITLE	Issue 标题
CNB_ISSUE_DESCRIPTION	Issue 描述
CNB_ISSUE_OWNER	Issue 作者
CNB_ISSUE_STATE	Issue 状态
CNB_ISSUE_IS_RESOLVED	Issue 是否已解决
CNB_ISSUE_ASSIGNEES	Issue 处理人列表
CNB_ISSUE_LABELS	Issue 标签列表
CNB_ISSUE_PRIORITY	Issue 优先级

CNB_ISSUE_ID

Issue 全局唯一 ID。

CNB_ISSUE_IID

Issue 在仓库中的编号 IID。

CNB_ISSUE_TITLE

Issue 标题。

CNB_ISSUE_DESCRIPTION

Issue 描述。

CNB_ISSUE_OWNER

Issue 作者用户名。

CNB_ISSUE_STATE

Issue 状态。

取值规则:

触发事件	变量值
issue.*	open 或 closed
其他事件	空字符串

CNB_ISSUE_IS_RESOLVED

Issue 是否被解决。

取值规则:

触发事件	变量值
issue.*	true 或 false
其他事件	空字符串

CNB_ISSUE_ASSIGNEES

Issue 处理人用户名列表,多个以 , 分隔。

CNB_ISSUE_LABELS

Issue 标签列表,多个以 , 分隔。

CNB_ISSUE_PRIORITY

Issue 优先级。

评论类变量

评论类变量概览

变量名	说明
CNB_COMMENT_ID	评论全局唯一 ID
CNB_COMMENT_BODY	评论内容
CNB_COMMENT_TYPE	评论类型
CNB_COMMENT_FILE_PATH	评论所在文件
CNB_COMMENT_RANGE	评论所在代码行
CNB_REVIEW_ID	评审 ID
CNB_REVIEW_DESCRIPTION	评审描述

CNB_COMMENT_ID

评论全局唯一 ID。

CNB_COMMENT_BODY

评论内容。

CNB_COMMENT_TYPE

评论类型。

取值规则:

评论类型	变量值
PR 代码评审评论	diff_note
PR 非代码评审评论以及 Issue 评论	note
其他情况	无值

CNB_COMMENT_FILE_PATH

PR 代码评审，评论所在文件。

CNB_COMMENT_RANGE

PR 代码评审，评论所在代码行，如 L12(单行) 或 L13-L16(多行)。

CNB_REVIEW_ID

PR 代码评审 ID。

CNB_REVIEW_DESCRIPTION

PR 代码评审描述。

NPC 类变量

NPC 类变量概览

变量名	说明
CNB_NPC_SLUG	NPC 所属仓库路径
CNB_NPC_SLUG_LOWERCASE	NPC 所属仓库路径（小写格式）
CNB_NPC_NAME	NPC 角色名
CNB_NPC_SHA	NPC 仓库默认分支最新 SHA
CNB_NPC_PROMPT	NPC 角色提示词
CNB_NPC_SLOGAN	NPC 角色口号
CNB_NPC_AVATAR	NPC 角色头像
CNB_NPC_ENABLE_THINKING	NPC 是否开启思考
CNB_NPC_ENABLE_WORKMODE	NPC 是否开启工作模式
CNB_NPC_TRIGGER_CONTENT	触发 NPC 的内容

CNB_NPC_SLUG

NPC 所属仓库路径。

若为系统 NPC 则无值。

CNB_NPC_SLUG_LOWERCASE

NPC 所属仓库路径（小写格式）。

若为系统 NPC 则无值。

CNB_NPC_NAME

NPC 角色名。

CNB_NPC_SHA

NPC 所属仓库默认分支最新提交的 SHA。

若为系统 NPC 则无值。

CNB_NPC_PROMPT

NPC 角色提示词。

CNB_NPC_SLOGAN

NPC 角色口号。

CNB_NPC_AVATAR

NPC 角色头像地址。

若为系统 NPC 则无值。

CNB_NPC_ENABLE_THINKING

NPC 角色是否开启思考。

若为系统 NPC 则无值。

CNB_NPC_ENABLE_WORKMODE

NPC 角色是否开启工作模式。工作模式下 NPC 拥有更高权限，详细说明可参考 CNB_TOKEN。

若为系统 NPC 则无值。

CNB_NPC_TRIGGER_CONTENT

触发 NPC 的场景 有很多。 在不同场景下，触发 NPC 的内容对应不同的环境变量。为了减少理解和处理上的遗漏，处理 NPC 事件时可优先使用该变量。

触发场景	等效环境变量
创建 Issue 的描述	CNB_ISSUE_DESCRIPTION
Issue 评论	CNB_COMMENT_BODY
创建 PR 的描述	CNB_PULL_REQUEST_DESCRIPTION
PR 评审	CNB_REVIEW_DESCRIPTION
PR 评论	CNB_COMMENT_BODY
PR 评审评论	CNB_COMMENT_BODY

上一页环境变量

下一页超时策略