az ml environment
Jegyzet
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 environment parancs első futtatásakor. További 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. |
Kiterjesztés | GA |
az ml environment create |
Hozzon létre egy környezetet. |
Kiterjesztés | GA |
az ml environment list |
A munkaterület környezeteinek listázása. |
Kiterjesztés | GA |
az ml environment restore |
Archivált környezet visszaállítása. |
Kiterjesztés | GA |
az ml environment share |
Egy adott környezet megosztása a munkaterületről a beállításjegyzékbe. |
Kiterjesztés | GA |
az ml environment show |
Egy környezet részleteinek megjelenítése. |
Kiterjesztés | GA |
az ml environment update |
Környezet frissítése. |
Kiterjesztés | GA |
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 az ml environment restore
használatával á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
A környezet neve.
Opcionális paraméterek
A környezet címkéje.
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.
Az erőforráscsoport neve. Az alapértelmezett csoportot a az configure --defaults group=<name>
használatával konfigurálhatja.
A környezet verziója.
Az Azure ML-munkaterület neve. Az alapértelmezett munkaterületet a az configure --defaults workspace=<name>
használatával konfigurálhatja.
Globális paraméterek
Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
Csak a hibák megjelenítése, a figyelmeztetések mellőzése.
Kimeneti formátum.
JMESPath lekérdezési sztring. További információkért és példákért lásd a http://jmespath.org/.
Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a az account set -s NAME_OR_ID
használatával konfigurálhatja.
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
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 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.
A helyi összetevő feltöltésére szolgáló adattár.
A környezet leírása.
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.
Az Azure ML-környezet specifikációját tartalmazó YAML-fájl helyi elérési útja. A környezet YAML-referencia-dokumentációja a következő helyen található: https://aka.ms/ml-cli-v2-environment-yaml-reference.
Docker-kép. A --image/-i és a --build-context/-b kölcsönösen kizáró argumentumok.
A környezet neve.
Ne várja meg, amíg a hosszú ideig futó művelet befejeződik.
Az operációs rendszer típusa. Engedélyezett értékek: linux, windows. Alapértelmezett: linux.
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.
Az erőforráscsoport neve. Az alapértelmezett csoportot a az configure --defaults group=<name>
használatával konfigurálhatja.
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.
Szóközzel elválasztott kulcs-érték párok az objektum címkéihez.
A környezet verziója.
Az Azure ML-munkaterület neve. Az alapértelmezett munkaterületet a az configure --defaults workspace=<name>
használatával konfigurálhatja.
Globális paraméterek
Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
Csak a hibák megjelenítése, a figyelmeztetések mellőzése.
Kimeneti formátum.
JMESPath lekérdezési sztring. További információkért és példákért lásd a http://jmespath.org/.
Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a az account set -s NAME_OR_ID
használatával konfigurálhatja.
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
Csak archivált környezetek listázása.
Archivált környezetek és aktív környezetek listázása.
A visszaadandó eredmények maximális száma.
A környezet neve. Ha meg van adva, a rendszer az ezen a néven szereplő összes környezeti verziót visszaadja.
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.
Az erőforráscsoport neve. Az alapértelmezett csoportot a az configure --defaults group=<name>
használatával konfigurálhatja.
Az Azure ML-munkaterület neve. Az alapértelmezett munkaterületet a az configure --defaults workspace=<name>
használatával konfigurálhatja.
Globális paraméterek
Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
Csak a hibák megjelenítése, a figyelmeztetések mellőzése.
Kimeneti formátum.
JMESPath lekérdezési sztring. További információkért és példákért lásd a http://jmespath.org/.
Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a az account set -s NAME_OR_ID
használatával konfigurálhatja.
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
A környezet neve.
Opcionális paraméterek
A környezet címkéje.
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.
Az erőforráscsoport neve. Az alapértelmezett csoportot a az configure --defaults group=<name>
használatával konfigurálhatja.
A környezet verziója.
Az Azure ML-munkaterület neve. Az alapértelmezett munkaterületet a az configure --defaults workspace=<name>
használatával konfigurálhatja.
Globális paraméterek
Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
Csak a hibák megjelenítése, a figyelmeztetések mellőzése.
Kimeneti formátum.
JMESPath lekérdezési sztring. További információkért és példákért lásd a http://jmespath.org/.
Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a az account set -s NAME_OR_ID
használatával konfigurálhatja.
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
A környezet neve.
Céljegyzék.
A létrehozandó környezet neve.
A létrehozandó környezet verziója.
A környezet verziója.
Opcionális paraméterek
Az erőforráscsoport neve. Az alapértelmezett csoportot a az configure --defaults group=<name>
használatával konfigurálhatja.
Az Azure ML-munkaterület neve. Az alapértelmezett munkaterületet a az configure --defaults workspace=<name>
használatával konfigurálhatja.
Globális paraméterek
Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
Csak a hibák megjelenítése, a figyelmeztetések mellőzése.
Kimeneti formátum.
JMESPath lekérdezési sztring. További információkért és példákért lásd a http://jmespath.org/.
Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a az account set -s NAME_OR_ID
használatával konfigurálhatja.
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
A környezet neve.
Opcionális paraméterek
A környezet címkéje.
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.
Az erőforráscsoport neve. Az alapértelmezett csoportot a az configure --defaults group=<name>
használatával konfigurálhatja.
A környezet verziója.
Az Azure ML-munkaterület neve. Az alapértelmezett munkaterületet a az configure --defaults workspace=<name>
használatával konfigurálhatja.
Globális paraméterek
Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
Csak a hibák megjelenítése, a figyelmeztetések mellőzése.
Kimeneti formátum.
JMESPath lekérdezési sztring. További információkért és példákért lásd a http://jmespath.org/.
Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a az account set -s NAME_OR_ID
használatával konfigurálhatja.
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
A környezet neve.
Opcionális paraméterek
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>
.
A "set" vagy a "add" használata esetén a JSON-ra való konvertálás helyett őrizze meg a sztringkonstansokat.
A környezet címkéje.
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.
Tulajdonság vagy elem eltávolítása a listából. Példa: --remove property.list <indexToRemove>
VAGY --remove propertyToRemove
.
Az erőforráscsoport neve. Az alapértelmezett csoportot a az configure --defaults group=<name>
használatával konfigurálhatja.
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>
.
A környezet verziója.
Az Azure ML-munkaterület neve. Az alapértelmezett munkaterületet a az configure --defaults workspace=<name>
használatával konfigurálhatja.
Globális paraméterek
Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.
Jelenítse meg ezt a súgóüzenetet, és lépjen ki.
Csak a hibák megjelenítése, a figyelmeztetések mellőzése.
Kimeneti formátum.
JMESPath lekérdezési sztring. További információkért és példákért lásd a http://jmespath.org/.
Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a az account set -s NAME_OR_ID
használatával konfigurálhatja.
A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.