通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

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
min_instances 整型 要在群集上使用的最小节点数。 将最小节点数设置为 0 可使 Azure 机器学习将不使用的群集自动缩减为零个节点。 任何大于 0 的值都会保持运行该数量的节点，即使群集未在使用。 0
max_instances 整型 要在群集上使用的最大节点数。 1
idle_time_before_scale_down 整型 缩减群集之前的节点空闲时间（秒）。 120
ssh_public_access_enabled 布尔 是否在群集的节点上启用公共 SSH 访问。 false
ssh_settings 物体 用于连接到群集的 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 物体 网络安全设置。
network_settings.vnet_name 字符串 创建新的虚拟网络 (VNet) 或引用现有虚拟网络时的虚拟网络名称。
network_settings.subnet 字符串 创建新 VNet 或引用现有 VNet 时的子网名称，或现有 VNet 中的子网的完全限定资源 ID。 如果指定子网 ID，请不要指定 network_settings.vnet_name。 子网 ID 可以指另一资源组中的 VNet/子网。
identity 物体 要分配给计算的托管标识配置。 AmlCompute 群集仅支持一个系统分配标识或多个用户分配标识，而不同时支持这两种配置。
identity.type 字符串 要分配给计算的托管标识的类型。 如果类型为 user_assigned，则还必须指定 identity.user_assigned_identities 属性。 %>
identity.user_assigned_identities 数组 用户分配的标识的完全限定资源 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: westus

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

后续步骤