az ml environment

  • Referencia

Feljegyzés

Ez a hivatkozás az Azure CLI ml-bővítményének része (2.15.0-s vagy újabb verzió). A bővítmény automatikusan telepíti az az ml környezeti parancs első futtatásakor. További információ a bővítményekről.

Azure ML-környezetek kezelése.

Az Azure ML-környezetek határozzák meg a feladatok és a végpontok üzembe helyezésének végrehajtási környezetét, amely magában foglalja a betanítási és következtetési függőségeket. Ezek a környezetdefiníciók Docker-rendszerképekbe vannak beépítve.

Parancsok

Name Description Típus Állapot
az ml environment archive

Környezet archiválása.

 Mellék FE
az ml environment create

Hozzon létre egy környezetet.

 Mellék FE
az ml environment list

A munkaterület környezeteinek listázása.

 Mellék FE
az ml environment restore

Archivált környezet visszaállítása.

 Mellék FE
az ml environment share

Egy adott környezet megosztása a munkaterületről a beállításjegyzékbe.

 Mellék FE
az ml environment show

Egy környezet részleteinek megjelenítése.

 Mellék FE
az ml environment update

Környezet frissítése.

 Mellék FE

az ml environment archive

Környezet archiválása.

A környezet archiválása alapértelmezés szerint elrejti azt a lista lekérdezéseiből (az ml environment list). Továbbra is hivatkozhat és használhat archivált környezetet a munkafolyamatokban. Archiválhat egy környezeti tárolót vagy egy adott környezeti verziót. A környezeti tároló archiválása a környezet minden verzióját archiválja a megadott név alatt. Az archivált környezeteket a következővel az ml environment restoreállíthatja vissza: . Ha a teljes környezeti tároló archiválva van, nem állíthatja vissza a környezet egyes verzióit – a környezeti tárolót vissza kell állítania.

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

Példák

Környezeti tároló archiválása (a környezet összes verziójának archiválása)

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

Adott környezeti verzió archiválása

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

Kötelező paraméterek

--name -n

A környezet neve.

Opcionális paraméterek

--label -l

A környezet címkéje.

--registry-name

Ha meg van adva, a parancs munkaterület helyett a beállításjegyzéket célozza meg. Ezért nem lesz szükség erőforráscsoportra és munkaterületre.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

--version -v

A környezet verziója.

--workspace-name -w

Az Azure ML-munkaterület neve. Az alapértelmezett munkaterületet konfigurálhatja a következővel az configure --defaults workspace=<name>: .

Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az ml environment create

Hozzon létre egy környezetet.

A környezetek Docker-rendszerképből, Dockerfile-ból vagy Conda-fájlból határozhatók meg. Az Azure ML olyan PROCESSZOR- és GPU Docker-rendszerképeket tart fenn, amelyeket alaprendszerképként használhat. További információ ezekről a képekről: https://github.com/Azure/AzureML-Containers.

A létrehozott környezet nyomon lesz követve a munkaterületen a megadott név és verzió alatt.

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]

Példák

Környezet létrehozása YAML-specifikációs fájlból

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

Környezet létrehozása Docker-rendszerképből

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

Környezet létrehozása buildkörnyezetből

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

Környezet létrehozása conda-specifikációból

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

Környezet létrehozása a beállításjegyzékben YAML-specifikációs fájlból

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

Opcionális paraméterek

--build-context -b

A címtár helyi elérési útja, amelyet Docker-buildkörnyezetként szeretne használni. --build-context/-b és --image/-i kölcsönösen kizáró érvek.

--conda-file -c

Conda specifikációs fájl helyi elérési útja. A --image/-i értéket is meg kell adni, ha ezt az argumentumot használja.

--datastore

A helyi összetevő feltöltésére szolgáló adattár.

--description

A környezet leírása.

--dockerfile-path -d

A Dockerfile relatív elérési útja a --build-context/-b könyvtárban. Ha nincs megadva, a rendszer a ./Dockerfile fájlt használja.

alapértelmezett érték: /Dockerfile
--file -f

Az Azure ML-környezet specifikációját tartalmazó YAML-fájl helyi elérési útja. A környezethez tartozó YAML-referencia-dokumentumok a következő helyen találhatók: https://aka.ms/ml-cli-v2-environment-yaml-reference.

--image -i

Docker-kép. A --image/-i és a --build-context/-b kölcsönösen kizáró argumentumok.

--name -n

A környezet neve.

--no-wait

Ne várja meg, amíg a hosszú ideig futó művelet befejeződik.

alapértelmezett érték: False
--os-type

Az operációs rendszer típusa. Engedélyezett értékek: linux, windows. Alapértelmezett: linux.

--registry-name

Ha meg van adva, a parancs munkaterület helyett a beállításjegyzéket célozza meg. Ezért nem lesz szükség erőforráscsoportra és munkaterületre.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

--set

Frissítsen egy objektumot egy beállítandó tulajdonság elérési útjának és értékének megadásával. Példa: --set property1.property2=.

--tags

Szóközzel elválasztott kulcs-érték párok az objektum címkéihez.

--version -v

A környezet verziója.

--workspace-name -w

Az Azure ML-munkaterület neve. Az alapértelmezett munkaterületet konfigurálhatja a következővel az configure --defaults workspace=<name>: .

Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az ml environment list

A munkaterület környezeteinek listázása.

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

Példák

A munkaterület összes környezetének listázása

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

A munkaterületen megadott név összes környezeti verziójának listázása

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

A munkaterület összes környezetének listázása --query argumentum használatával JMESPath-lekérdezés végrehajtásához a parancsok eredményein.

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

A beállításjegyzék összes környezetének listázása

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

A megadott név összes környezeti verziójának listázása egy beállításjegyzékben

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

Opcionális paraméterek

--archived-only

Csak archivált környezetek listázása.

alapértelmezett érték: False
--include-archived

Archivált környezetek és aktív környezetek listázása.

alapértelmezett érték: False
--max-results -r

A visszaadandó eredmények maximális száma.

--name -n

A környezet neve. Ha meg van adva, a rendszer az ezen a néven szereplő összes környezeti verziót visszaadja.

--registry-name

Ha meg van adva, a parancs munkaterület helyett a beállításjegyzéket célozza meg. Ezért nem lesz szükség erőforráscsoportra és munkaterületre.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

--workspace-name -w

Az Azure ML-munkaterület neve. Az alapértelmezett munkaterületet konfigurálhatja a következővel az configure --defaults workspace=<name>: .

Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az ml environment restore

Archivált környezet visszaállítása.

Az archivált környezet visszaállításakor az többé nem lesz elrejtve a lista lekérdezései elől (az ml environment list). Ha egy teljes környezeti tároló archiválva van, visszaállíthatja az archivált tárolót. Ezzel visszaállítja a környezet összes verzióját az adott név alatt. Nem állíthat vissza csak egy adott környezeti verziót, ha a teljes környezeti tároló archiválva van – a teljes tárolót vissza kell állítania. Ha csak egy adott környezeti verzió lett archiválva, visszaállíthatja az adott verziót.

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

Példák

Archivált környezeti tároló visszaállítása (a környezet összes verzióját visszaállítja)

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

Adott archivált környezeti verzió visszaállítása

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

Kötelező paraméterek

--name -n

A környezet neve.

Opcionális paraméterek

--label -l

A környezet címkéje.

--registry-name

Ha meg van adva, a parancs munkaterület helyett a beállításjegyzéket célozza meg. Ezért nem lesz szükség erőforráscsoportra és munkaterületre.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

--version -v

A környezet verziója.

--workspace-name -w

Az Azure ML-munkaterület neve. Az alapértelmezett munkaterületet konfigurálhatja a következővel az configure --defaults workspace=<name>: .

Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az ml environment share

Egy adott környezet megosztása a munkaterületről a beállításjegyzékbe.

Meglévő környezet másolása munkaterületről egy adatbázisba a munkaterületek közötti újrafelhasználás érdekében.

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

Példák

Meglévő környezet megosztása a munkaterületről a beállításjegyzékbe

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

Kötelező paraméterek

--name -n

A környezet neve.

--registry-name

Céljegyzék.

--share-with-name

A létrehozandó környezet neve.

--share-with-version

A létrehozandó környezet verziója.

--version -v

A környezet verziója.

Opcionális paraméterek

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

--workspace-name -w

Az Azure ML-munkaterület neve. Az alapértelmezett munkaterületet konfigurálhatja a következővel az configure --defaults workspace=<name>: .

Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az ml environment show

Egy környezet részleteinek megjelenítése.

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

Példák

A megadott névvel és verzióval rendelkező környezet részleteinek megjelenítése

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

A megadott névvel és verzióval rendelkező környezet részleteinek megjelenítése a beállításjegyzékben

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

Kötelező paraméterek

--name -n

A környezet neve.

Opcionális paraméterek

--label -l

A környezet címkéje.

--registry-name

Ha meg van adva, a parancs munkaterület helyett a beállításjegyzéket célozza meg. Ezért nem lesz szükség erőforráscsoportra és munkaterületre.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

--version -v

A környezet verziója.

--workspace-name -w

Az Azure ML-munkaterület neve. Az alapértelmezett munkaterületet konfigurálhatja a következővel az configure --defaults workspace=<name>: .

Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az ml environment update

Környezet frissítése.

Csak a leírás és a címkék tulajdonságai frissíthetők.

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

Kötelező paraméterek

--name -n

A környezet neve.

Opcionális paraméterek

--add

Adjon hozzá egy objektumot az objektumok listájához egy elérési út és egy kulcsértékpár megadásával. Példa: --add property.listProperty <key=value, string or JSON string>

alapértelmezett érték: []
--force-string

A "set" vagy a "add" használata esetén a JSON-ra való konvertálás helyett őrizze meg a sztringkonstansokat.

alapértelmezett érték: False
--label -l

A környezet címkéje.

--registry-name

Ha meg van adva, a parancs munkaterület helyett a beállításjegyzéket célozza meg. Ezért nem lesz szükség erőforráscsoportra és munkaterületre.

--remove

Tulajdonság vagy elem eltávolítása a listából. Példa: --remove property.list <indexToRemove> VAGY --remove propertyToRemove.

alapértelmezett érték: []
--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot konfigurálhatja a következővel az configure --defaults group=<name>: .

--set

Frissítsen egy objektumot egy beállítandó tulajdonság elérési útjának és értékének megadásával. Példa: --set property1.property2=<value>

alapértelmezett érték: []
--version -v

A környezet verziója.

--workspace-name -w

Az Azure ML-munkaterület neve. Az alapértelmezett munkaterületet konfigurálhatja a következővel az configure --defaults workspace=<name>: .

Globális paraméterek
--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

elfogadott értékek: json, jsonc, none, table, tsv, yaml, yamlc
alapértelmezett érték: json
--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést konfigurálhatja a következővel az account set -s NAME_OR_ID: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.