- title: "`CI_BUILD_*` predefined variables"
  announcement_milestone: "14.8"
  announcement_date: "2022-02-22"
  removal_milestone: "16.0"
  removal_date: "2023-05-22"
  breaking_change: true
  reporter: dhershkovitch
  body: |
    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` |
# 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