如何让GitLab CI组件仅作为模板复用，避免自动执行？

你现在遇到的情况是：引入的GitLab CI组件会自动触发一个作业，导致流水线同时运行组件自带作业和你定义的Demo job，但你只希望复用组件的模板逻辑，仅执行Demo job。

你的CI组件代码 #

spec:
  inputs:
    message:
      default: test
---
.test-component:
  script:
    - echo "$[[ inputs.message ]]"

你的流水线配置 #

stages:
  - test

include:
  - component: [my-gitlab-url]/[project-path]/test-component@[commit-sha]
    inputs:
      message: "This is a test job!"

Demo job:
  stage: test
  extends:
    - test-component
  before_script:
    - echo "This is before script!"
  after_script:
    - echo "This is after script!"

解决方法 #

GitLab CI中，名称以.开头的作业是隐藏模板，默认不会自动执行，仅能通过extends关键字引用复用。针对你的问题可按以下方式处理：

1. 确认组件作业命名规范
   检查组件内的作业名是否为.test-component（带点前缀），如果之前写成了test-component（不带点），GitLab会将其识别为普通作业自动执行。修正为带点的命名后，组件仅会作为模板被Demo job引用，不会单独触发执行。

2. 强制禁用模板自动执行（可选）
   若因GitLab版本兼容或特殊配置导致隐藏模板仍被触发，可在组件的模板作业中添加rules: - when: never，彻底阻止其自动运行：

   spec:
     inputs:
       message:
         default: test
   ---
   .test-component:
     script:
       - echo "$[[ inputs.message ]]"
     rules:
       - when: never
   

修改完成后，流水线只会执行你定义的Demo job，组件仅作为模板提供复用的脚本逻辑。

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