如何通过CLI触发Azure ML Designer现有管道（用于CI/CD编排）

前提准备 #

• 安装Azure ML CLI扩展：

  az extension add -n ml
  

• 登录Azure并关联目标ML工作区：

  # 交互式登录（本地测试用）
  az login
  # 设置默认工作区（后续命令无需重复指定）
  az configure --defaults workspace=<你的工作区名称> group=<对应的资源组名称>
  

• 如果是在CI/CD环境中执行，建议使用服务主体登录（避免交互式操作）：

  az login --service-principal -u <服务主体客户端ID> -p <服务主体密码/证书路径> --tenant <Azure租户ID>
  

获取目标管道的标识 #

先列出工作区中所有已发布的Designer管道，找到你要触发的管道ID或名称：

az ml pipeline list

输出会包含管道的id、name等信息，记录下目标管道的对应标识。

触发管道运行 #

基础触发方式

• 通过管道ID触发：

  az ml pipeline create-run --pipeline-id <目标管道ID>
  

• 通过管道名称触发：

  az ml pipeline create-run --name <目标管道名称>
  

带参数触发（如果管道有参数化配置）

如果你的Designer管道定义了可配置参数（比如输入路径、模型超参数），可以通过--parameters传入：

az ml pipeline create-run --pipeline-id <目标管道ID> --parameters input_data="azureml://datastores/<数据存储名称>/paths/<数据路径>" learning_rate=0.001

验证运行状态 #

触发命令执行后，会返回运行的name（即运行ID），可以用以下命令查看运行状态：

az ml job show --name <运行ID>

也可以列出所有管道运行记录，确认目标运行的状态：

az ml pipeline run list

权限说明 #

执行CLI命令的身份（无论是用户还是服务主体）需要拥有Azure ML工作区的Machine Learning Contributor或Contributor角色，确保能触发管道运行。

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