Freigeben über

CLI (v2) Computecluster (AmlCompute) YAML-Schema

  • Artikel

GILT FÜR Azure CLI-ML-Erweiterung v2 (aktuell)

Das JSON-Quellschema finden Sie unter https://azuremlschemas.azureedge.net/latest/amlCompute.schema.json.

Hinweis

Die in diesem Dokument beschriebene YAML-Syntax basiert auf dem JSON-Schema für die neueste Version der ML CLI v2-Erweiterung. Die Funktion dieser Syntax wird nur mit der neuesten Version der ML CLI v2-Erweiterung garantiert. Die Schemas für ältere Erweiterungsversionen finden Sie unter https://azuremlschemasprod.azureedge.net/.

YAML-Syntax

Schlüssel type BESCHREIBUNG Zulässige Werte Standardwert
$schema Zeichenfolge Das YAML-Schema. Wenn Sie die VS Code-Erweiterung für Azure Machine Learning zum Erstellen einer YAML-Datei verwenden, können Sie durch das Einfügen von $schema am Anfang der Datei Schema- und Ressourcenvervollständigungen aufrufen.
type Zeichenfolge Erforderlich. Der Computetyp. amlcompute
name Zeichenfolge Erforderlich. Der Computename.
description Zeichenfolge Die Computebeschreibung.
location Zeichenfolge Der Computespeicherort. Wenn nicht angegeben, wird standardmäßig der Speicherort des Arbeitsbereichs verwendet.
size Zeichenfolge Die VM-Größe, die für den Cluster verwendet werden soll. Weitere Informationen finden Sie unter Unterstützte VM-Serien und Größen. Beachten Sie, dass nicht alle Größen in allen Regionen verfügbar sind. Für die Liste der unterstützten Größen in einer bestimmten Region verwenden Sie bitte az ml compute list-sizes. Standard_DS3_v2
tier Zeichenfolge Die VM-Prioritätsebene, die für den Cluster verwendet werden soll. VMs mit niedriger Priorität sind präemptiv, aber im Vergleich zu dedizierten VMs zu geringeren Kosten. dedicated, low_priority dedicated
min_instances integer Die Mindestanzahl von Knoten, die im Cluster verwendet werden. Wenn Sie die Mindestanzahl von Knoten auf 0 festlegen, kann Azure Machine Learning den Cluster automatisch auf null Knoten herunterskalieren, wenn er nicht verwendet wird. Bei jedem Wert größer als 0 wird die entsprechende Anzahl von Knoten weiter ausgeführt, auch wenn der Cluster nicht verwendet wird. 0
max_instances integer Die maximale Anzahl von Knoten, die im Cluster verwendet werden. 1
idle_time_before_scale_down integer Die Leerlaufzeit des Knotens in Sekunden vor dem herunterskalieren des Clusters. 120
ssh_public_access_enabled boolean Gibt an, ob der öffentliche SSH-Zugriff auf die Knoten des Clusters aktiviert werden soll. false
ssh_settings Objekt SSH-Einstellungen zum Herstellen einer Verbindung mit dem Cluster.
ssh_settings.admin_username Zeichenfolge Der Name des Administratorbenutzerkontos, das für die SSH-Verbindung mit Knoten verwendet werden kann.
ssh_settings.admin_password Zeichenfolge Das Kennwort des Administratorbenutzerkontos. Entweder admin_password oder ssh_key_value ist erforderlich.
ssh_settings.ssh_key_value Zeichenfolge Der öffentliche SSH-Schlüssel des Administratorbenutzerkontos. Entweder admin_password oder ssh_key_value ist erforderlich.
network_settings Objekt Einstellungen zur Netzwerksicherheit.
network_settings.vnet_name Zeichenfolge Name des virtuellen Netzes (VNet) bei der Erstellung eines neuen Netzes oder beim Verweis auf ein bestehendes Netz.
network_settings.subnet Zeichenfolge Entweder der Name des Subnetzes beim Erstellen eines neuen VNet oder das Verweisen auf ein vorhandenes VNet oder die vollqualifizierte Ressourcen-ID eines Subnetzes in einem bestehenden VNet. Geben Sie network_settings.vnet_name nicht an, wenn die Subnetz-ID angegeben ist. Die Subnetz-ID kann sich auf ein VNet/Subnetz in einer anderen Ressourcengruppe beziehen.
identity Objekt Die Konfiguration der verwalteten Identität, die dem Compute zugewiesen werden soll. AmlCompute-Cluster unterstützen nur eine systemseitig zugewiesene Identität oder mehrere benutzerseitig zugewiesene Identitäten, nicht beides gleichzeitig.
identity.type Zeichenfolge Der Typ der verwalteten Identität, die dem Compute zugewiesen werden soll. Wenn der Typ user_assigned ist, muss auch die Eigenschaft identity.user_assigned_identities angegeben werden. system_assigned, user_assigned
identity.user_assigned_identities array Liste der vollqualifizierten Ressourcen-IDs der vom Benutzer zugewiesenen Identitäten.

Bemerkungen

Die Befehle az ml compute können zum Verwalten von Azure Machine Learning Computeclustern (AmlCompute) verwendet werden.

Beispiele

Beispiele finden Sie im GitHub-Beispielrepository. Im Folgenden sind mehrere aufgeführt.

YAML: minimal

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

YAML: grundlegend

$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: benutzerdefinierter Standort

$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: niedrige Priorität

$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-Benutzername und Kennwort

$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

Nächste Schritte