文档中心

持续交付

YAML 语法

流水线源 sources

流水线源（sources）用于声明触发流水线的代码源与物料，定义 "流水线从哪里来、因何而起"。通过 sources 块，您可以接入 GitHub、GitLab 等多种代码仓库，配置分支过滤、路径过滤及事件触发等规则，并支持同时配置多个代码源。

说明

Pipeline as Code 中，代码源仅支持通过服务连接方式接入。创建服务连接的方法参见服务连接。

YAML 示例

sources:​
    - name: svcconn-demo​
      type: Gitee​
      url: https://gitee.com/volc-code-pipeline/demo.git​
      branch: master​
      credential:​
        type: serviceConnection​
        serviceConnectionId: ctAIccWNZvRLkgffPWXF​
      trigger:​
        triggerExecutionType: AllEvents​
        autoPRComment: ​
            commentRule: PipelineStatus​
        triggerEvents:​
          - eventType: Push​
            branchFilters:​
              - master​
              - dev​

基础配置项

配置项	是否必填	说明
name	是	代码源名称。流水线运行时，会将源文件下载至 /workspace 目录下。名称需要符合以下要求：只能包含小写字母（a-z）、数字（0-9）、中划线（-）。以小写字母或者数字开头。以小写字母或者数字结尾。长度为 1~40 个字符。
type	是	代码源类型，支持代码源类型参见代码源概述。
url	是	代码源仓库地址，支持 HTTPS 协议。
branch	是	流水线运行分支。
branchMode	否	是否打开分支模式。仅允许一个代码源打开分支模式。 true：打开分支模式。 false：默认值，不打开分支模式。
branchMode.baseBranch	否	打开分支模式时必填。分支模式中拉取代码的基础分支。
cloneDepth	否	克隆深度值代表克隆最近的版本数。 0 ：克隆所有版本。 1：默认值，克隆最近一个版本。

授权配置

配置项	是否必填	说明
credential	是	克隆代码源的授权信息。
credential.type	是	固定填写 serviceConnection，表示使用服务连接。
credential.serviceConnectionId	是	服务连接 ID，支持前往全局设置 > 服务连接，在服务列表中查看目标服务连接的 ID。

触发器配置

配置项	是否必填	说明
trigger	否	配置代码源触发器，未配置时，无法通过代码源事件触发流水线。
trigger.triggerEvents.eventType	是	说明不同代码源支持的触发事件可能不同，详细请参见代码源触发器。触发事件类型，取值如下： Push：代码推送事件，常用于主干与特性分支的持续集成。 CreateTag：Tag 创建事件，常用于版本发布。 PRMerged：合并请求完成后事件。 PRUpdated：合并请求新建或更新事件，常用于预合并校验。
trigger.triggerEvents.branchFilters	否	分支过滤列表，支持填写分支名称或 Go 语言正则表达式。
trigger.triggerExecutionType	否	触发事件执行的类型，取值如下： OnlyLatest ：仅最新事件触发执行。 AllEvents：全部事件触发执行。
trigger.triggerExecutionType.autoPRComment.commentRule	否	流水线执行完成后，自动在合并请求（PR）中回复评论。仅当 eventType 为 PRUpdated 时生效。取值如下： PipelineTaskStatus：评论包含流水线运行状态和各任务运行状态。 PipelineStatus：评论仅包含流水线运行状态。 None：不自动评论。

最近更新时间：2026.05.11 11:33:35

这个页面对您有帮助吗？

有用

无用