2022-02-16 22:16:49 -05:00
- name : "`CI_BUILD_*` predefined variables"
announcement_milestone : "14.8"
2022-06-02 17:09:25 -04:00
announcement_date : "2022-02-22"
2022-03-21 23:08:38 -04:00
removal_milestone : "16.0"
removal_date : "2023-04-22"
2022-02-16 22:16:49 -05:00
breaking_change : true
reporter : dhershkovitch
body : |
2022-03-21 23:08:38 -04:00
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 :
2022-03-21 20:07:23 -04:00
| 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-02-16 22:16:49 -05:00
# 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
