Freigeben über

az ml environment

  • Referenz

Anmerkung

Diese Referenz ist Teil der ml Erweiterung für die Azure CLI (Version 2.15.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie zum ersten Mal eine az ml-Umgebung Befehl ausführen. Erfahren Sie mehr über Erweiterungen.

Verwalten von Azure ML-Umgebungen.

Azure ML-Umgebungen definieren die Ausführungsumgebung für Aufträge und Endpunktbereitstellungen, Kapseln der Abhängigkeiten für Schulungen und Rückschlüsse. Diese Umgebungsdefinitionen sind in Docker-Images integriert.

Befehle

Name Beschreibung Typ Status
az ml environment archive

Archiven einer Umgebung.

 Erweiterung GA
az ml environment create

Erstellen Sie eine Umgebung.

 Erweiterung GA
az ml environment list

Listen von Umgebungen in einem Arbeitsbereich auf.

 Erweiterung GA
az ml environment restore

Stellen Sie eine archivierte Umgebung wieder her.

 Erweiterung GA
az ml environment share

Teilen Sie eine bestimmte Umgebung von Arbeitsbereich zu Registrierung.

 Erweiterung GA
az ml environment show

Details für eine Umgebung anzeigen.

 Erweiterung GA
az ml environment update

Aktualisieren sie eine Umgebung.

 Erweiterung GA

az ml environment archive

Archiven einer Umgebung.

Durch das Archivieren einer Umgebung wird sie standardmäßig in Listenabfragen (az ml environment list) ausgeblendet. Sie können weiterhin auf eine archivierte Umgebung in Ihren Workflows verweisen und verwenden. Sie können entweder einen Umgebungscontainer oder eine bestimmte Umgebungsversion archiven. Durch das Archivieren eines Umgebungscontainers werden alle Versionen der Umgebung unter diesem angegebenen Namen archiviert. Sie können eine archivierte Umgebung mithilfe von az ml environment restorewiederherstellen. Wenn der gesamte Umgebungscontainer archiviert wird, können Sie einzelne Versionen der Umgebung nicht wiederherstellen . Sie müssen den Umgebungscontainer wiederherstellen.

az ml environment archive --name
                          [--label]
                          [--registry-name]
                          [--resource-group]
                          [--version]
                          [--workspace-name]

Beispiele

Archivieren eines Umgebungscontainers (archiviert alle Versionen dieser Umgebung)

az ml environment archive --name my-env --resource-group my-resource-group --workspace-name my-workspace

Archiv a specific environment version

az ml environment archive --name my-env --version 1 --resource-group my-resource-group --workspace-name my-workspace

Erforderliche Parameter

--name -n

Name der Umgebung.

Optionale Parameter

--label -l

Bezeichnung der Umgebung.

--registry-name

Wenn angegeben, zielt der Befehl auf die Registrierung anstelle eines Arbeitsbereichs ab. Daher sind Ressourcengruppen und Arbeitsbereiche nicht erforderlich.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

--version -v

Version der Umgebung.

--workspace-name -w

Name des Azure ML-Arbeitsbereichs. Sie können den Standardarbeitsbereich mithilfe von az configure --defaults workspace=<name>konfigurieren.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az ml environment create

Erstellen Sie eine Umgebung.

Umgebungen können aus einer Docker-Image-, Dockerfile- oder Conda-Datei definiert werden. Azure ML verwaltet eine Reihe von CPU- und GPU-Docker-Images, die Sie als Basisimages verwenden können. Informationen zu diesen Bildern finden Sie unter https://github.com/Azure/AzureML-Containers.

Die erstellte Umgebung wird im Arbeitsbereich unter dem angegebenen Namen und der angegebenen Version nachverfolgt.

az ml environment create [--build-context]
                         [--conda-file]
                         [--datastore]
                         [--description]
                         [--dockerfile-path]
                         [--file]
                         [--image]
                         [--name]
                         [--no-wait]
                         [--os-type]
                         [--registry-name]
                         [--resource-group]
                         [--set]
                         [--tags]
                         [--version]
                         [--workspace-name]

Beispiele

Erstellen einer Umgebung aus einer YAML-Spezifikationsdatei

az ml environment create --file my_env.yml --resource-group my-resource-group --workspace-name my-workspace

Erstellen einer Umgebung aus einem Docker-Image

az ml environment create --name my-env --version 1 --file my_env.yml  --image pytorch/pytorch --resource-group my-resource-group --workspace-name my-workspace

Erstellen einer Umgebung aus einem Buildkontext

az ml environment create --name my-env --version 1 --file my_env.yml  --build-context envs/context/ --dockerfile-path Dockerfile --resource-group my-resource-group --workspace-name my-workspace

Erstellen einer Umgebung aus einer Conda-Spezifikation

az ml environment create --name my-env --version 1 --file my_env.yml  --conda-file conda_dep.yml --image mcr.microsoft.com/azureml/openmpi3.1.2-ubuntu18.04 --resource-group my-resource-group --workspace-name my-workspace

Erstellen einer Umgebung in der Registrierung aus einer YAML-Spezifikationsdatei

az ml environment create --file my_env.yml --registry-name my-registry-name --resource-group my-resource-group

Optionale Parameter

--build-context -b

Lokaler Pfad zum Verzeichnis, das als Docker-Buildkontext verwendet werden soll. --build-context/-b und --image/-i sind sich gegenseitig ausschließende Argumente.

--conda-file -c

Lokaler Pfad zu einer Conda-Spezifikationsdatei. --image/-i muss auch angegeben werden, wenn dieses Argument verwendet wird.

--datastore

Der Datenspeicher, in den das lokale Artefakt hochgeladen werden soll.

--description

Beschreibung der Umgebung.

--dockerfile-path -d

Relativer Pfad zur Dockerfile-Datei innerhalb des durch --build-context/-b angegebenen Verzeichnisses. Wenn nicht angegeben, wird "./Dockerfile" verwendet.

Standardwert: /Dockerfile
--file -f

Lokaler Pfad zur YAML-Datei, die die Azure ML-Umgebungsspezifikation enthält. Die YAML-Referenzdokumente für Die Umgebung finden Sie unter: https://aka.ms/ml-cli-v2-environment-yaml-reference.

--image -i

Docker-Image. --image/-i und --build-context/-b sind sich gegenseitig ausschließende Argumente.

--name -n

Name der Umgebung.

--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Standardwert: False
--os-type

Typ des Betriebssystems. Zulässige Werte: Linux, Fenster. Standard: linux.

--registry-name

Wenn angegeben, zielt der Befehl auf die Registrierung anstelle eines Arbeitsbereichs ab. Daher sind Ressourcengruppen und Arbeitsbereiche nicht erforderlich.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

--set

Aktualisieren Sie ein Objekt, indem Sie einen festzulegenden Eigenschaftspfad und -wert angeben. Beispiel: --set property1.property2=value.

--tags

Leerzeichentrennte Schlüssel-Wert-Paare für die Tags des Objekts.

--version -v

Version der Umgebung.

--workspace-name -w

Name des Azure ML-Arbeitsbereichs. Sie können den Standardarbeitsbereich mithilfe von az configure --defaults workspace=<name>konfigurieren.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az ml environment list

Listen von Umgebungen in einem Arbeitsbereich auf.

az ml environment list [--archived-only]
                       [--include-archived]
                       [--max-results]
                       [--name]
                       [--registry-name]
                       [--resource-group]
                       [--workspace-name]

Beispiele

Auflisten aller Umgebungen in einem Arbeitsbereich

az ml environment list --resource-group my-resource-group --workspace-name my-workspace

Auflisten aller Umgebungsversionen für den angegebenen Namen in einem Arbeitsbereich

az ml environment list --name my-env --resource-group my-resource-group --workspace-name my-workspace

Auflisten aller Umgebungen in einem Arbeitsbereich mithilfe des Arguments --query zum Ausführen einer JMESPath-Abfrage für die Ergebnisse von Befehlen.

az ml environment list --query "[].{Name:name}"  --output table --resource-group my-resource-group --workspace-name my-workspace

Auflisten aller Umgebungen in einer Registrierung

az ml environment list --registry-name my-registry-name --resource-group my-resource-group

Auflisten aller Umgebungsversionen für den angegebenen Namen in einer Registrierung

az ml environment list --name my-env --registry-name my-registry-name --resource-group my-resource-group

Optionale Parameter

--archived-only

Nur archivierte Umgebungen auflisten.

Standardwert: False
--include-archived

Auflisten archivierter Umgebungen und aktiver Umgebungen.

Standardwert: False
--max-results -r

Maximale Anzahl der zurückzugebenden Ergebnisse.

--name -n

Name der Umgebung. Wenn angegeben, werden alle Umgebungsversionen unter diesem Namen zurückgegeben.

--registry-name

Wenn angegeben, zielt der Befehl auf die Registrierung anstelle eines Arbeitsbereichs ab. Daher sind Ressourcengruppen und Arbeitsbereiche nicht erforderlich.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

--workspace-name -w

Name des Azure ML-Arbeitsbereichs. Sie können den Standardarbeitsbereich mithilfe von az configure --defaults workspace=<name>konfigurieren.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az ml environment restore

Stellen Sie eine archivierte Umgebung wieder her.

Wenn eine archivierte Umgebung wiederhergestellt wird, wird sie nicht mehr aus Listenabfragen (az ml environment list) ausgeblendet. Wenn ein vollständiger Umgebungscontainer archiviert wird, können Sie diesen archivierten Container wiederherstellen. Dadurch werden alle Versionen der Umgebung unter diesem angegebenen Namen wiederhergestellt. Sie können nicht nur eine bestimmte Umgebungsversion wiederherstellen, wenn der gesamte Umgebungscontainer archiviert wird . Sie müssen den gesamten Container wiederherstellen. Wenn nur eine einzelne Umgebungsversion archiviert wurde, können Sie diese bestimmte Version wiederherstellen.

az ml environment restore --name
                          [--label]
                          [--registry-name]
                          [--resource-group]
                          [--version]
                          [--workspace-name]

Beispiele

Wiederherstellen eines archivierten Umgebungscontainers (stellt alle Versionen dieser Umgebung wieder her)

az ml environment restore --name my-env --resource-group my-resource-group --workspace-name my-workspace

Wiederherstellen einer bestimmten archivierten Umgebungsversion

az ml environment restore --name my-env --version 1 --resource-group my-resource-group --workspace-name my-workspace

Erforderliche Parameter

--name -n

Name der Umgebung.

Optionale Parameter

--label -l

Bezeichnung der Umgebung.

--registry-name

Wenn angegeben, zielt der Befehl auf die Registrierung anstelle eines Arbeitsbereichs ab. Daher sind Ressourcengruppen und Arbeitsbereiche nicht erforderlich.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

--version -v

Version der Umgebung.

--workspace-name -w

Name des Azure ML-Arbeitsbereichs. Sie können den Standardarbeitsbereich mithilfe von az configure --defaults workspace=<name>konfigurieren.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az ml environment share

Teilen Sie eine bestimmte Umgebung von Arbeitsbereich zu Registrierung.

Kopieren Sie eine vorhandene Umgebung aus einem Arbeitsbereich in eine Registrierung für die Wiederverwendung von Arbeitsbereichen.

az ml environment share --name
                        --registry-name
                        --share-with-name
                        --share-with-version
                        --version
                        [--resource-group]
                        [--workspace-name]

Beispiele

Freigeben einer vorhandenen Umgebung von Arbeitsbereich zu Registrierung

az ml environment share --name my-environment --version my-version --resource-group my-resource-group --workspace-name my-workspace --share-with-name new-name-in-registry --share-with-version new-version-in-registry --registry-name my-registry

Erforderliche Parameter

--name -n

Name der Umgebung.

--registry-name

Zielregistrierung.

--share-with-name

Name der Umgebung, mit der erstellt werden soll.

--share-with-version

Version der Umgebung, mit der erstellt werden soll.

--version -v

Version der Umgebung.

Optionale Parameter

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

--workspace-name -w

Name des Azure ML-Arbeitsbereichs. Sie können den Standardarbeitsbereich mithilfe von az configure --defaults workspace=<name>konfigurieren.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az ml environment show

Details für eine Umgebung anzeigen.

az ml environment show --name
                       [--label]
                       [--registry-name]
                       [--resource-group]
                       [--version]
                       [--workspace-name]

Beispiele

Anzeigen von Details für eine Umgebung mit dem angegebenen Namen und der angegebenen Version

az ml environment show --name my-env --version 1 --resource-group my-resource-group --workspace-name my-workspace

Anzeigen von Details zu einer Umgebung in der Registrierung mit dem angegebenen Namen und der angegebenen Version

az ml environment show --name my-env --version 1 --registry-name my-registry-name --resource-group my-resource-group

Erforderliche Parameter

--name -n

Name der Umgebung.

Optionale Parameter

--label -l

Bezeichnung der Umgebung.

--registry-name

Wenn angegeben, zielt der Befehl auf die Registrierung anstelle eines Arbeitsbereichs ab. Daher sind Ressourcengruppen und Arbeitsbereiche nicht erforderlich.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

--version -v

Version der Umgebung.

--workspace-name -w

Name des Azure ML-Arbeitsbereichs. Sie können den Standardarbeitsbereich mithilfe von az configure --defaults workspace=<name>konfigurieren.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az ml environment update

Aktualisieren sie eine Umgebung.

Nur die Eigenschaften "description" und "tags" können aktualisiert werden.

az ml environment update --name
                         [--add]
                         [--force-string]
                         [--label]
                         [--registry-name]
                         [--remove]
                         [--resource-group]
                         [--set]
                         [--version]
                         [--workspace-name]

Erforderliche Parameter

--name -n

Name der Umgebung.

Optionale Parameter

--add

Fügen Sie einer Liste von Objekten ein Objekt hinzu, indem Sie ein Pfad- und Schlüsselwertpaar angeben. Beispiel: --add property.listProperty <key=value, string or JSON string>.

Standardwert: []
--force-string

Wenn Sie "set" oder "add" verwenden, behalten Sie Zeichenfolgenliterale bei, anstatt zu versuchen, in JSON zu konvertieren.

Standardwert: False
--label -l

Bezeichnung der Umgebung.

--registry-name

Wenn angegeben, zielt der Befehl auf die Registrierung anstelle eines Arbeitsbereichs ab. Daher sind Ressourcengruppen und Arbeitsbereiche nicht erforderlich.

--remove

Entfernen sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list <indexToRemove> ODER --remove propertyToRemove.

Standardwert: []
--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

--set

Aktualisieren Sie ein Objekt, indem Sie einen festzulegenden Eigenschaftspfad und -wert angeben. Beispiel: --set property1.property2=<value>.

Standardwert: []
--version -v

Version der Umgebung.

--workspace-name -w

Name des Azure ML-Arbeitsbereichs. Sie können den Standardarbeitsbereich mithilfe von az configure --defaults workspace=<name>konfigurieren.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.