Delen via

az ml environment

  • Referentie

Notitie

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 extensies.

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.

 Extensie GA
az ml environment create

Maak een omgeving.

 Extensie GA
az ml environment list

Maak een lijst met omgevingen in een werkruimte.

 Extensie GA
az ml environment restore

Een gearchiveerde omgeving herstellen.

 Extensie GA
az ml environment share

Een specifieke omgeving delen van werkruimte naar register.

 Extensie GA
az ml environment show

Details voor een omgeving weergeven.

 Extensie GA
az ml environment update

Een omgeving bijwerken.

 Extensie GA

az ml environment archive

Een omgeving archiveren.

Als u een omgeving archivert, wordt deze standaard verborgen voor 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

--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.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.

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 https://github.com/Azure/AzureML-Containersvoor meer informatie over deze afbeeldingen.

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

--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.

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.

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.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.

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

--archived-only

Alleen gearchiveerde omgevingen weergeven.

Default value: False
--include-archived

Lijst met gearchiveerde omgevingen en actieve omgevingen.

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.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.

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

--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.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.

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

--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.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.

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

--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.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.

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

--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>.

Default value: []
--force-string

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

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> OR---remove propertyToRemove.

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>.

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.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.