Delen via

az ml environment

Note

Deze verwijzing maakt deel uit van de ml-extensie voor de Azure CLI (versie 2.15.0 of hoger). De extensie installeert automatisch de eerste keer dat u een az ml environment opdracht uitvoert. Meer informatie over uitbreidingen.

Azure ML-omgevingen beheren.

Azure ML-omgevingen definiëren de uitvoeringsomgeving voor taken en eindpuntimplementaties, waarbij de afhankelijkheden voor training en deductie worden ingekapseld. Deze omgevingsdefinities zijn ingebouwd in Docker-installatiekopieën.

Opdracht

Name Description Type Status
az ml environment archive

Een omgeving archiveren.

 Extension GA
az ml environment create

Maak een omgeving.

 Extension GA
az ml environment list

Maak een lijst met omgevingen in een werkruimte.

 Extension GA
az ml environment restore

Een gearchiveerde omgeving herstellen.

 Extension GA
az ml environment share

Een specifieke omgeving delen van werkruimte naar register.

 Extension GA
az ml environment show

Details voor een omgeving weergeven.

 Extension GA
az ml environment update

Een omgeving bijwerken.

 Extension GA

az ml environment archive

Een omgeving archiveren.

Als u een omgeving archivert, wordt deze standaard verborgen in lijstquery's (az ml environment list). U kunt nog steeds verwijzen naar en een gearchiveerde omgeving in uw werkstromen gebruiken. U kunt een omgevingscontainer of een specifieke omgevingsversie archiveren. Als u een omgevingscontainer archiveert, worden alle versies van de omgeving onder die naam gearchiveerd. U kunt een gearchiveerde omgeving herstellen met behulp van az ml environment restore. Als de hele omgevingscontainer is gearchiveerd, kunt u geen afzonderlijke versies van de omgeving herstellen. U moet de omgevingscontainer herstellen.

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

Voorbeelden

Een omgevingscontainer archiveren (alle versies van die omgeving archiveren)

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

Een specifieke omgevingsversie archiveren

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

Vereiste parameters

--name -n

Naam van de omgeving.

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--label -l

Label van de omgeving.

--registry-name

Indien opgegeven, richt de opdracht zich op het register in plaats van op een werkruimte. Daarom zijn resourcegroep en werkruimte niet vereist.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--version -v

Versie van de omgeving.

--workspace-name -w

Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met az configure --defaults workspace=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az ml environment create

Maak een omgeving.

Omgevingen kunnen worden gedefinieerd vanuit een Docker-installatiekopieën, Dockerfile- of Conda-bestand. Azure ML onderhoudt een set CPU- en GPU Docker-installatiekopieën die u als basisinstallatiekopieën kunt gebruiken. Zie voor meer informatie over deze afbeeldingen https://github.com/Azure/AzureML-Containers.

De gemaakte omgeving wordt bijgehouden in de werkruimte onder de opgegeven naam en versie.

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]

Voorbeelden

Een omgeving maken op basis van een YAML-specificatiebestand

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

Een omgeving maken op basis van een Docker-installatiekopieën

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

Een omgeving maken op basis van een buildcontext

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

Een omgeving maken op basis van een conda-specificatie

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

Een omgeving in het register maken op basis van een YAML-specificatiebestand

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

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--build-context -b

Lokaal pad naar de map die moet worden gebruikt als een Docker-buildcontext. --build-context/-b en --image/-i zijn wederzijds exclusieve argumenten.

--conda-file -c

Lokaal pad naar een conda-specificatiebestand. --image/-i moet ook worden opgegeven als dit argument wordt gebruikt.

--datastore

Het gegevensarchief waar het lokale artefact naar moet worden geüpload.

--description

Beschrijving van de omgeving.

--dockerfile-path -d

Relatief pad naar het Dockerfile in de map die is opgegeven door --build-context/-b. Als u dit weglaat, wordt ./Dockerfile gebruikt.

Eigenschap Waarde
Default value: /Dockerfile
--file -f

Lokaal pad naar het YAML-bestand met de Azure ML-omgevingsspecificatie. De YAML-referentiedocumenten voor omgeving vindt u op: https://aka.ms/ml-cli-v2-environment-yaml-reference.

--image -i

Docker-installatiekopieën. --image/-i en --build-context/-b zijn wederzijds exclusieve argumenten.

--name -n

Naam van de omgeving.

--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

Eigenschap Waarde
Default value: False
--os-type

Type besturingssysteem. Toegestane waarden: linux, windows. Standaard: linux.

--registry-name

Indien opgegeven, richt de opdracht zich op het register in plaats van op een werkruimte. Daarom zijn resourcegroep en werkruimte niet vereist.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--set

Werk een object bij door een eigenschapspad en waarde op te geven die u wilt instellen. Voorbeeld: --set property1.property2=value.

--tags

Door spaties gescheiden sleutel-waardeparen voor de tags van het object.

--version -v

Versie van de omgeving.

--workspace-name -w

Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met az configure --defaults workspace=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az ml environment list

Maak een lijst met omgevingen in een werkruimte.

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

Voorbeelden

Alle omgevingen in een werkruimte weergeven

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

Een lijst weergeven van alle omgevingsversies voor de opgegeven naam in een werkruimte

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

Geef alle omgevingen in een werkruimte weer met behulp van het argument --query om een JMESPath-query uit te voeren op de resultaten van opdrachten.

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

Alle omgevingen in een register weergeven

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

Alle omgevingsversies voor de opgegeven naam in een register weergeven

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

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--archived-only

Alleen gearchiveerde omgevingen weergeven.

Eigenschap Waarde
Default value: False
--include-archived

Lijst met gearchiveerde omgevingen en actieve omgevingen.

Eigenschap Waarde
Default value: False
--max-results -r

Maximum aantal resultaten dat moet worden geretourneerd.

--name -n

Naam van de omgeving. Indien opgegeven, worden alle omgevingsversies onder deze naam geretourneerd.

--registry-name

Indien opgegeven, richt de opdracht zich op het register in plaats van op een werkruimte. Daarom zijn resourcegroep en werkruimte niet vereist.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--workspace-name -w

Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met az configure --defaults workspace=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az ml environment restore

Een gearchiveerde omgeving herstellen.

Wanneer een gearchiveerde omgeving wordt hersteld, wordt deze niet meer verborgen voor lijstquery's (az ml environment list). Als een hele omgevingscontainer is gearchiveerd, kunt u die gearchiveerde container herstellen. Hiermee worden alle versies van de omgeving onder die naam hersteld. U kunt alleen een specifieke omgevingsversie herstellen als de hele omgevingscontainer is gearchiveerd. U moet de hele container herstellen. Als alleen een afzonderlijke omgevingsversie is gearchiveerd, kunt u die specifieke versie herstellen.

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

Voorbeelden

Een gearchiveerde omgevingscontainer herstellen (herstelt alle versies van die omgeving)

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

Een specifieke gearchiveerde omgevingsversie herstellen

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

Vereiste parameters

--name -n

Naam van de omgeving.

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--label -l

Label van de omgeving.

--registry-name

Indien opgegeven, richt de opdracht zich op het register in plaats van op een werkruimte. Daarom zijn resourcegroep en werkruimte niet vereist.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--version -v

Versie van de omgeving.

--workspace-name -w

Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met az configure --defaults workspace=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az ml environment share

Een specifieke omgeving delen van werkruimte naar register.

Kopieer een bestaande omgeving van een werkruimte naar een register voor hergebruik tussen werkruimten.

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

Voorbeelden

Een bestaande omgeving delen van werkruimte naar 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

Vereiste parameters

--name -n

Naam van de omgeving.

--registry-name

Doelregister.

--share-with-name

De naam van de omgeving waarmee moet worden gemaakt.

--share-with-version

De versie van de omgeving waarmee moet worden gemaakt.

--version -v

Versie van de omgeving.

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--workspace-name -w

Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met az configure --defaults workspace=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az ml environment show

Details voor een omgeving weergeven.

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

Voorbeelden

Details weergeven voor een omgeving met de opgegeven naam en versie

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

Details weergeven voor een omgeving in het register met de opgegeven naam en versie

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

Vereiste parameters

--name -n

Naam van de omgeving.

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--label -l

Label van de omgeving.

--registry-name

Indien opgegeven, richt de opdracht zich op het register in plaats van op een werkruimte. Daarom zijn resourcegroep en werkruimte niet vereist.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--version -v

Versie van de omgeving.

--workspace-name -w

Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met az configure --defaults workspace=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az ml environment update

Een omgeving bijwerken.

Alleen de eigenschappen 'description' en 'tags' kunnen worden bijgewerkt.

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

Vereiste parameters

--name -n

Naam van de omgeving.

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--add

Voeg een object toe aan een lijst met objecten door een pad- en sleutelwaardeparen op te geven. Voorbeeld: --add property.listProperty <key=value, string or JSON string>.

Eigenschap Waarde
Parametergroep: Generic Update Arguments
Default value: []
--force-string

Wanneer u 'set' of 'toevoegen' gebruikt, behoudt u letterlijke tekenreeksen in plaats van te converteren naar JSON.

Eigenschap Waarde
Parametergroep: Generic Update Arguments
Default value: False
--label -l

Label van de omgeving.

--registry-name

Indien opgegeven, richt de opdracht zich op het register in plaats van op een werkruimte. Daarom zijn resourcegroep en werkruimte niet vereist.

--remove

Een eigenschap of element uit een lijst verwijderen. Voorbeeld: --remove property.list <indexToRemove> OF --remove propertyToRemove.

Eigenschap Waarde
Parametergroep: Generic Update Arguments
Default value: []
--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--set

Werk een object bij door een eigenschapspad en waarde op te geven die u wilt instellen. Voorbeeld: --set property1.property2=<value>.

Eigenschap Waarde
Parametergroep: Generic Update Arguments
Default value: []
--version -v

Versie van de omgeving.

--workspace-name -w

Naam van de Azure ML-werkruimte. U kunt de standaardwerkruimte configureren met az configure --defaults workspace=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False