drone内置变量

odliken • • Java, k8s
内容纲要

参考|雄蜂 (drone.io)

管道可用的环境变量的索引。注意，这些环境变量会自动注入到管道步骤中，除了步骤名称、步骤编号以及存储状态和时间戳的参数外，大多数环境变量都可以替换。

CI

将当前环境标识为持续集成环境。

CI=true

DRONE

将当前环境标识为“无人机持续集成”环境。

DRONE=true

DRONE_BRANCH

为推或拉请求提供目标分支。对于标记事件，此值可能为空。

DRONE_BRANCH=master

DRONE_BUILD_ACTION

提供触发管道执行的操作。使用这个值来区分pull request是打开的还是同步的。

DRONE_BUILD_ACTION=sync
DRONE_BUILD_ACTION=open

DRONE_BUILD_CREATED

提供系统创建生成对象时的unix时间戳。

DRONE_BUILD_CREATED=915148800

DRONE_BUILD_EVENT

提供触发管道执行的事件。

DRONE_BUILD_EVENT=push
DRONE_BUILD_EVENT=pull_request
DRONE_BUILD_EVENT=promote
DRONE_BUILD_EVENT=rollback
DRONE_BUILD_EVENT=tag
DRONE_BUILD_EVENT=cron
DRONE_BUILD_EVENT=custom

DRONE_BUILD_FINISHED

提供生成完成时的unix时间戳。正在运行的构建不能有完成时间戳，因此，系统总是将此值设置为当前时间戳。

DRONE_BUILD_FINISHED=915148800

DRONE_BUILD_LINK

提供无人机构建结果的深度链接。请注意，此变量不能用于替换或模板注入。

DRONE_BUILD_LINK=https://drone.company.com/octocat/hello-world/42

DRONE_BUILD_NUMBER

为当前运行的生成提供生成编号。请注意，此变量不能用于替换或模板注入。

DRONE_BUILD_NUMBER=42

DRONE_BUILD_PARENT

为当前运行的生成提供父生成版本号。父版本号是从正在提升的现有版本填充的。

DRONE_BUILD_PARENT=42

DRONE_BUILD_STARTED

提供系统启动构建时的unix时间戳。

DRONE_BUILD_STARTED=915148800

DRONE_BUILD_STATUS

提供当前正在运行的生成的状态。如果构建管道和构建步骤正在通过，则构建状态默认为成功。

DRONE_BUILD_STATUS=success
DRONE_BUILD_STATUS=failure

请注意，这是时间点快照。当多个管道并行运行时，此值可能不能准确地反映整体构建状态。

DRONE_CALVER

如果git标签是一个有效的日历版本字符串，系统会提供一个日历版本字符串。

DRONE_CALVER=19.1.0-beta.20190318

日历版本字符串也有以下格式:

DRONE_CALVER_SHORT=19.1.0
DRONE_CALVER_MAJOR_MINOR=19.1
DRONE_CALVER_MAJOR=19
DRONE_CALVER_MINOR=1
DRONE_CALVER_MICRO=0
DRONE_CALVER_MODIFIER=beta.20190318

DRONE_COMMIT

为当前运行的构建提供git提交sha。

DRONE_COMMIT=bcdd4bf0245c82c060407b3b24b9b87301d15ac1

DRONE_COMMIT_AFTER

提供补丁应用后的git提交sha。这可以与提交sha之前的命令一起使用，以创建一个差异。

DRONE_COMMIT_AFTER=bcdd4bf0245c82c060407b3b24b9b87301d15ac1

DRONE_COMMIT_AUTHOR

提供当前正在运行的生成的提交作者用户名。这是源控制管理系统的用户名(例如GitHub用户名)。

DRONE_COMMIT_AUTHOR=octocat

DRONE_COMMIT_AUTHOR_AVATAR

为当前正在运行的构建提供提交作者头像。这是来自源代码控制管理系统(例如GitHub)的化身。

DRONE_COMMIT_AUTHOR_AVATAR=https://githubusercontent.com/u/...

DRONE_COMMIT_AUTHOR_EMAIL

为当前正在运行的生成提供提交电子邮件地址。注意，这是一个用户定义的值，可能为空或不准确。

DRONE_COMMIT_AUTHOR_EMAIL=octocat@github.com

DRONE_COMMIT_AUTHOR_NAME

提供当前正在运行的生成的提交作者名称。注意，这是一个用户定义的值，可能为空或不准确。

DRONE_COMMIT_AUTHOR_NAME=The Octocat

DRONE_COMMIT_BEFORE

在应用补丁之前提供git提交sha。这可以与提交sha后一起使用来创建一个差异。

DRONE_COMMIT_BEFORE=bcdd4bf0245c82c060407b3b24b9b87301d15ac1

DRONE_COMMIT_BRANCH

为推或拉请求提供目标分支。对于标记事件，此值可能为空。

DRONE_COMMIT_BRANCH=master

DRONE_COMMIT_LINK

提供源代码管理系统中git提交或对象的链接。

DRONE_COMMIT_LINK=https://github.com/octocat/hello-world/pull/42

DRONE_COMMIT_MESSAGE

为当前正在运行的生成提供提交消息。

DRONE_COMMIT_MESSAGE=Updated README.md

DRONE_COMMIT_REF

为当前运行的构建提供git引用。

DRONE_COMMIT_REF=refs/heads/master

标签参考示例:

DRONE_COMMIT_REF=refs/tags/v1.0.0

示例pull request引用(GitHub):

DRONE_COMMIT_REF=refs/pull/42/head

DRONE_COMMIT_SHA

为当前运行的构建提供git提交sha。

DRONE_COMMIT_SHA=bcdd4bf0245c82c060407b3b24b9b87301d15ac1

DRONE_DEPLOY_TO

为正在运行的生成提供目标部署环境。此值仅对升级和回滚管道可用。

DRONE_DEPLOY_TO=production

DRONE_FAILED_STAGES

提供当前正在运行的生成的失败管道阶段的逗号分隔列表。

DRONE_FAILED_STAGES=build,test

请注意，这是时间点快照。当多个管道并行运行时，这个值可能不能准确地反映最新的结果。

DRONE_FAILED_STEPS

提供失败的管道步骤的逗号分隔列表。

DRONE_FAILED_STEPS=backend,frontend

DRONE_GIT_HTTP_URL

提供用于克隆存储库的git+http url。

DRONE_GIT_HTTP_URL=https://github.com/octocat/hello-world.git

DRONE_GIT_SSH_URL

提供用于克隆存储库的git+ssh url。

DRONE_GIT_SSH_URL=git@github.com:octocat/hello-world.git

DRONE_PULL_REQUEST

为当前运行的生成提供拉请求号。如果构建不是一个拉请求，变量为空。

DRONE_PULL_REQUEST=42

DRONE_PULL_REQUEST_TITLE

为当前运行的构建提供拉请求标题。如果构建不是一个拉请求，变量为空。

DRONE_PULL_REQUEST_TITLE="ci: upgrade linters"

DRONE_REMOTE_URL

提供git+https url，用于克隆存储库。这是一个仅为向后兼容性而包含的遗留值。

DRONE_REMOTE_URL=https://github.com/octocat/hello-world.git

DRONE_REPO

提供当前正在运行的版本的完整存储库名称。

DRONE_REPO=octocat/hello-world

DRONE_REPO_BRANCH

为当前正在运行的生成提供默认存储库分支。

DRONE_REPO_BRANCH=master

DRONE_REPO_LINK

提供当前正在运行的生成的存储库链接。

DRONE_REPO_LINK=https://github.com/octocat/hello-world

DRONE_REPO_NAME

提供当前正在运行的生成的存储库名称。

DRONE_REPO_NAME=hello-world
DRONE_REPO=octocat/hello-world

DRONE_REPO_NAMESPACE

为当前运行的生成提供存储库名称空间。名称空间是拥有存储库的源控制管理帐户的别名。

DRONE_REPO_NAMESPACE=octocat
DRONE_REPO=octocat/hello-world

DRONE_REPO_OWNER

为当前运行的生成提供存储库名称空间。名称空间是拥有存储库的源控制管理帐户的别名。

DRONE_REPO_OWNER=octocat
DRONE_REPO=octocat/hello-world

DRONE_REPO_PRIVATE

提供一个布尔标记，指示存储库是私有的还是公共的。

DRONE_REPO_PRIVATE=false

DRONE_REPO_SCM

提供当前正在运行的生成的存储库类型。

DRONE_REPO_SCM=git

所有可能值的列表:

DRONE_REPO_SCM=git
DRONE_REPO_SCM=hg

DRONE_REPO_VISIBILITY

提供当前正在运行的版本的存储库可见性级别。

DRONE_REPO_VISIBILITY=public

所有可能值的列表:

DRONE_REPO_VISIBILITY=public
DRONE_REPO_VISIBILITY=private
DRONE_REPO_VISIBILITY=internal

DRONE_SEMVER

如果git标签是一个有效的语义版本字符串，系统会提供一个semver字符串。

DRONE_SEMVER=1.2.3-alpha.1

semver字符串也有以下格式:

DRONE_SEMVER_SHORT=1.2.3
DRONE_SEMVER_PATCH=3
DRONE_SEMVER_MINOR=2
DRONE_SEMVER_MAJOR=1
DRONE_SEMVER_PRERELEASE=alpha.1

DRONE_SEMVER_BUILD

如果git标记是一个有效的semver字符串，这个变量将根据semver字符串提供构建。

DRONE_SEMVER_BUILD=001
DRONE_SEMVER=1.2.3+001

DRONE_SEMVER_ERROR

如果git标签不是一个有效的semver字符串，这个变量会提供semver解析错误。

DRONE_SEMVER_ERROR=

DRONE_SEMVER_MAJOR

如果git标记是一个有效的semver字符串，这个变量提供了semver字符串的主要版本号。

DRONE_SEMVER_MAJOR=1
DRONE_SEMVER=1.2.3

DRONE_SEMVER_MINOR

如果git标签是一个有效的semver字符串，这个变量提供了semver字符串的次要版本号。

DRONE_SEMVER_MINOR=2
DRONE_SEMVER=1.2.3

DRONE_SEMVER_PATCH

如果git标签是一个有效的semver字符串，这个变量提供了来自semver字符串的补丁。

DRONE_SEMVER_PATCH=3
DRONE_SEMVER=1.2.3

DRONE_SEMVER_PRERELEASE

如果git标签是一个有效的semver字符串，这个变量提供了semver字符串的prelease。

DRONE_SEMVER_PRERELEASE=alpha.1
DRONE_SEMVER=1.2.3-alpha.1

DRONE_SEMVER_SHORT

如果git标签是一个有效的semver字符串，这个变量提供了semver字符串的短版本，其中标签和元数据被截断。

DRONE_SEMVER_SHORT=1.2.3

DRONE_SOURCE_BRANCH

为拉请求提供源分支。对于某些源代码管理提供程序，该值可能为空。

DRONE_SOURCE_BRANCH=feature/develop

这个环境变量可以与目标分支变量一起使用，以获得拉请求库和头部分支。

DRONE_SOURCE_BRANCH=feature/develop
DRONE_TARGET_BRANCH=master

DRONE_STAGE_ARCH

提供当前构建阶段的平台体系结构。

DRONE_STAGE_ARCH=amd64

所有可能值的列表:

DRONE_STAGE_ARCH=386
DRONE_STAGE_ARCH=amd64
DRONE_STAGE_ARCH=arm64
DRONE_STAGE_ARCH=arm

DRONE_STAGE_DEPENDS_ON

为当前管道阶段提供逗号分隔的依赖项列表。

DRONE_STAGE_DEPENDS_ON=backend,frontend

DRONE_STAGE_FINISHED

提供管道完成时的unix时间戳。正在运行的管道不能有完成时间戳，因此，系统总是将该值设置为当前时间戳。

DRONE_STAGE_FINISHED=915148800

DRONE_STAGE_KIND

提供正在执行的资源类型。这个值来自yaml配置文件中的kind属性。

DRONE_STAGE_KIND=pipeline

DRONE_STAGE_MACHINE

提供管道当前正在其上运行的主机的名称。

DRONE_STAGE_MACHINE=ec2-203-0-113-25.compute-1.amazonaws.com

DRONE_STAGE_NAME

提供当前运行的管道阶段的阶段名称。

DRONE_STAGE_NAME=build

DRONE_STAGE_NUMBER

提供当前运行的管道阶段的阶段号。

DRONE_STAGE_NUMBER=1

DRONE_STAGE_OS

为当前构建阶段提供目标操作系统。

DRONE_STAGE_OS=linux

所有可能值的列表:

DRONE_STAGE_OS=darwin
DRONE_STAGE_OS=dragonfly
DRONE_STAGE_OS=freebsd
DRONE_STAGE_OS=linux
DRONE_STAGE_OS=netbsd
DRONE_STAGE_OS=openbsd
DRONE_STAGE_OS=solaris
DRONE_STAGE_OS=windows

DRONE_STAGE_STARTED

提供运行程序启动管道的unix时间戳。

DRONE_STAGE_STARTED=915148800

DRONE_STAGE_STATUS

提供当前运行管道的状态。如果通过了所有管道步骤，则管道状态默认为success。

提供当前运行管道的状态。如果通过了所有管道步骤，则管道状态默认为success。

DRONE_STAGE_TYPE

提供正在执行的资源类型。这个值来自yaml配置文件中的type属性。

DRONE_STAGE_TYPE=docker

DRONE_STAGE_VARIANT

提供当前构建阶段的目标操作体系结构变量。这个变量是可选的，只适用于手臂架构。

DRONE_STAGE_VARIANT=v7

DRONE_STEP_NAME

提供当前正在运行的管道步骤的步骤名称。

DRONE_STEP_NAME=build

DRONE_STEP_NUMBER

提供当前正在运行的管道步骤的步骤号。

DRONE_STEP_NUMBER=1

DRONE_SYSTEM_HOST

提供Drone服务器使用的主机名。这可以与协议结合起来构造服务器url。

DRONE_SYSTEM_HOST=cloud.drone.io

DRONE_SYSTEM_HOSTNAME

提供Drone服务器使用的主机名。这可以与协议结合起来构造服务器url。

DRONE_SYSTEM_HOSTNAME=cloud.drone.io

DRONE_SYSTEM_PROTO

提供无人机服务器使用的协议。这可以与主机名结合起来构造服务器url。

DRONE_SYSTEM_PROTO=https

DRONE_SYSTEM_VERSION

提供无人机服务器的版本信息。

DRONE_SYSTEM_VERSION=1.2.3

DRONE_TAG

为当前运行的生成提供标记。此值仅为标记事件和从标记派生的提升事件填充。

DRONE_TAG=v1.0.0

DRONE_TARGET_BRANCH

为推或拉请求提供目标分支。对于标记事件，此值可能为空。

DRONE_TARGET_BRANCH=master

这个环境变量可以与源分支变量一起使用，以获得拉请求库和头部分支。

DRONE_SOURCE_BRANCH=feature/develop
DRONE_TARGET_BRANCH=master
THE END
分享
二维码
< <上一篇
下一篇>>