GitLab主流水线调用的各子流水线间如何传递文件？

针对你通过父流水线触发多阶段子流水线、需要在子流水线间传递生成文件的场景，以下是几种可行的实现方案：

1. 跨项目工件共享（Cross-Project Artifacts） #

利用GitLab的跨项目工件功能，让后续子流水线直接拉取前序子流水线生成的工件文件。

操作步骤： #

• 在生成文件的子流水线（如devops/proxmox-tf）中配置工件上传：

# devops/proxmox-tf的.gitlab-ci.yml
terraform_deploy:
  script:
    terraform apply -auto-approve
    # 生成ansible inventory文件
    terraform output -json | jq -r '...' > inventory.ini # 替换为实际生成逻辑
  artifacts:
    paths:
      - inventory.ini
    expire_in: 1 week # 设置过期时间，避免存储冗余

• 在依赖文件的子流水线（如devops/ansible-post-install）中，通过needs拉取跨项目工件：

# devops/ansible-post-install的.gitlab-ci.yml
ansible_config:
  script:
    ansible-playbook -i inventory.ini post-install.yml
  needs:
    - project: devops/proxmox-tf
      job: terraform_deploy
      ref: master
      artifacts: true

注意：需确保项目间已配置跨项目访问权限，允许读取工件。

2. 共享代码仓库同步文件 #

将各阶段生成的文件提交到一个专门的共享仓库，后续子流水线从该仓库拉取所需文件。

操作步骤： #

• 在Terraform子流水线中添加文件提交逻辑：

# devops/proxmox-tf的.gitlab-ci.yml
terraform_deploy:
  script:
    terraform apply -auto-approve
    terraform output -json | jq -r '...' > inventory.ini
    # 克隆共享仓库并提交文件
    git clone https://gitlab-ci-token:${CI_JOB_TOKEN}@gitlab.example.com/devops/shared-artifacts.git
    cp inventory.ini shared-artifacts/
    cd shared-artifacts
    git config user.name "GitLab CI"
    git config user.email "ci@gitlab.example.com"
    git add inventory.ini
    git commit -m "Update inventory from pipeline ${CI_PIPELINE_ID}"
    git push origin master

• 在Ansible子流水线中拉取共享仓库文件：

# devops/ansible-post-install的.gitlab-ci.yml
ansible_config:
  script:
    git clone https://gitlab-ci-token:${CI_JOB_TOKEN}@gitlab.example.com/devops/shared-artifacts.git
    ansible-playbook -i shared-artifacts/inventory.ini post-install.yml

3. 父流水线中转工件 #

通过父流水线收集每个子流水线的工件，再传递给后续阶段的子流水线。

修改父流水线配置： #

stages:
    - terraform
    - ansible-config
    - ansible-k3s
    - helm
 
workflow:
    rules:
        - if: '$CI_PIPELINE_SOURCE == "web"'
          when: always
        - when: never
 
terraform:
    stage: terraform
    trigger:
        project: devops/proxmox-tf
        branch: master
        strategy: depend
    artifacts:
      paths:
        - inventory.ini
      expire_in: 1 week
 
ansible-config:
    stage: ansible-config
    trigger:
        project: devops/ansible-post-install
        branch: master
        strategy: depend
    needs: [terraform]
    artifacts:
      paths:
        - k3s_cluster_config.yaml
      expire_in: 1 week

后续子流水线可通过needs引用父流水线对应阶段的工件，获取所需文件。

4. CI/CD变量传递小体量内容 #

如果生成的文件内容较少（如IP列表、配置参数），可将内容转为CI/CD变量传递。

操作步骤： #

• 在Terraform子流水线中设置变量：

# devops/proxmox-tf的.gitlab-ci.yml
terraform_deploy:
  script:
    terraform apply -auto-approve
    INVENTORY_CONTENT=$(cat inventory.ini)
    # 通过API设置项目级变量（或传递给父流水线）
    curl --request POST --header "PRIVATE-TOKEN: ${CI_PROJECT_TOKEN}" \
      "https://gitlab.example.com/api/v4/projects/${CI_PROJECT_ID}/variables" \
      --form "key=INVENTORY_CONTENT" --form "value=${INVENTORY_CONTENT}" --form "protected=false"

• 在Ansible子流水线中还原文件：

# devops/ansible-post-install的.gitlab-ci.yml
ansible_config:
  script:
    echo "${INVENTORY_CONTENT}" > inventory.ini
    ansible-playbook -i inventory.ini post-install.yml

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