2022-04-04 11:22:00 +05:30
- name : "`CI_BUILD_*` predefined variables"
announcement_milestone : "14.8"
2022-07-23 23:45:48 +05:30
announcement_date : "2022-02-22"
2022-06-21 17:19:12 +05:30
removal_milestone : "16.0"
removal_date : "2023-04-22"
2022-04-04 11:22:00 +05:30
breaking_change : true
reporter : dhershkovitch
body : |
2022-06-21 17:19:12 +05:30
The predefined CI/CD variables that start with `CI_BUILD_*` were deprecated in GitLab 9.0, and will be removed in GitLab 16.0. If you still use these variables, be sure to change to the replacement [predefined variables](https://docs.gitlab.com/ee/ci/variables/predefined_variables.html) which are functionally identical :
| Removed variable | Replacement variable |
| --------------------- |------------------------ |
| `CI_BUILD_BEFORE_SHA` | `CI_COMMIT_BEFORE_SHA` |
| `CI_BUILD_ID` | `CI_JOB_ID` |
| `CI_BUILD_MANUAL` | `CI_JOB_MANUAL` |
| `CI_BUILD_NAME` | `CI_JOB_NAME` |
| `CI_BUILD_REF` | `CI_COMMIT_SHA` |
| `CI_BUILD_REF_NAME` | `CI_COMMIT_REF_NAME` |
| `CI_BUILD_REF_SLUG` | `CI_COMMIT_REF_SLUG` |
| `CI_BUILD_REPO` | `CI_REPOSITORY_URL` |
| `CI_BUILD_STAGE` | `CI_JOB_STAGE` |
| `CI_BUILD_TAG` | `CI_COMMIT_TAG` |
| `CI_BUILD_TOKEN` | `CI_JOB_TOKEN` |
| `CI_BUILD_TRIGGERED` | `CI_PIPELINE_TRIGGERED` |
2022-04-04 11:22:00 +05:30
# The following items are not published on the docs page, but may be used in the future.
stage : Verify
tiers : [ Free, Premium, Ultimate]
issue_url : https://gitlab.com/gitlab-org/gitlab/-/issues/352957
documentation_url : https://docs.gitlab.com/ee/ci/variables/predefined_variables.html
image_url : # (optional) This is a link to a thumbnail image depicting the feature
video_url : # (optional) Use the youtube thumbnail URL with the structure of https://img.youtube.com/vi/UNIQUEID/hqdefault.jpg
