简述
下表显示了 GitLab CI/CD 变量的列表。
| 序号 |
变量 |
GitLab |
Runner |
描述 |
| 1 |
CI |
all |
0.4 |
指定作业在 CI 环境中完成。 |
| 2 |
CI_COMMIT_REF_NAME |
9.0 |
all |
定义项目构建的分支或标签名称。 |
| 3 |
CI_COMMIT_REF_SLUG |
9.0 |
all |
它使用小写的$CI_COMMIT_REF_NAME变量，该变量减少到 63 个字节，并且只有 0-9 和 az 替换为 -。 |
| 4 |
CI_COMMIT_SHA |
9.0 |
all |
指定构建项目的提交修订。 |
| 5 |
CI_COMMIT_TAG |
9.0 |
0.5 |
它提交标签名称 |
| 6 |
CI_CONFIG_PATH |
9.4 |
0.5 |
指定 CI 配置文件的路径。（默认路径是.gitlab-ci.yml）。 |
| 7 |
CI_DEBUG_TRACE |
all |
1.7 |
它启用调试跟踪。 |
| 8 |
CI_ENVIRONMENT_NAME |
8.15 |
all |
定义作业的环境名称。 |
| 9 |
CI_ENVIRONMENT_SLUG |
8.15 |
all |
它是一个环境名称，适用于 DNS、URL、Kubernetes 标签等。 |
| 10 |
CI_ENVIRONMENT_URL |
9.3 |
all |
定义作业的环境 URL。 |
| 11 |
CI_JOB_ID |
9.0 |
all |
表示 GitLab CI 当前作业的唯一 ID。 |
| 12 |
CI_JOB_MANUAL |
8.12 |
all |
它指定作业已手动启动。 |
| 13 |
CI_JOB_NAME |
9.0 |
0.5 |
作业名称在.gitlab-ci.yml文件中定义。 |
| 14 |
CI_JOB_STAGE |
9.0 |
0.5 |
阶段名称在.gitlab-ci.yml文件中定义。 |
| 15 |
CI_JOB_TOKEN |
9.0 |
1.2 |
当涉及触发器时，此令牌用于对 GitLab 容器注册表和多项目管道进行身份验证。 |
| 16 |
CI_REPOSITORY_URL |
9.0 |
all |
它指定克隆 Git 存储库的 URL。 |
| 17 |
CI_RUNNER_DESCRIPTION |
8.10 |
0.5 |
它指定了跑步者的描述。 |
| 18 |
CI_RUNNER_ID |
8.10 |
0.5 |
它为正在使用的跑步者提供唯一的 id。 |
| 19 |
CI_RUNNER_TAGS |
8.10 |
0.5 |
它定义了跑步者标签。 |
| 20 |
CI_RUNNER_VERSION |
all |
10.6 |
它指定当前作业的 GitLab 运行器版本。 |
| 21 |
CI_RUNNER_REVISION |
all |
10.6 |
它指定当前作业的 GitLab 版本。 |
| 22 |
CI_PIPELINE_ID |
8.10 |
0.5 |
它提供了当前管道的唯一 ID。 |
| 23 |
CI_PIPELINE_SOURCE |
9.3 |
all |
它指定了如何使用一些选项来触发管道，例如 push、web、trigger、schedule、api、pipeline。 |
| 24 |
CI_PIPELINE_TRIGGERED |
all |
all |
它指定作业被触发。 |
| 25 |
CI_PIPELINE_SOURCE |
10.0 |
all |
它指定了管道的来源，例如推送、Web、触发器、计划、API、外部。 |
| 26 |
CI_PROJECT_DIR |
all |
all |
它定义了运行作业的克隆存储库的完整路径。 |
| 27 |
CI_PROJECT_ID |
all |
all |
它提供了当前项目的唯一 ID。 |
| 28 |
CI_PROJECT_NAME |
8.10 |
0.5 |
它提供了当前项目的名称。 |
| 29 |
CI_PROJECT_PATH |
8.10 |
0.5 |
它提供了项目的名称以及命名空间。 |
| 30 |
CI_PROJECT_URL |
8.10 |
0.5 |
它提供了用于检索项目的 http 地址。 |
| 31 |
CI_PROJECT_VISIBILITY |
10.3 |
all |
它指定项目可见性是内部的、私有的还是公共的。 |
| 32 |
CI_REGISTRY |
8.10 |
0.5 |
仅当容器注册表启用时，它才会返回 GitLab 容器注册表的地址。 |
| 33 |
CI_REGISTRY_IMAGE |
8.10 |
0.5 |
它返回与特定项目相关联的 GitLab 容器注册表的地址，前提是启用了容器注册表。 |
| 34 |
CI_REGISTRY_PASSWORD |
9.0 |
all |
该密码可用于将容器推送到 GitLab 容器注册表。 |
| 35 |
CI_REGISTRY_USER |
9.0 |
all |
用户名可用于将容器推送到 GitLab 容器注册表。 |
| 36 |
CI_SERVER |
all |
all |
它指定作业在 CI 环境中执行。 |
| 37 |
CI_SERVER_NAME |
all |
all |
它提供 CI 服务器名称来协调作业。 |
| 38 |
CI_SERVER_REVISION |
all |
all |
它用于通过使用 GitLab 修订来安排作业。 |
| 39 |
CI_SERVER_VERSION |
all |
all |
它用于通过使用 GitLab 版本来安排作业。 |
| 40 |
CI_SHARED_ENVIRONMENT |
all |
10.1 |
它表示作业在共享环境中执行，如果环境是共享的，则设置为 true。 |
| 41 |
ARTIFACT_DOWNLOAD_ATTEMPTS |
8.15 |
1.9 |
它指定尝试下载运行作业的工件的次数。 |
| 42 |
GET_SOURCES_ATTEMPTS |
8.15 |
1.9 |
它指定尝试让源运行作业的次数。 |
| 43 |
GITLAB_CI |
all |
all |
它指定工作是在 GitLab CI 环境中完成的。 |
| 44 |
GITLAB_USER_ID |
8.12 |
all |
它指定正在运行作业的 GitLab 用户的 ID。 |
| 45 |
GITLAB_USER_EMAIL |
8.12 |
all |
它指定正在运行作业的 GitLab 用户的电子邮件。 |
| 46 |
GITLAB_USER_LOGIN |
10.0 |
all |
它指定正在运行作业的 GitLab 用户的登录用户名。 |
| 47 |
GITLAB_USER_NAME |
10.0 |
all |
它指定正在运行作业的 GitLab 用户的真实姓名。 |
| 48 |
GITLAB_FEATURES |
10.6 |
all |
它提供了 GitLab 实例和计划的许可功能列表。 |
| 49 |
RESTORE_CACHE_ATTEMPTS |
8.15 |
1.9 |
它定义了恢复正在运行的作业的缓存尝试次数。 |
| 50 |
CI_DISPOSABLE_ENVIRONMENT |
all |
10.1 |
它表示作业在一次性环境中执行，如果环境是一次性的，则设置为 true。 |
下表显示了可与 GitLab 9.0 版本一起使用的新变量列表 -
| 序号 |
9.0+ 名称 |
| 1 |
CI_JOB_ID |
| 2 |
CI_COMMIT_SHA |
| 3 |
CI_COMMIT_TAG |
| 4 |
CI_COMMIT_REF_NAME |
| 5 |
CI_COMMIT_REF_SLUG |
| 6 |
CI_JOB_NAME |
| 7 |
CI_JOB_STAGE |
| 8 |
CI_REPOSITORY_URL |
| 9 |
CI_PIPELINE_TRIGGERED |
| 10 |
CI_JOB_MANUAL |
| 11 |
CI_JOB_TOKEN |
