GitLab CI：如何合并包含文件与本地的全局before_script代码

GitLab CI 默认情况下，本地定义的 before_script 会直接覆盖引入文件中的全局配置，要实现继承并追加内容，可以用以下两种实用方法：

方法一：使用锚点 + !reference 关键字（推荐） #

先在被引入的 common-ci.yml 中，给全局 before_script 定义一个带锚点的模板：

# SOME_PROJECT/common-ci.yml
.global_before_script: &global_before_script
  - echo "公共before_script步骤1"
  - apt-get update -y

# 全局默认使用这个模板
before_script: *global_before_script

然后在本地的 gitlab-ci.yml 中，通过 !reference 引用公共模板内容，再追加自定义步骤：

# 本地gitlab-ci.yml
include:
  - project: 'SOME_PROJECT'
    file: '/common-ci.yml'

before_script:
  - !reference [.global_before_script]
  - echo "追加的本地before_script步骤"
  - npm install

这种方式能完美保留公共脚本的所有逻辑，同时灵活添加本地内容，适合复杂场景。

方法二：变量拼接（适合简单场景） #

如果公共脚本逻辑简单，可将其定义为变量，在本地直接调用并追加：

# SOME_PROJECT/common-ci.yml
variables:
  COMMON_BEFORE: |
    echo "公共before_script内容"
    apt-get update -y

before_script:
  - $COMMON_BEFORE

本地配置：

include:
  - project: 'SOME_PROJECT'
    file: '/common-ci.yml'

before_script:
  - $COMMON_BEFORE
  - echo "本地追加的步骤"

注意：若公共脚本包含特殊字符、条件判断等复杂逻辑，这种方法可能出现解析问题，优先选方法一。

内容的提问来源于stack exchange，提问作者Raz