通过

CLI (v2) 计算群集 (AmlCompute) YAML 架构

  • 项目

适用于：Azure CLI ml 扩展 v2（当前）

源 JSON 架构可在 https://azuremlschemas.azureedge.net/latest/amlCompute.schema.json 中找到。

注意

本文档中详细介绍的 YAML 语法基于最新版本的 ML CLI v2 扩展的 JSON 架构。 此语法必定仅适用于最新版本的 ML CLI v2 扩展。 可以在 https://azuremlschemasprod.azureedge.net/ 上查找早期扩展版本的架构。

YAML 语法

密钥 类型 说明 允许的值 默认值
$schema 字符串 YAML 架构。 如果使用 Azure 机器学习 VS Code 扩展来创作 YAML 文件，则可通过在文件顶部包含 $schema 来调用架构和资源完成操作。
type 字符串 必需。 计算类型。 amlcompute
name 字符串 必需。 计算名称。
description 字符串 计算说明。
location 字符串 计算位置。 如果省略，则默认为工作区位置。
size 字符串 用于群集的 VM 大小。 有关详细信息，请参阅支持的 VM 系列和大小。 请注意，并非所有大小都可在所有区域中使用。 如需给定区域中支持的大小的列表，请使用 az ml compute list-sizes。 Standard_DS3_v2
tier 字符串 用于群集的 VM 优先级层。 低优先级 VM 是可抢占的，但比专用 VM 的成本更低。 dedicated, low_priority dedicated
min_instances 整型 要在群集上使用的最小节点数。 将最小节点数设置为 0 可使 Azure 机器学习将不使用的群集自动缩减为零个节点。 任何大于 0 的值都会保持运行该数量的节点，即使群集未在使用。 0
max_instances 整型 要在群集上使用的最大节点数。 1
idle_time_before_scale_down 整型 缩减群集之前的节点空闲时间（秒）。 120
ssh_public_access_enabled boolean 是否在群集的节点上启用公共 SSH 访问。 false
ssh_settings object 用于连接到群集的 SSH 设置。
ssh_settings.admin_username 字符串 可用于通过 SSH 连接到节点的管理员用户帐户的名称。
ssh_settings.admin_password 字符串 管理员用户帐户的密码。 必须指定 admin_password 或 ssh_key_value。
ssh_settings.ssh_key_value 字符串 管理员用户帐户的 SSH 公钥。 必须指定 admin_password 或 ssh_key_value。
network_settings object 网络安全设置。
network_settings.vnet_name 字符串 创建新的虚拟网络 (VNet) 或引用现有虚拟网络时的虚拟网络名称。
network_settings.subnet 字符串 创建新 VNet 或引用现有 VNet 时的子网名称，或现有 VNet 中的子网的完全限定资源 ID。 如果指定子网 ID，请不要指定 network_settings.vnet_name。 子网 ID 可以指另一资源组中的 VNet/子网。
identity object 要分配给计算的托管标识配置。 AmlCompute 群集仅支持一个系统分配标识或多个用户分配标识，而不同时支持这两种配置。
identity.type 字符串 要分配给计算的托管标识的类型。 如果类型为 user_assigned，则还必须指定 identity.user_assigned_identities 属性。 system_assigned, user_assigned
identity.user_assigned_identities array 用户分配的标识的完全限定资源 ID 列表。

备注

az ml compute 命令可用于管理 Azure 机器学习计算群集 (AmlCompute)。

示例

示例 GitHub 存储库中提供了示例。 下面显示了几个示例。

YAML：最小

$schema: https://azuremlschemas.azureedge.net/latest/amlCompute.schema.json 
name: minimal-example
type: amlcompute

YAML：基本

$schema: https://azuremlschemas.azureedge.net/latest/amlCompute.schema.json 
name: basic-example
type: amlcompute
size: STANDARD_DS3_v2
min_instances: 0
max_instances: 2
idle_time_before_scale_down: 120

YAML：自定义位置

$schema: https://azuremlschemas.azureedge.net/latest/amlCompute.schema.json 
name: location-example
type: amlcompute
size: STANDARD_DS3_v2
min_instances: 0
max_instances: 2
idle_time_before_scale_down: 120
location: chinaeast2

YAML：低优先级

$schema: https://azuremlschemas.azureedge.net/latest/amlCompute.schema.json 
name: low-pri-example
type: amlcompute
size: STANDARD_DS3_v2
min_instances: 0
max_instances: 2
idle_time_before_scale_down: 120
tier: low_priority

YAML：SSH 用户名和密码

$schema: https://azuremlschemas.azureedge.net/latest/amlCompute.schema.json 
name: ssh-example
type: amlcompute
size: STANDARD_DS3_v2
min_instances: 0
max_instances: 2
idle_time_before_scale_down: 120
ssh_settings:
  admin_username: example-user
  admin_password: example-password

后续步骤