如何调用GitLab /projects/:id/trigger/pipeline API并指定CI构建文件？

首先，你提到的通过.gitlab-ci.yml的trigger语法指定子流水线配置的方式是可行的：

trigger_job:
  trigger:
    include:
      - local: path/to/child-pipeline.yml
    strategy: depend

但直接调用/projects/:id/trigger/pipeline API时，传递variable[CI_CONFIG_PATH]确实不会生效——因为CI_CONFIG_PATH属于GitLab的核心预定义变量，它在流水线初始化阶段就会被读取，而API传入的变量是在流水线运行阶段才注入的，所以无法覆盖初始化时的配置路径。

可行的解决方案 #

方案1：自定义变量+项目根配置转发

这是最直接适配API触发的方式：

1. 在项目的CI/CD设置中添加一个自定义变量，比如CUSTOM_CONFIG_PATH
2. 修改项目根目录的.gitlab-ci.yml，添加条件引用逻辑：

   include:
     - local: "${CUSTOM_CONFIG_PATH:-.gitlab-ci.yml}"
   

   这里的:-是Shell参数扩展语法，意思是如果CUSTOM_CONFIG_PATH没设置，就用默认的.gitlab-ci.yml
3. 调用API时传递这个自定义变量即可：

   curl --request POST \
     --header "PRIVATE-TOKEN: $CI_JOB_TOKEN" \
     "https://gitlab.example.com/api/v4/projects/$CI_PROJECT_ID/trigger/pipeline" \
     --form "ref=$CI_COMMIT_REF_NAME" \
     --form "variables[CUSTOM_CONFIG_PATH]=path/to/child-pipeline.yml"
   

方案2：结合动态生成配置的工件传递（适配运行时确定子流水线的场景）

如果你的子流水线配置是父流水线运行时动态生成的，也可以用你提到的工件方案，优化后更简洁：

1. 父流水线中先生成配置文件并上传为工件：

   generate_child_config:
     script:
       - # 这里写你的动态生成逻辑，比如根据运行时条件生成不同的子配置
       - echo "子流水线内容" > child-pipeline.yml
     artifacts:
       paths:
         - child-pipeline.yml
       expire_in: 1h
   

2. 用trigger语法直接引用该工件触发子流水线（不需要额外调用API）：

   run_child_pipeline:
     needs: [generate_child_config]
     trigger:
       include:
         - artifact: child-pipeline.yml
           job: generate_child_config
       strategy: depend
   

   这种方式比API触发更贴合GitLab的流水线生态，也避免了API调用的额外复杂度。

补充说明 #

如果一定要坚持用API触发动态生成的子配置，可以考虑把生成的配置文件推送到项目的临时分支，然后调用API时指定该临时分支——但这种方式需要额外的分支操作，不如上面两种方案高效。

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