默认环境变量

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

下文 合并类事件 包含以下六种：

pull_request
pull_request.target
pull_request.approved
pull_request.changes_requested
pull_request.mergeable
pull_request.merged

了解更多事件。

基础变量
提交类变量
仓库类变量
构建类变量
合并类变量
远程开发类变量
- CNB_VSCODE_WEB_URL
Issue类变量

# CI

true

# CNB

true

# 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 的链接
对于由 push、branch.create、tag_push 触发的构建，值为最新 Commit 的链接
否则值为空字符串

# CNB_BRANCH

对于由 push 、branch.create、branch.delete 触发的构建，值为当前的分支名
对于由 合并类事件 触发的构建，值为目标分支的分支名
对于由 tag_push 触发的构建，值为 tag 名
对于由 自定义事件 触发的构建，值为对应的分支名称
对于由 crontab 触发的构建，值为对应的分支名称

# CNB_BRANCH_SHA

对于 branch.delete 触发的构建，为空字符串
其他情况为 CNB_BRANCH 最近一次提交的 sha

# CNB_TOKEN_USER_NAME

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

# CNB_TOKEN

用户令牌，可用于代码提交、API 调用等

对于 pull_request 事件，权限有：

repo-code:r
repo-pr:r
repo-issue:r
repo-notes:rw
repo-contents:r
repo-registry:r
repo-commit-status:rw
account-profile:r

对于非 pull_request 事件，权限有：

repo-code:rw
repo-pr:rw
repo-issue:rw
repo-notes:rw
repo-contents:rw
repo-registry:rw
repo-commit-status:rw
repo-cnb-trigger:rw
repo-cnb-history:r
repo-cnb-detail:r
repo-basic-info:r
repo-manage:r
account-profile:r
group-resource:r

权限含义参考页面 个人设置 页面的 访问令牌

# CNB_TOKEN_FOR_AI

用户令牌，在 合并类事件 中由 AI 使用

权限有：

repo-notes:rw

权限含义参考页面 个人设置 页面的 访问令牌

# CNB_IS_CRONEVENT

是否是定时任务事件

# CNB_DOCKER_REGISTRY

制品库 Docker 源地址

# CNB_HELM_REGISTRY

制品库 Helm 源地址

# CNB_BEFORE_SHA

对于由 push 触发的构建，值为 push 前最近一次提交的 sha。对于 branch.create 引起的 push，值为 '0000000000000000000000000000000000000000'

# CNB_COMMIT

构建时对应的代码 sha

对于 push、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，代码尚未真正合并，取源分支最后一次提交的 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_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_REPO_SLUG

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

# CNB_REPO_SLUG_LOWERCASE

目标仓库路径小写格式

# CNB_REPO_NAME

目标仓库名称

# CNB_REPO_ID

目标仓库的 id

# CNB_REPO_URL_HTTPS

目标仓库仓库 https 地址

# CNB_BUILD_ID

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

# CNB_BUILD_WEB_URL

当前构建的日志地址

# CNB_BUILD_START_TIME

当前构建的开始时间，UTC格式，示例 Tue Oct 19 2021 17:09:14 GMT+0800

# CNB_BUILD_USER

当前构建的触发者名称

# CNB_BUILD_USER_ID

当前构建的触发者 id

# 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_RUNNER_IP

当前 pipeline 所在 Runner 的 ip

# CNB_CPUS

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

# CNB_PULL_REQUEST

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

# CNB_PULL_REQUEST_LIKE

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

# CNB_PULL_REQUEST_PROPOSER

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

# CNB_PULL_REQUEST_TITLE

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

# CNB_PULL_REQUEST_DESC

对于由 合并类事件 触发的构建，值为提 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.target 、pull_request.mergeable 触发的构建，值为当前 PR 预合并后的 sha
否则值为空字符串

# CNB_PULL_REQUEST_SLUG

对于由 合并类事件 触发的构建，值为源仓库的仓库 slug，如 group_name/repo_name
否则值为空字符串

# CNB_PULL_REQUEST_ACTION

对于由 合并类事件 触发的构建，可能的值有：

created: 新建 PR
code_update: 源分支 push
status_update: 评审通过或 CI 状态变更时 PR 变成可合并否则值为空字符串

# CNB_PULL_REQUEST_ID

对于由 合并类事件 触发的构建，值为当前或者关联 PR 的全局唯一 id
否则值为空字符串

# CNB_PULL_REQUEST_IID

对于由 合并类事件 触发的构建，值为当前或者关联 PR 在仓库中的编号 iid
否则值为空字符串

# CNB_PULL_REQUEST_REVIEWERS

对于由 合并类事件 触发的构建，值为评审人列表，多个以 , 分隔
否则值为空字符串

# CNB_PULL_REQUEST_REVIEW_STATE

对于由 合并类事件 触发的构建

有评审者且有人通过评审，值为approve
有评审者但无人通过评审，值为unapprove
否则值为空字符串

# CNB_REVIEW_REVIEWED_BY

对于由 合并类事件 触发的构建，值为同意评审的评审人列表，多个以 , 分隔
否则值为空字符串

# CNB_REVIEW_LAST_REVIEWED_BY

对于由 合并类事件 触发的构建，值为最后一个同意评审的评审人
否则值为空字符串

# CNB_IS_NEW_BRANCH

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

# CNB_IS_NEW_BRANCH_WITH_UPDATE

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

# CNB_IS_RETRY

当前构建是否由 rebuild 触发

# HUSKY_SKIP_INSTALL

兼容 ci 环境下 husky

# CNB_VSCODE_WEB_URL

VSCode 远程开发地址,仅声明了 services : vscode 时存在

# CNB_ISSUE_ID

对于issue.*触发的构建，值为 Issue 全局唯一 ID
否则值为空字符串

# CNB_ISSUE_IID

对于issue.*触发的构建，值为 Issue 在仓库中的编号 iid
否则值为空字符串

# CNB_ISSUE_TITLE

对于issue.*触发的构建，值为 Issue 的 title
否则值为空字符串

# CNB_ISSUE_DESCRIPTION

对于issue.*触发的构建，值为 Issue 的 description
否则值为空字符串

# CNB_ISSUE_OWNER

对于issue.*触发的构建，值为 Issue 作者用户名
否则值为空字符串

# CNB_ISSUE_STATE

对于issue.*触发的构建，值为 Issue 状态：open、closed
否则值为空字符串