如何在多个GitLab CI项目中共享脚本以避免重复编写？

这问题我太熟了！在GitLab CI里复用通用脚本根本不用每个仓库复制粘贴，有好几种省心的方式，我给你一一拆解：

你可以把所有通用CI脚本集中放到一个单独的仓库里（比如叫ci-shared-templates），然后其他仓库只需要通过include拉取这个仓库里的文件就行，维护起来超方便。

举个实际例子：

• 先在模板仓库里创建一个scripts/common-build.yml，把你的通用脚本写进去：

# 注意用点开头的job名，代表这是个可复用的模板job
.common-build:
  script:
    - echo "初始化构建环境..."
    - apt-get update && apt-get install -y build-essential
    - make clean && make build
    - echo "构建完成，产物已打包"

• 然后在需要复用的仓库的.gitlab-ci.yml里，引入这个模板并继承使用：

# 引入模板仓库里的脚本文件
include:
  - project: 'your-team/ci-shared-templates'
    ref: v1.0.0  # 一定要指定固定的tag/分支，避免模板更新意外影响现有CI
    file: '/scripts/common-build.yml'

# 直接继承模板里的job，再按需添加自定义配置
my-project-build:
  extends: .common-build
  tags:
    - my-dedicated-runner
  only:
    - main

如果你的所有仓库都在同一个GitLab群组下，那更省事——直接把模板放到群组的CI/CD设置里，群组内所有仓库都能直接调用，连include都省了。

操作步骤：

1. 进入群组的「Settings」→「CI/CD」→「Templates」
2. 点击「New template」，把你的通用脚本粘贴进去，起个好记的名字比如通用构建模板
3. 然后在任意群组内仓库的CI配置里，直接继承这个模板：

project-build:
  extends:
    - .通用构建模板  # 注意名字前面的点和空格，必须加

这个方式适合群组内统一规范CI流程，不用单独维护模板仓库。

如果你的GitLab版本是15.0及以上，可以用CI/CD Components，这是更模块化的复用方式，还能像函数一样传参数，灵活性拉满。

比如先创建一个component仓库，结构如下：

ci-components/
└── build-component/
    └── template.yml

template.yml里写带参数的模板：

spec:
  inputs:
    build_tool:
      default: 'make'
      description: "指定构建工具（make/maven/npm等）"

job:
  script:
    - echo "使用 $[[ inputs.build_tool ]] 进行构建..."
    - if [ "$[[ inputs.build_tool ]]" = "make" ]; then make build; fi
    - if [ "$[[ inputs.build_tool ]]" = "npm" ]; then npm install && npm run build; fi

然后在其他仓库里引入并传参：

include:
  - component: 'your-team/ci-components/build-component@v1.1.0'
    inputs:
      build_tool: 'npm'  # 自定义传入构建工具参数

# 也可以继承后再修改配置
custom-npm-build:
  extends: build-component/job
  only:
    - tags

• 权限要到位：确保目标仓库的CI runner有权限访问模板仓库/群组模板，要么把模板仓库设为公开，要么给目标仓库添加模板仓库的访问权限。
• 版本一定要锁死：不管用哪种方式，都别直接用main分支引用，最好打个tag（比如v1.0.0），用固定版本引用，避免模板更新导致所有仓库CI突然失败。
• 先测试再推广：修改模板后，先在测试仓库跑一遍CI验证没问题，再推送到正式版本。

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