CLI （v2） 計算叢集 （AmlCompute） YAML 架構
您可以在 找到 https://azuremlschemas.azureedge.net/latest/amlCompute.schema.json來源 JSON 架構。
注意
本文件中詳述的 YAML 語法是以最新版 ML CLI v2 延伸模組的 JSON 結構描述為基礎。 此語法僅保證能與最新版的 ML CLI v2 延伸模組搭配運作。 您可以在 https://azuremlschemasprod.azureedge.net/ 找到舊版延伸模組的結構描述。
YAML 語法
| 機碼 | 類型 | 描述 | 允許的值 | 預設值 |
|---|---|---|---|---|
$schema |
string | YAML 結構描述。 如果您使用 Azure Machine Learning VS Code 擴充功能來撰寫 YAML 檔案，在檔案頂端包含 $schema 可讓您叫用結構描述和資源完成。 |
||
type |
string | 必要。 計算的類型。 | 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 |
字串 | 建立新的虛擬網路時，或參考現有虛擬網路的名稱。 | ||
network_settings.subnet |
字串 | 建立新的 VNet 或參考現有 VNet 或現有 VNet 中子網的完整資源識別碼時，子網的名稱。 請勿指定 network_settings.vnet_name 是否指定子網標識碼。 子網識別碼可以參考另一個資源群組中的 VNet/子網路。 |
||
identity |
object | 要指派給計算的受控識別組態。 AmlCompute 叢集僅支援一個系統指派的身分識別或多個使用者指派的身分識別，而非同時支援這兩者。 | ||
identity.type |
字串 | 要指派給計算的受控識別類型。 如果類型為 user_assigned，則也必須指定 identity.user_assigned_identities 屬性。 |
system_assigned, user_assigned |
|
identity.user_assigned_identities |
陣列 | 使用者指派身分識別的完整資源識別碼清單。 |
備註
命令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