Help Center/ CodeArts Pipeline/ User Guide/ Configuring a Pipeline/ Configuring Pipeline Extensions/ Subpipeline
Updated on 2025-08-13 GMT+08:00
View PDF
Share

Subpipeline

Call the Subpipeline extension to configure other pipelines in a project.

Adding the Extension with GUI

Add the Subpipeline extension when you orchestrate a pipeline. Set parameters as shown in Table 1.

Table 1 Parameter description

Parameter

Description

Name

Extension name, which can be customized.

  • Enter only letters, digits, hyphens (-), underscores (_), commas (,), semicolons (;), colons (:), periods (.), slashes (/), parentheses (), and spaces.
  • Enter 1 to 128 characters.

Select Task

Select other pipelines in the current project to be called.

Branch/Tag

Set the branch or tag for the sub-pipeline. You can select Use subpipeline default branch/tag or Use parent pipeline branch/tag.

Adding the Extension with YAML

Add the Subpipeline extension when you orchestrate a pipeline. Configure the YAML syntax as follows:

  • Subpipeline 
    uses: SubPipeline
with:
  pipelineId: 80ea2d9ffba94c20b9a0a0be47d3a0d8
  branch: master
    • pipelineId: ID of the called pipeline.
    • branch: (Optional) Branch used for running the sub-pipeline.
      • The default branch of the sub-pipeline is used if this parameter is not set.
      • You can reference a parameter or context to define branch. For example, if you want to run the parent pipeline source, and the code source alias is my_repo, the reference format is ${{sources.my_repo.target_branch}}.