GitLab CI/CD 开发速查表

在 11.4 中移至 GitLab 免费版，使用 include 将外部 YAML 文件包含在您的 CI/CD 配置中

include:
  - local: '/temp/.gitlab-ci-template.yml'

使用 include:local 包含与 .gitlab-ci.yml 文件位于同一存储库中的文件

include:
  - local: '/temp/.gitlab-ci-template.yml'

使用带有完整 URL 的 include:remote 来包含来自不同位置的文件

include:
  - remote: 'https://gitlab.com/example-project/-/raw/main/.gitlab-ci.yml'

使用 include:template 来包含 .gitlab-ci.yml 模板

# 文件来自 GitLab 模板集合
include:
  - template: Auto-DevOps.gitlab-ci.yml

多个 include:template 文件：

include:
  - template: Android-Fastlane.gitlab-ci.yml
  - template: Auto-DevOps.gitlab-ci.yml

使用阶段来定义包含作业组的阶段。如果 .gitlab-ci.yml 文件中未定义阶段，则默认管道阶段为：

• .pre
• build
• test
• deploy
• .post

stages:
  - build
  - test
  - deploy

您可以在 workflow: 中使用 name 来定义管道的名称

workflow:
  name: '分支管道：$CI_COMMIT_BRANCH'

根据管道条件具有不同管道名称的配置：

variables:
  PIPELINE_NAME: '默认管道名称'

workflow:
  name: '$PIPELINE_NAME'
  rules:
    - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'
      variables:
        PIPELINE_NAME: 'MR pipeline: $CI_COMMIT_BRANCH'
    - if: '$CI_MERGE_REQUEST_LABELS =~ /pipeline:run-in-ruby3/'
      variables:
        PIPELINE_NAME: 'Ruby 3 pipeline'

工作流(workflow)中的 rules 关键字类似于作业中定义的 rules，但控制是否创建整个管道

• rules: if
• rules: changes
• rules: exists
• when
• variables

workflow:
  rules:
    - if: $CI_COMMIT_TITLE =~ /-draft$/
      when: never
    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH

在每个作业（包括失败的作业）之后运行的命令数组

job:
  script:
    - echo "示例脚本部分"
  after_script:
    - echo "在“script”部分完成后执行此命令"

在每个作业的 script 命令之前运行，但在工件恢复之后运行

job:
  before_script:
    - echo "在任何“script:”命令之前执行此命令。"
  script:
    - echo "此命令在作业的“before_script”命令之后执行"

路径是相对于项目目录（$CI_PROJECT_DIR）的，不能直接链接到项目目录之外

job:
  artifacts:
    paths:
      - binaries/
      - .config

防止将文件添加到 artifacts 存档中

artifacts:
  paths:
    - binaries/
  exclude:
    - binaries/**/*.o

指定作业 artifacts 在它们过期和被删除之前存储多长时间

job:
  artifacts:
    expire_in: 1 week

• '42'
• 42 seconds
• 3 mins 4 sec
• 2 hrs 20 min
• 2h20min
• 6 mos 1 day
• 47 yrs 6 mos and 4d
• 3 weeks and 2 days
• never

使用 artifacts:expose_as 关键字在合并请求 UI 中公开作业 artifacts

test:
  script: ["echo 'test' > file.txt"]
  artifacts:
    expose_as: 'artifact 1'
    paths: ['file.txt']

定义创建的 artifacts 存档的名称。您可以为每个存档指定一个唯一的名称

job:
  artifacts:
    name: "job1-artifacts-file"
    paths:
      - binaries/

确定作业工件是否应该公开可用

job:
  artifacts:
    public: false

收集作业中包含的模板生成的 artifacts

rspec:
  stage: test
  script:
    - bundle install
    - rspec --format RspecJunitFormatter --out rspec.xml
  artifacts:
    reports:
      junit: rspec.xml

将所有 Git 未跟踪文件添加为 artifacts（连同在 artifacts:paths 中定义的路径）

job:
  artifacts:
    untracked: true

作业失败或尽管失败时上传 artifacts

job:
  artifacts:
    when: on_failure