GitLab CI仅执行单个项目且移除include后流水线无法启动问题

核心原因 #

只定义stages但没有配置关联的有效Job，GitLab CI会判定无可用执行任务，因此不会启动流水线。

解决方案 #

方法1：复用单个子项目的CI配置 #

将你想单独运行的项目对应的ci.yml内容完整复制到主.gitlab-ci.yml中，替换原有的include块。
比如原services/user-service/ci.yml内容如下：

stages:
  - build
  - test

user-service-build:
  stage: build
  script:
    - cd services/user-service
    - mvn clean package

user-service-test:
  stage: test
  script:
    - cd services/user-service
    - mvn test

复制后主文件结构变为：

stages:
  - build
  - test

user-service-build:
  stage: build
  script:
    - cd services/user-service
    - mvn clean package

user-service-test:
  stage: test
  script:
    - cd services/user-service
    - mvn test

方法2：手动编写最小可用配置 #

若不想复制子配置，需确保主文件包含至少一个绑定到stage的Job，示例：

# 定义流水线阶段
stages:
  - build

# 配置具体执行的Job，必须关联到上面的stage
single-project-build:
  stage: build
  # 替换为你项目实际的构建命令，注意路径要对应仓库根目录
  script:
    - cd services/user-service
    - npm install
    - npm run build

必做检查 #

• 用GitLab仓库内置的CI Lint工具（仓库→Settings→CI/CD→CI Lint）验证配置语法，排查格式错误
• 确认Job的stage字段值在stages列表中存在
• 检查script中的命令路径是否正确（子项目的ci.yml是相对自身目录，主文件中需调整为相对仓库根目录的路径）

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