CLI (v2) 计算群集 (AmlCompute) YAML 架构
源 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 ML 将不使用的群集自动缩减为零个节点。 任何大于 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