使用Azure DevOps CLI创建Pipeline失败：参数异常与404错误求助

问题详情 #

• 已安装环境：

  >> az --version
  azure-cli                         2.44.1
  
  core                              2.44.1
  telemetry                          1.0.8
  
  Extensions:
  azure-devops                      0.25.0
  
  Dependencies:
  msal                              1.20.0
  azure-mgmt-resource             21.1.0b1
  
  Python location 'C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\python.exe'
  

• 已通过az devops configure --defaults organization=<org> project=<project>设置默认组织和项目
• 执行az pipelines create --name 'MyCi'时，CLI提示Error: The following arguments are required: --repository，但官方文档标注该参数为可选
• 执行完整命令时出现404错误：

  > az pipelines create --name 'NameCI' --description 'pipeline for project' --repository AzureRepo --branch main --repository-type tfsgit
  Error: Page not found.  Operation returned a 404 status code.
  

• 可通过浏览器创建流水线，也能通过CLI删除流水线，但无法通过CLI创建

解决方法 #

1. 理解--repository参数的必填逻辑 #

官方文档标注--repository为可选，是在以下场景下：

• 当前目录已关联Azure DevOps仓库且存在azure-pipelines.yml文件
• 通过--yml-path指定了仓库中的流水线YAML文件路径
  如果没有满足以上任一条件，CLI必须明确指定--repository来确定流水线的源仓库，因此会提示该参数必填。

2. 修复404错误的具体步骤 #

(1) 验证仓库名称/ID的正确性

Azure DevOps CLI对仓库名称的大小写敏感，且必须是项目下存在的仓库。执行以下命令列出当前项目的所有仓库，确认目标仓库的名称或ID：

az repos list --output table

将--repository参数替换为正确的名称或ID，避免拼写错误。

(2) 确认默认组织/项目配置有效性

重新执行配置命令，确保组织和项目的URL/名称完全正确：

az devops configure --defaults organization=https://dev.azure.com/[你的组织名] project=[你的项目名]

也可以在创建命令中显式指定组织和项目参数，跳过默认配置读取：

az pipelines create --name 'NameCI' --description 'pipeline for project' --repository [正确的仓库名/ID] --branch main --repository-type tfsgit --organization https://dev.azure.com/[你的组织名] --project [你的项目名]

(3) 升级AZ CLI及扩展

你的AZ CLI和azure-devops扩展版本较旧，可能存在已知bug。执行以下命令升级：

# 升级AZ CLI
az upgrade
# 升级azure-devops扩展
az extension update --name azure-devops

(4) 检查权限配置

虽然你能删除流水线，但创建流水线需要创建流水线的权限。进入项目设置→权限→流水线，确认你的账号拥有该权限（通常需为项目贡献者及以上角色）。

(5) 指定YAML文件路径

如果仓库中已存在azure-pipelines.yml，可以通过--yml-path参数指定路径，帮助CLI明确流水线配置：

az pipelines create --name 'NameCI' --description 'pipeline for project' --repository [仓库名/ID] --branch main --repository-type tfsgit --yml-path /azure-pipelines.yml

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