GitLab CI模板传参报错：jobs spec需实现script或trigger关键字

这个报错的核心原因是你的CI配置里没有定义任何可执行的job——GitLab要求每个CI配置必须包含至少一个带有script:、trigger:或其他执行逻辑的job，仅靠default段的before_script是不够的，因为它只是附加到job的前置操作，本身不能作为独立的job存在。

具体修正方案 #

根据你的模板嵌套场景，分三种情况处理：

情况1：在嵌套模板中添加基础job

修改another-template.gitlab-ci.yaml，在引入通用脚本模板后，添加至少一个实际可执行的job：

include:
  - local: common-scripts.gitlab-ci.yaml
    inputs:
      branchName: "XYZ"

# 必须添加带script/trigger的job
lint:
  script:
    - echo "执行代码检查任务"
    - # 这里替换为实际的任务命令

情况2：在通用脚本模板中定义可继承的job模板

如果希望通用脚本模板不仅提供before_script，还能让其他job复用配置，可以修改common-scripts.gitlab-ci.yaml，定义一个可继承的job模板：

parameters:
  branchName: "main"

.base_job_template:
  before_script:
    - echo "针对分支 $branchName 执行前置脚本"
    - # 这里添加通用前置操作命令

然后在another-template.gitlab-ci.yaml中引入并使用这个模板：

include:
  - local: common-scripts.gitlab-ci.yaml
    inputs:
      branchName: "XYZ"

build:
  extends: .base_job_template
  script:
    - echo "执行构建任务"
    - # 这里替换为实际构建命令

情况3：在实际仓库的CI配置中添加job

如果嵌套模板仅负责引入通用脚本，那么实际仓库的.gitlab-ci.yaml里必须定义job：

include:
  - local: another-template.gitlab-ci.yaml

test:
  script:
    - echo "执行测试任务"

关键注意点 #

• default段的before_script会自动应用到所有job，但前提是配置里存在至少一个job。
• 所有模板引入后，最终生成的CI配置必须包含至少一个可执行的job，否则就会触发该报错。

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