az ml environment

Kommentar

Den här referensen är en del av ML-tillägget för Azure CLI (version 2.15.0 eller senare). Tillägget installeras automatiskt första gången du kör ett az ml-miljökommando . Läs mer om tillägg.

Hantera Azure ML-miljöer.

Azure ML-miljöer definierar körningsmiljön för jobb- och slutpunktsdistributioner, vilket kapslar in beroendena för träning och slutsatsdragning. Dessa miljödefinitioner är inbyggda i Docker-avbildningar.

Kommandon

Name Description Typ Status
az ml environment archive

Arkivera en miljö.

Anknytning Allmän tillgänglighet
az ml environment create

Skapa en miljö.

Anknytning Allmän tillgänglighet
az ml environment list

Visa en lista över miljöer på en arbetsyta.

Anknytning Allmän tillgänglighet
az ml environment restore

Återställa en arkiverad miljö.

Anknytning Allmän tillgänglighet
az ml environment share

Dela en specifik miljö från arbetsyta till register.

Anknytning Allmän tillgänglighet
az ml environment show

Visa information för en miljö.

Anknytning Allmän tillgänglighet
az ml environment update

Uppdatera en miljö.

Anknytning Allmän tillgänglighet

az ml environment archive

Arkivera en miljö.

Om du arkiverar en miljö döljs den som standard från listfrågor (az ml environment list). Du kan fortfarande fortsätta att referera till och använda en arkiverad miljö i dina arbetsflöden. Du kan arkivera antingen en miljöcontainer eller en specifik miljöversion. Om du arkiverar en miljöcontainer arkiveras alla versioner av miljön under det angivna namnet. Du kan återställa en arkiverad miljö med hjälp av az ml environment restore. Om hela miljöcontainern arkiveras kan du inte återställa enskilda versioner av miljön – du måste återställa miljöcontainern.

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

Exempel

Arkivera en miljöcontainer (arkiverar alla versioner av den miljön)

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

Arkivera en specifik miljöversion

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

Obligatoriska parametrar

--name -n

Namnet på miljön.

Valfria parametrar

--label -l

Miljöetikett.

--registry-name

Om det tillhandahålls kommer kommandot att rikta in sig på registret i stället för en arbetsyta. Därför krävs inte resursgrupp och arbetsyta.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--version -v

Version av miljön.

--workspace-name -w

Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med .az configure --defaults workspace=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az ml environment create

Skapa en miljö.

Miljöer kan definieras från en Docker-avbildning, Dockerfile- eller Conda-fil. Azure ML har en uppsättning CPU- och GPU Docker-avbildningar som du kan använda som basavbildningar. Information om dessa bilder finns i https://github.com/Azure/AzureML-Containers.

Den skapade miljön spåras på arbetsytan under det angivna namnet och versionen.

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]

Exempel

Skapa en miljö från en YAML-specifikationsfil

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

Skapa en miljö från en docker-avbildning

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

Skapa en miljö från en byggkontext

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

Skapa en miljö från en conda-specifikation

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

Skapa en miljö i registret från en YAML-specifikationsfil

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

Valfria parametrar

--build-context -b

Lokal sökväg till katalogen som ska användas som en Docker-byggkontext. --build-context/-b och --image/-i är ömsesidigt uteslutande argument.

--conda-file -c

Lokal sökväg till en conda-specifikationsfil. --image/-i måste också anges om det här argumentet används.

--datastore

Det datalager som den lokala artefakten ska laddas upp till.

--description

Beskrivning av miljön.

--dockerfile-path -d

Relativ sökväg till Dockerfile i katalogen som anges av --build-context/-b. Om det utelämnas används "./Dockerfile".

standardvärde: /Dockerfile
--file -f

Lokal sökväg till YAML-filen som innehåller Azure ML-miljöspecifikationen. YAML-referensdokumenten för miljön finns på: https://aka.ms/ml-cli-v2-environment-yaml-reference.

--image -i

Docker-avbildning. --image/-i och --build-context/-b är ömsesidigt uteslutande argument.

--name -n

Namnet på miljön.

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

standardvärde: False
--os-type

Typ av operativsystem. Tillåtna värden: linux, windows. Standard: linux.

--registry-name

Om det tillhandahålls kommer kommandot att rikta in sig på registret i stället för en arbetsyta. Därför krävs inte resursgrupp och arbetsyta.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--set

Uppdatera ett objekt genom att ange en egenskapssökväg och ett värde som ska anges. Exempel: --set property1.property2=.

--tags

Blankstegsavgränsade nyckel/värde-par för objektets taggar.

--version -v

Version av miljön.

--workspace-name -w

Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med .az configure --defaults workspace=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az ml environment list

Visa en lista över miljöer på en arbetsyta.

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

Exempel

Visa en lista över alla miljöer på en arbetsyta

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

Visa en lista över alla miljöversioner för det angivna namnet på en arbetsyta

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

Visa en lista över alla miljöer i en arbetsyta med argumentet --query för att köra en JMESPath-fråga på resultatet av kommandon.

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

Visa en lista över alla miljöer i ett register

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

Visa en lista över alla miljöversioner för det angivna namnet i ett register

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

Valfria parametrar

--archived-only

Lista endast arkiverade miljöer.

standardvärde: False
--include-archived

Visa en lista över arkiverade miljöer och aktiva miljöer.

standardvärde: False
--max-results -r

Maximalt antal resultat som ska returneras.

--name -n

Namnet på miljön. Om detta anges returneras alla miljöversioner under det här namnet.

--registry-name

Om det tillhandahålls kommer kommandot att rikta in sig på registret i stället för en arbetsyta. Därför krävs inte resursgrupp och arbetsyta.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--workspace-name -w

Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med .az configure --defaults workspace=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az ml environment restore

Återställa en arkiverad miljö.

När en arkiverad miljö återställs döljs den inte längre från listfrågor (az ml environment list). Om en hel miljöcontainer arkiveras kan du återställa den arkiverade containern. Detta återställer alla versioner av miljön under det angivna namnet. Du kan inte bara återställa en viss miljöversion om hela miljöcontainern arkiveras – du måste återställa hela containern. Om endast en enskild miljöversion arkiverades kan du återställa den specifika versionen.

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

Exempel

Återställa en arkiverad miljöcontainer (återställer alla versioner av den miljön)

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

Återställa en specifik arkiverad miljöversion

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

Obligatoriska parametrar

--name -n

Namnet på miljön.

Valfria parametrar

--label -l

Miljöetikett.

--registry-name

Om det tillhandahålls kommer kommandot att rikta in sig på registret i stället för en arbetsyta. Därför krävs inte resursgrupp och arbetsyta.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--version -v

Version av miljön.

--workspace-name -w

Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med .az configure --defaults workspace=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az ml environment share

Dela en specifik miljö från arbetsyta till register.

Kopiera en befintlig miljö från en arbetsyta till ett register för återanvändning mellan arbetsytor.

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

Exempel

Dela en befintlig miljö från arbetsyta till register

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

Obligatoriska parametrar

--name -n

Namnet på miljön.

--registry-name

Målregister.

--share-with-name

Namnet på den miljö som ska skapas med.

--share-with-version

Version av miljön som ska skapas med.

--version -v

Version av miljön.

Valfria parametrar

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--workspace-name -w

Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med .az configure --defaults workspace=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az ml environment show

Visa information för en miljö.

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

Exempel

Visa information för en miljö med det angivna namnet och versionen

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

Visa information för en miljö i registret med det angivna namnet och versionen

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

Obligatoriska parametrar

--name -n

Namnet på miljön.

Valfria parametrar

--label -l

Miljöetikett.

--registry-name

Om det tillhandahålls kommer kommandot att rikta in sig på registret i stället för en arbetsyta. Därför krävs inte resursgrupp och arbetsyta.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--version -v

Version av miljön.

--workspace-name -w

Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med .az configure --defaults workspace=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az ml environment update

Uppdatera en miljö.

Endast egenskaperna "description" och "tags" kan uppdateras.

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

Obligatoriska parametrar

--name -n

Namnet på miljön.

Valfria parametrar

--add

Lägg till ett objekt i en lista över objekt genom att ange en sökväg och nyckelvärdepar. Exempel: --add property.listProperty <key=value, string or JSON string>.

standardvärde: []
--force-string

När du använder "set" eller "add" bevarar du strängliteraler i stället för att försöka konvertera till JSON.

standardvärde: False
--label -l

Miljöetikett.

--registry-name

Om det tillhandahålls kommer kommandot att rikta in sig på registret i stället för en arbetsyta. Därför krävs inte resursgrupp och arbetsyta.

--remove

Ta bort en egenskap eller ett element från en lista. Exempel: --remove property.list <indexToRemove> ELLER --remove propertyToRemove.

standardvärde: []
--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--set

Uppdatera ett objekt genom att ange en egenskapssökväg och ett värde som ska anges. Exempel: --set property1.property2=<value>.

standardvärde: []
--version -v

Version av miljön.

--workspace-name -w

Namnet på Azure ML-arbetsytan. Du kan konfigurera standardarbetsytan med .az configure --defaults workspace=<name>

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.