Azure DevOps Python SDK创建YAML管道：路径参数为空报错及配置方法

问题根源 #

你遇到的Value cannot be null. Parameter name: Path错误，是因为使用了通用的CreatePipelineConfigurationParameters类创建YAML管道，这个类不包含YAML路径和仓库的配置项，导致SDK无法获取必要的管道定义信息。

正确配置方法 #

在v7_1版本的SDK中，需要使用专门针对YAML管道的CreatePipelineYamlConfigurationParameters类来配置路径和仓库，而非通用的CreatePipelineConfigurationParameters。

完整示例代码 #

from azure.devops.v7_1.pipelines.models import (
    CreatePipelineParameters,
    CreatePipelineYamlConfigurationParameters,
    RepositoryProperties
)

self.pipeline_name = pipeline_name

# 1. 配置仓库信息：指定仓库名称、所属项目、目标分支
repo_props = RepositoryProperties(
    name="你的仓库名称",
    project=project_name,
    ref_name="refs/heads/main"  # 替换为你的分支，格式为refs/heads/分支名
)

# 2. 创建YAML管道配置：指定YAML文件路径和仓库
yaml_config = CreatePipelineYamlConfigurationParameters(
    type="yaml",
    path="azure-pipelines.yml",  # YAML文件在仓库中的相对路径，比如"pipelines/build.yml"
    repository=repo_props
)

# 3. 组装管道参数并创建管道
pipeline_params = CreatePipelineParameters(
    configuration=yaml_config,
    name=self.pipeline_name
)

pipeline_response = self.pipeline_client.create_pipeline(pipeline_params, project=project_name)
print(pipeline_response)

关键参数说明 #

• path：必填，YAML文件在仓库中的相对路径，比如根目录的azure-pipelines.yml，或者子目录下的deploy/pipeline.yml
• repository：必填，通过RepositoryProperties对象指定仓库信息：
  • 可以用name+project定位仓库，也可以直接传入仓库的id参数（如果已获取仓库ID）
  • ref_name指定管道使用的分支，格式必须是refs/heads/分支名（比如refs/heads/dev）

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