极狐 GitLab CI/CD 变量是指一系列的环境变量，用来帮助我们控制 CI/CD Job 或 Pipeline 的行为，存储一些可以复用的信息，避免在 .gitlab-ci.yml 中形成硬编码。
极狐 GitLab CI/CD 变量分为预定义变量(predefined CI/CD variables) 和自定义变量(custom variable) 两部分。今天我们先来学习预定义变量这部分。
预定义变量
顾名思义，预定义变量就是极狐 GitLab 已经提前定义好，无须声明即可进行全局使用的环境变量。极狐 GitLab 有多达 140 个预定义（截止到 14.3-pre 版本）的环境变量，而且是随着版本的迭代在增加的。这儿可以查看所有变量的详细内容。
这些环境变量大体分为四类：
下面会挑一些使用频率比较高的进行解析和演示。
commit 相关
可以触发一个 Job 直接进行测试，诸如在 .gitlab-ci.yaml 文件中加入下述内容
after_script: - echo "The value of CI_BUILDS_DIR is $CI_BUILDS_DIR" - echo "The value of CI_COMMIT_AUTHOR is $CI_COMMIT_AUTHOR" - echo "The value of CI_COMMIT_BRANCH is $CI_COMMIT_BRANCH" - echo "The value of CI_COMMIT_MESSAGE is $CI_COMMIT_MESSAGE" - echo "The value of CI_COMMIT_SHA is $CI_COMMIT_SHA" - echo "The value of CI_COMMIT_SHORT_SHA is $CI_COMMIT_SHORT_SHA" - echo "The value of CI_COMMIT_REF_NAME is $CI_COMMIT_REF_NAME" - echo "The value of CI_COMMIT_TITLE is $CI_COMMIT_TITLE" - echo "The value of CI_COMMIT_TIMESTAMP is $CI_COMMIT_TIMESTAMP"
复制代码
可以查看构建结果
Job 相关
可以触发一个 Job 直接进行测试，诸如在 .gitlab-ci.yaml 文件中加入下述内容
after_script: - echo "The value of CI_JOB_ID is $CI_JOB_ID" - echo "The value of CI_JOB_IMAGE is $CI_JOB_IMAGE" - echo "The value of CI_JOB_JWT is $CI_JOB_JWT" - echo "The value of CI_JOB_NAME is $CI_JOB_NAME" - echo "The value of CI_JOB_STAGE is $CI_JOB_STAGE" - echo "The value of CI_JOB_STATUS is $CI_JOB_STATUS" - echo "The value of CI_COMMIT_REF_NAME is $CI_COMMIT_REF_NAME" - echo "The value of CI_JOB_URL is $CI_JOB_URL" - echo "The value of CI_JOB_STARTED_AT is $CI_JOB_STARTED_AT"
复制代码
可以查看构建结果
Pipeline 相关
可以触发一个 Job 直接进行测试，诸如在 .gitlab-ci.yaml 文件中加入下述内容
after_script: - echo "The value of CI_PIPELINE_SOURCE is $CI_PIPELINE_SOURCE" - echo "The value of CI_PIPELINE_URL is $CI_PIPELINE_URL" - echo "The value of CI_PIPELINE_ID is $CI_PIPELINE_ID" - echo "The value of CI_PIPELINE_IID is $CI_PIPELINE_IID" - echo "The value of CI_PIPELINE_TRIGGERED is $CI_PIPELINE_TRIGGERED" - echo "The value of CI_PIPELINE_CREATED_AT is $CI_PIPELINE_CREATED_AT"
复制代码
可以查看构建结果
镜像仓库有关
可以触发一个 Job 直接进行测试，诸如在 .gitlab-ci.yaml 文件中加入下述内容
after_script: - echo "The value of CI_REGISTRY_IMAGE is $CI_REGISTRY_IMAGE" - echo "The value of CI_REGISTRY_PASSWORD is $CI_REGISTRY_PASSWORD" - echo "The value of CI_REGISTRY_USER is $CI_REGISTRY_USER" - echo "The value of CI_REGISTRY is $CI_REGISTRY"
复制代码
可以查看构建结果
如果使用极狐 GitLab 的镜像仓库功能，则会构建镜像并推送至镜像仓库时会频繁用到上述几个参数，使用示例如下
build: stage: build script: - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY - docker build -t $CI_REGISTRY_IMAGE:$CI_COMMIT_SHA . - docker push $CI_REGISTRY_IMAGE:$CI_COMMIT_SHA
复制代码
CI_REGISTRY_IMAGE 和 CI_REGISTRY 的却别就是一个是项目级别的镜像仓库，一个是实例级别的镜像仓库。另外，至于 CI_REGISTRY_USER 的值是 gitlab-ci-token 而不是用户登陆极狐 GitLab 的用户名，这个且听后面文章对于镜像仓库具体使用时的分解。
还有很多其他的预定义变量，大家可以在打开下面引用链接的地址直接查看，但是每个变量的用法都是类似的，因为是预定义，所以可以在 CI/CD Pipeline 中像上面的 Demo 一样直接使用，而无需先定义，再使用。
当然，预定义是无法满足全部场景的 CI/CD 的，因此极狐 GitLab 也支持自定义变量，敬请期待极狐 GitLab CI/CD 变量黑魔法你知道多少？（下）
评论