Variables 变量 | Drone CI 中文文档

下列变量可用于 Starlark 和 Jsonnet 模板。

Build 构建变量

必须以 build. 为前缀。

Jsonnet 的使用示例：

1
2


local event = std.extVar("build.event");
local action = std.extVar("build.action");

Starlark 的使用示例：

1
2
3
4


{
 "event": ctx.build.event,
 "action": ctx.build.action
}

变量名	描述
event	提供触发流水线执行的事件
action	提供触发流水线执行的操作行为。使用此值来区分 Pull Request 被打开和同步
environment	提供运行构建的目标部署环境
link	提供源控制管理系统中 Git 提交或对象的链接
branch	提供推送或 Pull Request 的目标分支。对于标签事件，此值可能为空
source	为 Pull Request 提供源分支。对于某些源控制管理供应商，此值可能为空
before	提供应用补丁前的 Git Commit SHA。该值可与提交后的 SHA 结合使用，以创建一个 Diff
after	提供应用补丁后的 Git Commit SHA。这可以与 Before Commit SHA 一起使用，以创建一个 Diff
target	提供推送或 Pull Request 的目标分支。对于标签事件，此值可能为空
ref	提供推送或 Pull Request 的目标分支。对于标签事件，此值可能为空
commit	提供应用补丁后的 Git Commit SHA。这个值可以和提交前的 SHA 一起使用，以创建一个 Diff
title	提供提交的标题。信息的第一行全文
message	提供当前运行的构建的提交信息
source_repo	提供 Pull Request 的源码库名称
author_login	提供当前运行的构建中的提交作者用户名。这是源码控制管理系统的用户名（例如 GitHub 用户名）
author_name	提供当前运行的构建的提交者名称。注意这是一个用户定义的值，可能是空的或不准确的
author_email	提供当前运行的构建的提交电子邮件地址。注意，这是一个用户定义的值，可能是空的或不准确的
author_avatar	为当前运行的构建提供提交者头像。这是源控制管理系统（如 GitHub）的头像
sender	提供事件发送者的登录名

Repo 仓库变量

必须以 repo. 为前缀。

Jsonnet 的使用示例：

1
2


local uid = std.extVar("repo.uid");
local name = std.extVar("repo.name");

Starlark 的使用示例：

1
2
3
4


{
 "uid": ctx.repo.uid,
 "name": ctx.repo.name
}

Yaml 的使用示例：

1

- uid: {{ .repo.uid }}

变量名	描述
uid	提供存储库的 UUID
name	为当前运行的存储库提供完整的存储库名称
namespace	为当前运行的存储库提供存储库命名空间。命名空间是拥有该存储库的源控制管理账户的别名
slug	提供用户或组织和存储库名称
git_http_url	提供用于克隆存储库的 Git+HTTP 网址
git_ssh_url	提供用于克隆存储库的 Git+SSH 网址
link	为当前运行的存储库提供存储库链接
branch	提供当前运行版本的默认存储库分支
config	提供存储库的配置路径
private	提供一个布尔值 (Boolean)，表示存储库是私有还是公共的
visibility	为当前运行的存储库提供存储库的可见性级别
active	提供一个布尔值 (Boolean)，指示存储库是否处于活动状态
trusted	提供一个布尔值 (Boolean)，表示存储库是否被信任
protected	提供一个布尔值 (Boolean)，表示存储库是否被保护
ignore_forks	提供了一个布尔标志，表示是否忽略分叉 (Forks)
ignore_pull_requests	提供了一个布尔值 (Boolean)，表示是否忽略 Pull Request