summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGrzegorz Bizon <grzesiek.bizon@gmail.com>2018-04-06 10:41:58 +0200
committerGrzegorz Bizon <grzesiek.bizon@gmail.com>2018-04-06 10:41:58 +0200
commit847f1667c89831213859d62ca66fbd55181fb129 (patch)
treeb2feb006341fb3836e0afec45ca4a3ff80246cde
parent323bac4a6e1de5d9ba9c1cb3a2868f514888c44a (diff)
downloadgitlab-ce-docs/gb/improve-pipeline-variables-expressions-docs.tar.gz
Document unsupported variables for dynamic environmentsdocs/gb/improve-pipeline-variables-expressions-docs
-rw-r--r--doc/ci/environments.md15
-rw-r--r--doc/ci/variables/README.md4
2 files changed, 16 insertions, 3 deletions
diff --git a/doc/ci/environments.md b/doc/ci/environments.md
index 58c4a71cef9..b3d9f0bc96c 100644
--- a/doc/ci/environments.md
+++ b/doc/ci/environments.md
@@ -247,10 +247,19 @@ declaring their names dynamically in `.gitlab-ci.yml`. Dynamic environments is
the basis of [Review apps](review_apps/index.md).
>**Note:**
-The `name` and `url` parameters can use any of the defined CI variables,
+The `name` and `url` parameters can use most of the defined CI variables,
including predefined, secure variables and `.gitlab-ci.yml`
-[`variables`](yaml/README.md#variables).
-You however cannot use variables defined under `script` or on the Runner's side.
+[`variables`](yaml/README.md#variables). You however cannot use variables
+defined under `script` or on the Runner's side. There are other variables that
+are unsupported in environment name context:
+- `CI_JOB_ID`
+- `CI_JOB_TOKEN`
+- `CI_BUILD_ID`
+- `CI_BUILD_TOKEN`
+- `CI_REGISTRY_USER`
+- `CI_REGISTRY_PASSWORD`
+- `CI_REPOSITORY_URL`
+- `CI_ENVIRONMENT_URL`
GitLab Runner exposes various [environment variables][variables] when a job runs,
and as such, you can use them as environment names. Let's add another job in
diff --git a/doc/ci/variables/README.md b/doc/ci/variables/README.md
index 381405a9db9..4a504a98902 100644
--- a/doc/ci/variables/README.md
+++ b/doc/ci/variables/README.md
@@ -547,6 +547,9 @@ You can find a full list of unsupported variables below:
- `CI_REPOSITORY_URL`
- `CI_ENVIRONMENT_URL`
+These variables are also not supported in a contex of a
+[dynamic environment name][dynamic-environments].
+
[ce-13784]: https://gitlab.com/gitlab-org/gitlab-ce/issues/13784 "Simple protection of CI secret variables"
[eep]: https://about.gitlab.com/products/ "Available only in GitLab Premium"
[envs]: ../environments.md
@@ -558,3 +561,4 @@ You can find a full list of unsupported variables below:
[triggers]: ../triggers/README.md#pass-job-variables-to-a-trigger
[subgroups]: ../../user/group/subgroups/index.md
[builds-policies]: ../yaml/README.md#only-and-except-complex
+[dynamic-environments]: ../environments.md#dynamic-environments