GitLab CI/CD Variables 中文文档

╰半橙微兮° 2021-12-21 03:41 235阅读 0赞

# 官方文档链接(这篇文章也算是翻译自官网文档)： #

# [GitLab CI/CD environment variables][GitLab CI_CD environment variables] #

当GitLab CI 中接受到一个job后，[Runner][]就开始准备构建环境。开始设置预定义的变量(环境变量)和用户自定义的变量。

## variables 的执行顺序 ##

变量可以被重写，并且是按照下面的顺序进行执行：

1.  [Trigger variables][](优先级最高)
2.  [Secret variables][]
3.  YAML-defined [job-level variables][]
4.  YAML-defined [global variables][]
5.  [Deployment variables][]
6.  [Predefined variables][] (优先级最低)

举个例子，如果你定义了私有变量`API_TOKEN=secure`，并且在`.gitlab-ci.yml`中定义了 `API_TOKEN=yaml`，那么私有变量`API_TOKEN`的值将是`secure`，因为secret variables的优先级较高。

## Predefined variables(Environment variables) ##

有部分预定义的环境变量仅仅只能在最小版本的[GitLab Runner][Runner]中使用。请参考下表查看对应的Runner版本要求。

**注意**：从GitLab 9.0 开始，部分变量已经不提倡使用。请查看[9.0 Renaming][]部分来查找他们的替代变量。强烈建议使用新的变量，我们也会在将来的GitLab版本中将他们移除。

<table> 
 <thead> 
 <tr> 
 <th>Variable</th> 
 <th>GitLab</th> 
 <th>Runner</th> 
 <th>Description</th> 
 </tr> 
 </thead> 
 <tbody> 
 <tr> 
 <td>CI</td> 
 <td>all</td> 
 <td>0.4</td> 
 <td>标识该job是在CI环境中执行</td> 
 </tr> 
 <tr> 
 <td>CI_COMMIT_REF_NAME</td> 
 <td>9.0</td> 
 <td>all</td> 
 <td>用于构建项目的分支或tag名称</td> 
 </tr> 
 <tr> 
 <td>CI_COMMIT_REF_SLUG</td> 
 <td>9.0</td> 
 <td>all</td> 
 <td>先将<code>$CI_COMMIT_REF_NAME</code>的值转换成小写，最大不能超过63个字节，然后把除了<code>0-9</code>和<code>a-z</code>的其他字符转换成<code>-</code>。在URLs和域名名称中使用。</td> 
 </tr> 
 <tr> 
 <td>CI_COMMIT_SHA</td> 
 <td>9.0</td> 
 <td>all</td> 
 <td>commit的版本号</td> 
 </tr> 
 <tr> 
 <td>CI_COMMIT_TAG</td> 
 <td>9.0</td> 
 <td>0.5</td> 
 <td>commit的tag名称。只有创建了tags才会出现。</td> 
 </tr> 
 <tr> 
 <td>CI_DEBUG_TRACE</td> 
 <td>9.0</td> 
 <td>1.7</td> 
 <td><a href="https://docs.gitlab.com/ce/ci/variables/README.html#debug-tracing" rel="nofollow">debug tracing</a>开启时才生效</td> 
 </tr> 
 <tr> 
 <td>CI_ENVIRONMENT_NAME</td> 
 <td>8.15</td> 
 <td>all</td> 
 <td>job的环境名称</td> 
 </tr> 
 <tr> 
 <td>CI_ENVIRONMENT_SLUG</td> 
 <td>8.15</td> 
 <td>all</td> 
 <td>环境名称的简化版本，适用于DNS，URLs，Kubernetes labels等</td> 
 </tr> 
 <tr> 
 <td>CI_JOB_ID</td> 
 <td>9.0</td> 
 <td>all</td> 
 <td>GItLab CI内部调用job的一个唯一ID</td> 
 </tr> 
 <tr> 
 <td>CI_JOB_MANUAL</td> 
 <td>8.12</td> 
 <td>all</td> 
 <td>表示job启用的标识</td> 
 </tr> 
 <tr> 
 <td>CI_JOB_NAME</td> 
 <td>9.0</td> 
 <td>0.5</td> 
 <td><code>.gitlab-ci.yml</code>中定义的job的名称</td> 
 </tr> 
 <tr> 
 <td>CI_JOB_STAGE</td> 
 <td>9.0</td> 
 <td>0.5</td> 
 <td><code>.gitlab-ci.yml</code>中定义的stage的名称</td> 
 </tr> 
 <tr> 
 <td>CI_JOB_TOKEN</td> 
 <td>9.0</td> 
 <td>1.2</td> 
 <td>用于同GitLab容器仓库验证的token</td> 
 </tr> 
 <tr> 
 <td>CI_REPOSITORY_URL</td> 
 <td>9.0</td> 
 <td>all</td> 
 <td>git仓库地址，用于克隆</td> 
 </tr> 
 <tr> 
 <td>CI_RUNNER_DESCRIPTION</td> 
 <td>8.10</td> 
 <td>0.5</td> 
 <td>GitLab中存储的Runner描述</td> 
 </tr> 
 <tr> 
 <td>CI_RUNNER_ID</td> 
 <td>8.10</td> 
 <td>0.5</td> 
 <td>Runner所使用的唯一ID</td> 
 </tr> 
 <tr> 
 <td>CI_RUNNER_TAGS</td> 
 <td>8.10</td> 
 <td>0.5</td> 
 <td>Runner定义的tags</td> 
 </tr> 
 <tr> 
 <td>CI_PIPELINE_ID</td> 
 <td>8.10</td> 
 <td>0.5</td> 
 <td>GitLab CI 在内部使用的当前pipeline的唯一ID</td> 
 </tr> 
 <tr> 
 <td>CI_PIPELINE_TRIGGERED</td> 
 <td>all</td> 
 <td>all</td> 
 <td>用于指示该job被触发的标识</td> 
 </tr> 
 <tr> 
 <td>CI_PROJECT_DIR</td> 
 <td>all</td> 
 <td>all</td> 
 <td>仓库克隆的完整地址和job允许的完整地址</td> 
 </tr> 
 <tr> 
 <td>CI_PROJECT_ID</td> 
 <td>all</td> 
 <td>all</td> 
 <td>GitLab CI在内部使用的当前项目的唯一ID</td> 
 </tr> 
 <tr> 
 <td>CI_PROJECT_NAME</td> 
 <td>8.10</td> 
 <td>0.5</td> 
 <td>当前正在构建的项目名称（事实上是项目文件夹名称）</td> 
 </tr> 
 <tr> 
 <td>CI_PROJECT_NAMESPACE</td> 
 <td>8.10</td> 
 <td>0.5</td> 
 <td>当前正在构建的项目命名空间（用户名或者是组名称）</td> 
 </tr> 
 <tr> 
 <td>CI_PROJECT_PATH</td> 
 <td>8.10</td> 
 <td>0.5</td> 
 <td>命名空间加项目名称</td> 
 </tr> 
 <tr> 
 <td>CI_PROJECT_PATH_SLUG</td> 
 <td>9.3</td> 
 <td>all</td> 
 <td><code>$CI_PROJECT_PATH</code>小写字母、除了<code>0-9</code>和<code>a-z</code>的其他字母都替换成<code>-</code>。用于地址和域名名称。</td> 
 </tr> 
 <tr> 
 <td>CI_PROJECT_URL</td> 
 <td>8.10</td> 
 <td>0.5</td> 
 <td>项目的访问地址（http形式）</td> 
 </tr> 
 <tr> 
 <td>CI_REGISTRY</td> 
 <td>8.10</td> 
 <td>0.5</td> 
 <td>如果启用了Container Registry，则返回GitLab的Container Registry的地址</td> 
 </tr> 
 <tr> 
 <td>CI_REGISTRY_IMAGE</td> 
 <td>8.10</td> 
 <td>0.5</td> 
 <td>如果为项目启用了Container Registry，它将返回与特定项目相关联的注册表的地址</td> 
 </tr> 
 <tr> 
 <td>CI_REGISTRY_PASSWORD</td> 
 <td>9.0</td> 
 <td>all</td> 
 <td>用于push containers到GitLab的Container Registry的密码</td> 
 </tr> 
 <tr> 
 <td>CI_REGISTRY_USER</td> 
 <td>9.0</td> 
 <td>all</td> 
 <td>用于push containers到GItLab的Container Registry的用户名</td> 
 </tr> 
 <tr> 
 <td>CI_SERVER</td> 
 <td>all</td> 
 <td>all</td> 
 <td>标记该job是在CI环境中执行</td> 
 </tr> 
 <tr> 
 <td>CI_SERVER_NAME</td> 
 <td>all</td> 
 <td>all</td> 
 <td>用于协调job的CI服务器名称</td> 
 </tr> 
 <tr> 
 <td>CI_SERVER_REVISION</td> 
 <td>all</td> 
 <td>all</td> 
 <td>用于调度job的GitLab修订版</td> 
 </tr> 
 <tr> 
 <td>CI_SERVER_VERSION</td> 
 <td>all</td> 
 <td>all</td> 
 <td>用于调度job的GItLab版本</td> 
 </tr> 
 <tr> 
 <td>ARTIFACT_DOWNLOAD_ATTEMPTS</td> 
 <td>8.15</td> 
 <td>1.9</td> 
 <td>尝试运行下载artifacts的job的次数</td> 
 </tr> 
 <tr> 
 <td>GET_SOURCES_ATTEMPTS</td> 
 <td>8.15</td> 
 <td>1.9</td> 
 <td>尝试运行获取源的job次数</td> 
 </tr> 
 <tr> 
 <td>GITLAB_CI</td> 
 <td>all</td> 
 <td>all</td> 
 <td>用于指示该job是在GItLab CI环境中运行</td> 
 </tr> 
 <tr> 
 <td>GITLAB_USER_ID</td> 
 <td>8.12</td> 
 <td>all</td> 
 <td>开启该job的用户ID</td> 
 </tr> 
 <tr> 
 <td>GITLAB_USER_EMAIL</td> 
 <td>8.12</td> 
 <td>all</td> 
 <td>开启该job的用户邮箱</td> 
 </tr> 
 <tr> 
 <td>RESTORE_CACHE_ATTEMPTS</td> 
 <td>8.15</td> 
 <td>1.9</td> 
 <td>尝试运行存储缓存的job的次数</td> 
 </tr> 
 </tbody> 
</table>

## 9.0 Renaming ##

根据GitLab的命名规则，在9.0以后将从`build`术语转到`job`CI变量中，并且已经被重命名。

<table> 
 <thead> 
 <tr> 
 <th>8.x name</th> 
 <th>9.0+ name</th> 
 </tr> 
 </thead> 
 <tbody> 
 <tr> 
 <td><code>CI_BUILD_ID</code></td> 
 <td><code>CI_JOB_ID</code></td> 
 </tr> 
 <tr> 
 <td><code>CI_BUILD_REF</code></td> 
 <td><code>CI_COMMIT_SHA</code></td> 
 </tr> 
 <tr> 
 <td><code>CI_BUILD_TAG</code></td> 
 <td><code>CI_COMMIT_TAG</code></td> 
 </tr> 
 <tr> 
 <td><code>CI_BUILD_REF_NAME</code></td> 
 <td><code>CI_COMMIT_REF_NAME</code></td> 
 </tr> 
 <tr> 
 <td><code>CI_BUILD_REF_SLUG</code></td> 
 <td><code>CI_COMMIT_REF_SLUG</code></td> 
 </tr> 
 <tr> 
 <td><code>CI_BUILD_NAME</code></td> 
 <td><code>CI_JOB_NAME</code></td> 
 </tr> 
 <tr> 
 <td><code>CI_BUILD_STAGE</code></td> 
 <td><code>CI_JOB_STAGE</code></td> 
 </tr> 
 <tr> 
 <td><code>CI_BUILD_REPO</code></td> 
 <td><code>CI_REPOSITORY_URL</code></td> 
 </tr> 
 <tr> 
 <td><code>CI_BUILD_TRIGGERED</code></td> 
 <td><code>CI_PIPELINE_TRIGGERED</code></td> 
 </tr> 
 <tr> 
 <td><code>CI_BUILD_MANUAL</code></td> 
 <td><code>CI_JOB_MANUAL</code></td> 
 </tr> 
 <tr> 
 <td><code>CI_BUILD_TOKEN</code></td> 
 <td><code>CI_JOB_TOKEN</code></td> 
 </tr> 
 </tbody> 
</table>

## `.gitlab-ci.yaml` defined variables ##

> 注意：此功能要求GitLab Runner 0.5或者更高版本，并且GitLab CI 7.14或者更高版本

GitLab CI允许你向`.gitlab-ci.yml`中添加变量，这个变量在构建环境中设置。因此，变量将保存在存储中，他们用于存储非敏感的项目配置，例如：`RAILS_ENV`或者`DATABASE_URL`。

举个例子，如果将变量设置为全局以下（不是在一个作业中），则它将用于所有执行的命令脚本中：

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 </td> 
 <td> variables: &nbsp;&nbsp;DATABASE_URL: "postgres://postgres@postgres/my_database" </td> 
 </tr> 
 </tbody> 
</table>

YAML中定义的变量也将应用到所有创建的服务容器中，因此可以对它进行微调。

变量可以定义为全局，同时也可以定义为job级别。若要关闭作业中的全局定义变量，请定义一个空hash：

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 </td> 
 <td> job_name: &nbsp;&nbsp;variables: {} </td> 
 </tr> 
 </tbody> 
</table>

您可以在变量定义中使用其他变量（或使用$$将其转义）：

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 3 4 5 </td> 
 <td> variables: &nbsp;&nbsp;LS_CMD: 'ls $FLAGS $$TMP_DIR' &nbsp;&nbsp;FLAGS: '-al' script: &nbsp;&nbsp;- 'eval $LS_CMD'&nbsp;&nbsp;# will execute 'ls -al $TMP_DIR' </td> 
 </tr> 
 </tbody> 
</table>

## Secret variables ##

> 注意：
> 
>  *  这个功能需要GitLab Runner 0.4.0或者更高版本。
>  *  请注意，私有变量不会隐藏，如果明确要这么做，他们的值可以显示在job日志中。如果您的项目是公共的或内部的，你可以在项目的pipeline中设置pipeline为私有的。关于私有变量的讨论在issue \*&\#\#\#\#&\*\_16\_\*&\#\#\#\#&\*。

GitLab CI允许你在构建环境过程中设置项目的私有变量。私有变量存储在仓库(.gitlab-ci.yml)中，并被安全的传递给GitLab Runner，使其在构建环境中可用。建议使用该方法存储诸如密码、秘钥和凭据之类的东西。

可用通过**Settings ➔ Pipelines**来增加私有变量，通过**Settings ➔ Pipelines**找到的模块称之为私有变量。

一次设置，所有的后续pipeline是都可以使用它们。

## Protected secret variables ##

> 注意：此功能要求GitLab 9.3或者更高。

私有变量可以被保护。每当一个私有变量被保护时，它只会安全的传递到在[受保护的分支][Link 1]或[受保护的标签][Link 2]上运行的pipeline。其他的pipeline将不会得到受保护的变量。

可用通过**Settings ➔ Pipelines**来增加私有变量，通过**Settings ➔ Pipelines**找到的模块称之为私有变量，然后点击*Protected*。

一次设置，所有的后续pipeline是都可以使用它们。

## Deploment variables ##

> 注意：此功能要求GitLab CI 8.15或者更高版本。

负责部署配置的[项目服务][Link 3]可以定义在构建环境中设置自己的变量。这些变量只定义用于[部署job][job]。请参考您正在使用的项目服务的文档，以了解他们定义的变量。

一个定义有部署变量的项目服务示例[Kubernetes Service][]。

## Debug tracing ##

> GitLab Runner 1.7开始引入。
> 
> **警告**：启用调试跟踪可能会严重的安全隐患。输出内容将包含所有的私有变量和其他的隐私！输出的内容将被上传到GitLab服务器并且将会在job记录中明显体现。

默认情况下，GitLab Runner会隐藏了处理job时正在做的大部分细节。这种行为使job跟踪很短，并且防止秘密泄露到跟踪中，除非您的脚本将他们输出到屏幕中。

如果job没有按照预期的运行，这也会让问题查找变得更加困难；在这种情况下，你可以在`.gitlab-ci.yml`中开启调试记录。它需要GitLab Runner v1.7版本以上，此功能可启用[shell][]的执行记录，从而产生详细的job记录，列出所有执行的命令，设置变量等。

在启用此功能之前，您应该确保job只对[团队成][Link 4]员可见。您也应该[https://docs.gitlab.com/ce/ci/pipelines.html\#seeing-build-status所有生成的job记录，然后使其可见。][https_docs.gitlab.com_ce_ci_pipelines.html_seeing-build-status_job]

设置`CI_DEBUG_TRACE`变量的值为`true`来开启调试记录。

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 3 </td> 
 <td> job_name: &nbsp;&nbsp;variables: &nbsp;&nbsp;&nbsp;&nbsp;CI_DEBUG_TRACE: "true" </td> 
 </tr> 
 </tbody> 
</table>

调试记录设置为TRUE的截断输出示例：

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 </td> 
 <td> ... &nbsp; export CI_SERVER_TLS_CA_FILE="/builds/gitlab-examples/ci-debug-trace.tmp/CI_SERVER_TLS_CA_FILE" if [[ -d "/builds/gitlab-examples/ci-debug-trace/.git" ]]; then &nbsp;&nbsp;echo $'\''\x1b[32;1mFetching changes...\x1b[0;m'\'' &nbsp;&nbsp;$'\''cd'\'' "/builds/gitlab-examples/ci-debug-trace" &nbsp;&nbsp;$'\''git'\'' "config" "fetch.recurseSubmodules" "false" &nbsp;&nbsp;$'\''rm'\'' "-f" ".git/index.lock" &nbsp;&nbsp;$'\''git'\'' "clean" "-ffdx" &nbsp;&nbsp;$'\''git'\'' "reset" "--hard" &nbsp;&nbsp;$'\''git'\'' "remote" "set-url" "origin" "https://gitlab-ci-token:xxxxxxxxxxxxxxxxxxxx@example.com/gitlab-examples/ci-debug-trace.git" &nbsp;&nbsp;$'\''git'\'' "fetch" "origin" "--prune" "+refs/heads/*:refs/remotes/origin/*" "+refs/tags/*:refs/tags/*" else &nbsp;&nbsp;$'\''mkdir'\'' "-p" "/builds/gitlab-examples/ci-debug-trace.tmp/git-template" &nbsp;&nbsp;$'\''rm'\'' "-r" "-f" "/builds/gitlab-examples/ci-debug-trace" &nbsp;&nbsp;$'\''git'\'' "config" "-f" "/builds/gitlab-examples/ci-debug-trace.tmp/git-template/config" "fetch.recurseSubmodules" "false" &nbsp;&nbsp;echo $'\''\x1b[32;1mCloning repository...\x1b[0;m'\'' &nbsp;&nbsp;$'\''git'\'' "clone" "--no-checkout" "https://gitlab-ci-token:xxxxxxxxxxxxxxxxxxxx@example.com/gitlab-examples/ci-debug-trace.git" "/builds/gitlab-examples/ci-debug-trace" "--template" "/builds/gitlab-examples/ci-debug-trace.tmp/git-template" &nbsp;&nbsp;$'\''cd'\'' "/builds/gitlab-examples/ci-debug-trace" fi echo $'\''\x1b[32;1mChecking out dd648b2e as master...\x1b[0;m'\'' $'\''git'\'' "checkout" "-f" "-q" "dd648b2e48ce6518303b0bb580b2ee32fadaf045" ' +++ hostname ++ echo 'Running on runner-8a2f473d-project-1796893-concurrent-0 via runner-8a2f473d-machine-1480971377-317a7d0f-digital-ocean-4gb...' Running on runner-8a2f473d-project-1796893-concurrent-0 via runner-8a2f473d-machine-1480971377-317a7d0f-digital-ocean-4gb... ++ export CI=true ++ CI=true ++ export CI_DEBUG_TRACE=false ++ CI_DEBUG_TRACE=false ++ export CI_COMMIT_SHA=dd648b2e48ce6518303b0bb580b2ee32fadaf045 ++ CI_COMMIT_SHA=dd648b2e48ce6518303b0bb580b2ee32fadaf045 ++ export CI_COMMIT_BEFORE_SHA=dd648b2e48ce6518303b0bb580b2ee32fadaf045 ++ CI_COMMIT_BEFORE_SHA=dd648b2e48ce6518303b0bb580b2ee32fadaf045 ++ export CI_COMMIT_REF_NAME=master ++ CI_COMMIT_REF_NAME=master ++ export CI_JOB_ID=7046507 ++ CI_JOB_ID=7046507 ++ export CI_REPOSITORY_URL=https://gitlab-ci-token:xxxxxxxxxxxxxxxxxxxx@example.com/gitlab-examples/ci-debug-trace.git ++ CI_REPOSITORY_URL=https://gitlab-ci-token:xxxxxxxxxxxxxxxxxxxx@example.com/gitlab-examples/ci-debug-trace.git ++ export CI_JOB_TOKEN=xxxxxxxxxxxxxxxxxxxx ++ CI_JOB_TOKEN=xxxxxxxxxxxxxxxxxxxx ++ export CI_PROJECT_ID=1796893 ++ CI_PROJECT_ID=1796893 ++ export CI_PROJECT_DIR=/builds/gitlab-examples/ci-debug-trace ++ CI_PROJECT_DIR=/builds/gitlab-examples/ci-debug-trace ++ export CI_SERVER=yes ++ CI_SERVER=yes ++ export 'CI_SERVER_NAME=GitLab CI' ++ CI_SERVER_NAME='GitLab CI' ++ export CI_SERVER_VERSION= ++ CI_SERVER_VERSION= ++ export CI_SERVER_REVISION= ++ CI_SERVER_REVISION= ++ export GITLAB_CI=true ++ GITLAB_CI=true ++ export CI=true ++ CI=true ++ export GITLAB_CI=true ++ GITLAB_CI=true ++ export CI_JOB_ID=7046507 ++ CI_JOB_ID=7046507 ++ export CI_JOB_TOKEN=xxxxxxxxxxxxxxxxxxxx ++ CI_JOB_TOKEN=xxxxxxxxxxxxxxxxxxxx ++ export CI_COMMIT_REF=dd648b2e48ce6518303b0bb580b2ee32fadaf045 ++ CI_COMMIT_REF=dd648b2e48ce6518303b0bb580b2ee32fadaf045 ++ export CI_COMMIT_BEFORE_SHA=dd648b2e48ce6518303b0bb580b2ee32fadaf045 ++ CI_COMMIT_BEFORE_SHA=dd648b2e48ce6518303b0bb580b2ee32fadaf045 ++ export CI_COMMIT_REF_NAME=master ++ CI_COMMIT_REF_NAME=master ++ export CI_COMMIT_NAME=debug_trace ++ CI_JOB_NAME=debug_trace ++ export CI_JOB_STAGE=test ++ CI_JOB_STAGE=test ++ export CI_SERVER_NAME=GitLab ++ CI_SERVER_NAME=GitLab ++ export CI_SERVER_VERSION=8.14.3-ee ++ CI_SERVER_VERSION=8.14.3-ee ++ export CI_SERVER_REVISION=82823 ++ CI_SERVER_REVISION=82823 ++ export CI_PROJECT_ID=17893 ++ CI_PROJECT_ID=17893 ++ export CI_PROJECT_NAME=ci-debug-trace ++ CI_PROJECT_NAME=ci-debug-trace ++ export CI_PROJECT_PATH=gitlab-examples/ci-debug-trace ++ CI_PROJECT_PATH=gitlab-examples/ci-debug-trace ++ export CI_PROJECT_NAMESPACE=gitlab-examples ++ CI_PROJECT_NAMESPACE=gitlab-examples ++ export CI_PROJECT_URL=https://example.com/gitlab-examples/ci-debug-trace ++ CI_PROJECT_URL=https://example.com/gitlab-examples/ci-debug-trace ++ export CI_PIPELINE_ID=52666 ++ CI_PIPELINE_ID=52666 ++ export CI_RUNNER_ID=1337 ++ CI_RUNNER_ID=1337 ++ export CI_RUNNER_DESCRIPTION=shared-runners-manager-1.example.com ++ CI_RUNNER_DESCRIPTION=shared-runners-manager-1.example.com ++ export 'CI_RUNNER_TAGS=shared, docker, linux, ruby, mysql, postgres, mongo' ++ CI_RUNNER_TAGS='shared, docker, linux, ruby, mysql, postgres, mongo' ++ export CI_REGISTRY=registry.example.com ++ CI_REGISTRY=registry.example.com ++ export CI_DEBUG_TRACE=true ++ CI_DEBUG_TRACE=true ++ export GITLAB_USER_ID=42 ++ GITLAB_USER_ID=42 ++ export GITLAB_USER_EMAIL=user@example.com ++ GITLAB_USER_EMAIL=user@example.com ++ export VERY_SECURE_VARIABLE=imaverysecurevariable ++ VERY_SECURE_VARIABLE=imaverysecurevariable ++ mkdir -p /builds/gitlab-examples/ci-debug-trace.tmp ++ echo -n '-----BEGIN CERTIFICATE----- MIIFQzCCBCugAwIBAgIRAL/ElDjuf15xwja1ZnCocWAwDQYJKoZIhvcNAQELBQAw' ... </td> 
 </tr> 
 </tbody> 
</table>

## Using the CI variables in your job scripts ##

在构建环境变量时，所有的变量都被设置为环境变量，他们可以使用普通方法访问这些变量。在大多数情况下，用于执行job脚本都是通过bash或者是sh。

想要访问环境变量，请示使用一下Runner对应的语法：

<table> 
 <thead> 
 <tr> 
 <th>Shell</th> 
 <th>用法</th> 
 </tr> 
 </thead> 
 <tbody> 
 <tr> 
 <td>bash/sh</td> 
 <td><code>$variable</code></td> 
 </tr> 
 <tr> 
 <td><a href="http://www.ttlsa.com/windows/" rel="nofollow">windows</a>&nbsp;batch</td> 
 <td><code>%variable%</code></td> 
 </tr> 
 <tr> 
 <td>PowerShell</td> 
 <td><code>$env:variable</code></td> 
 </tr> 
 </tbody> 
</table>

在bash中访问环境变量，需要给变量名称加上前缀(`$`)：

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 3 </td> 
 <td> job_name: &nbsp;&nbsp;script: &nbsp;&nbsp;&nbsp;&nbsp;- echo $CI_JOB_ID </td> 
 </tr> 
 </tbody> 
</table>

在Windows系统的PowerShell中访问环境变量，需要给变量名称加上前缀(`$env:`)：

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 3 </td> 
 <td> job_name: &nbsp;&nbsp;script: &nbsp;&nbsp;&nbsp;&nbsp;- echo $env:CI_JOB_ID </td> 
 </tr> 
 </tbody> 
</table>

您可以使用`export`命令来列出所有的环境变量。在使用此命令时要注意，此命令也会在job记录中列出所有私有变量的值：

<table> 
 <tbody> 
 <tr> 
 <td> 1 2 3 </td> 
 <td> job_name: &nbsp;&nbsp;script: &nbsp;&nbsp;&nbsp;&nbsp;- export </td> 
 </tr> 
 </tbody> 
</table>

实例的值：

[GitLab CI_CD environment variables]: https://docs.gitlab.com/ce/ci/variables/README.html
[Runner]: https://docs.gitlab.com/runner/
[Trigger variables]: https://docs.gitlab.com/ce/ci/triggers/README.html#pass-job-variables-to-a-trigger
[Secret variables]: https://docs.gitlab.com/ce/ci/variables/README.html#secret-variables
[job-level variables]: https://docs.gitlab.com/ce/ci/yaml/README.html#job-variables
[global variables]: https://docs.gitlab.com/ce/ci/yaml/README.html#variables
[Deployment variables]: https://docs.gitlab.com/ce/ci/variables/README.html#deployment-variables
[Predefined variables]: https://docs.gitlab.com/ce/ci/variables/README.html#predefined-variables-environment-variables
[9.0 Renaming]: https://docs.gitlab.com/ce/ci/variables/README.html#9-0-renaming
[Link 1]: https://docs.gitlab.com/ce/user/project/protected_branches.html
[Link 2]: https://docs.gitlab.com/ce/user/project/protected_tags.html
[Link 3]: https://docs.gitlab.com/ce/user/project/integrations/project_services.html
[job]: https://docs.gitlab.com/ce/ci/environments.html
[Kubernetes Service]: https://docs.gitlab.com/ce/user/project/integrations/kubernetes.html
[shell]: http://www.ttlsa.com/shell/
[Link 4]: https://docs.gitlab.com/ce/user/permissions.html#project-features
[https_docs.gitlab.com_ce_ci_pipelines.html_seeing-build-status_job]: https://docs.gitlab.com/ce/ci/pipelines.html#seeing-build-status%E6%89%80%E6%9C%89%E7%94%9F%E6%88%90%E7%9A%84job%E8%AE%B0%E5%BD%95%EF%BC%8C%E7%84%B6%E5%90%8E%E4%BD%BF%E5%85%B6%E5%8F%AF%E8%A7%81%E3%80%82