az ml environment

  • Referensi

Catatan

Referensi ini adalah bagian dari ekstensi ml untuk Azure CLI (versi 2.15.0 atau yang lebih tinggi). Ekstensi akan secara otomatis menginstal pertama kali Anda menjalankan perintah lingkungan az ml. Pelajari lebih lanjut tentang ekstensi.

Mengelola lingkungan Azure ML.

Lingkungan Azure ML menentukan lingkungan eksekusi untuk pekerjaan dan penyebaran titik akhir, merangkum dependensi untuk pelatihan dan inferensi. Definisi lingkungan ini dibangun ke dalam gambar Docker.

Perintah

Nama Deskripsi Jenis Status
az ml environment archive

Mengarsipkan lingkungan.

 Ekstensi GA
az ml environment create

Ciptakan lingkungan.

 Ekstensi GA
az ml environment list

Mencantumkan lingkungan di ruang kerja.

 Ekstensi GA
az ml environment restore

Memulihkan lingkungan yang diarsipkan.

 Ekstensi GA
az ml environment share

Bagikan lingkungan tertentu dari ruang kerja ke registri.

 Ekstensi GA
az ml environment show

Tampilkan detail untuk lingkungan.

 Ekstensi GA
az ml environment update

Memperbarui lingkungan.

 Ekstensi GA

az ml environment archive

Mengarsipkan lingkungan.

Mengarsipkan lingkungan akan menyembunyikannya secara default dari kueri daftar (az ml environment list). Anda masih dapat terus mereferensikan dan menggunakan lingkungan yang diarsipkan dalam alur kerja Anda. Anda dapat mengarsipkan kontainer lingkungan atau versi lingkungan tertentu. Mengarsipkan kontainer lingkungan akan mengarsipkan semua versi lingkungan dengan nama yang diberikan. Anda dapat memulihkan lingkungan yang diarsipkan menggunakan az ml environment restore. Jika seluruh kontainer lingkungan diarsipkan, Anda tidak dapat memulihkan versi lingkungan individual - Anda harus memulihkan kontainer lingkungan.

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

Contoh

Mengarsipkan kontainer lingkungan (mengarsipkan semua versi lingkungan tersebut)

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

Mengarsipkan versi lingkungan tertentu

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

Parameter yang Diperlukan

--name -n

Nama lingkungan.

Parameter Opsional

--label -l

Label lingkungan.

--registry-name

Jika disediakan, perintah akan menargetkan registri alih-alih ruang kerja. Oleh karena itu, grup sumber daya dan ruang kerja tidak akan diperlukan.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--version -v

Versi lingkungan.

--workspace-name -w

Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az ml environment create

Ciptakan lingkungan.

Lingkungan dapat didefinisikan dari gambar Docker, Dockerfile, atau file Conda. Azure ML mempertahankan sekumpulan gambar CPU dan GPU Docker yang dapat Anda gunakan sebagai gambar dasar. Untuk informasi tentang gambar-gambar ini, lihat https://github.com/Azure/AzureML-Containers.

Lingkungan yang dibuat akan dilacak di ruang kerja dengan nama dan versi yang ditentukan.

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]

Contoh

Membuat lingkungan dari file spesifikasi YAML

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

Membuat lingkungan dari gambar docker

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

Membuat lingkungan dari konteks build

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

Buat lingkungan dari spesifikasi conda

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

Membuat lingkungan dalam registri dari file spesifikasi YAML

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

Parameter Opsional

--build-context -b

Jalur lokal ke direktori untuk digunakan sebagai konteks build Docker. --build-context/-b dan --image/-i adalah argumen yang saling eksklusif.

--conda-file -c

Jalur lokal ke file spesifikasi conda. --image/-i juga harus ditentukan jika argumen ini digunakan.

--datastore

Datastore untuk mengunggah artefak lokal.

--description

Deskripsi lingkungan.

--dockerfile-path -d

Jalur relatif ke Dockerfile dalam direktori yang ditentukan oleh --build-context/-b. Jika dihilangkan, './Dockerfile' digunakan.

nilai default: /Dockerfile
--file -f

Jalur lokal ke file YAML yang berisi spesifikasi lingkungan Azure ML. Dokumen referensi YAML untuk lingkungan dapat ditemukan di: https://aka.ms/ml-cli-v2-environment-yaml-reference.

--image -i

Gambar Docker. --image/-i dan --build-context/-b adalah argumen yang saling eksklusif.

--name -n

Nama lingkungan.

--no-wait

Jangan menunggu operasi jangka panjang selesai.

nilai default: False
--os-type

Jenis sistem operasi. Nilai yang diizinkan: linux, windows. Default: linux.

--registry-name

Jika disediakan, perintah akan menargetkan registri alih-alih ruang kerja. Oleh karena itu, grup sumber daya dan ruang kerja tidak akan diperlukan.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--set

Perbarui objek dengan menentukan jalur properti dan nilai yang akan diatur. Contoh: --set property1.property2=.

--tags

Pasangan kunci-nilai yang dipisahkan spasi untuk tag objek.

--version -v

Versi lingkungan.

--workspace-name -w

Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az ml environment list

Mencantumkan lingkungan di ruang kerja.

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

Contoh

Mencantumkan semua lingkungan di ruang kerja

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

Mencantumkan semua versi lingkungan untuk nama yang ditentukan di ruang kerja

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

Cantumkan semua lingkungan di ruang kerja menggunakan argumen --query untuk menjalankan kueri JMESPath pada hasil perintah.

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

Mencantumkan semua lingkungan dalam registri

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

Mencantumkan semua versi lingkungan untuk nama yang ditentukan dalam registri

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

Parameter Opsional

--archived-only

Cantumkan lingkungan yang diarsipkan saja.

nilai default: False
--include-archived

Mencantumkan lingkungan yang diarsipkan dan lingkungan aktif.

nilai default: False
--max-results -r

Jumlah maksimum hasil yang akan dikembalikan.

--name -n

Nama lingkungan. Jika disediakan, semua versi lingkungan dengan nama ini akan dikembalikan.

--registry-name

Jika disediakan, perintah akan menargetkan registri alih-alih ruang kerja. Oleh karena itu, grup sumber daya dan ruang kerja tidak akan diperlukan.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--workspace-name -w

Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az ml environment restore

Memulihkan lingkungan yang diarsipkan.

Ketika lingkungan yang diarsipkan dipulihkan, lingkungan tersebut tidak akan lagi disembunyikan dari kueri daftar (az ml environment list). Jika seluruh kontainer lingkungan diarsipkan, Anda dapat memulihkan kontainer yang diarsipkan tersebut. Ini akan memulihkan semua versi lingkungan dengan nama yang diberikan. Anda tidak dapat memulihkan hanya versi lingkungan tertentu jika seluruh kontainer lingkungan diarsipkan - Anda harus memulihkan seluruh kontainer. Jika hanya versi lingkungan individual yang diarsipkan, Anda dapat memulihkan versi tertentu tersebut.

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

Contoh

Memulihkan kontainer lingkungan yang diarsipkan (memulihkan semua versi lingkungan tersebut)

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

Memulihkan versi lingkungan tertentu yang diarsipkan

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

Parameter yang Diperlukan

--name -n

Nama lingkungan.

Parameter Opsional

--label -l

Label lingkungan.

--registry-name

Jika disediakan, perintah akan menargetkan registri alih-alih ruang kerja. Oleh karena itu, grup sumber daya dan ruang kerja tidak akan diperlukan.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--version -v

Versi lingkungan.

--workspace-name -w

Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az ml environment share

Bagikan lingkungan tertentu dari ruang kerja ke registri.

Salin lingkungan yang ada dari ruang kerja ke registri untuk penggunaan kembali lintas ruang kerja.

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

Contoh

Berbagi lingkungan yang ada dari ruang kerja ke registri

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

Parameter yang Diperlukan

--name -n

Nama lingkungan.

--registry-name

Registri tujuan.

--share-with-name

Nama lingkungan yang akan dibuat.

--share-with-version

Versi lingkungan yang akan dibuat.

--version -v

Versi lingkungan.

Parameter Opsional

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--workspace-name -w

Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az ml environment show

Tampilkan detail untuk lingkungan.

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

Contoh

Menampilkan detail untuk lingkungan dengan nama dan versi yang ditentukan

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

Menampilkan detail untuk lingkungan dalam registri dengan nama dan versi yang ditentukan

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

Parameter yang Diperlukan

--name -n

Nama lingkungan.

Parameter Opsional

--label -l

Label lingkungan.

--registry-name

Jika disediakan, perintah akan menargetkan registri alih-alih ruang kerja. Oleh karena itu, grup sumber daya dan ruang kerja tidak akan diperlukan.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--version -v

Versi lingkungan.

--workspace-name -w

Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az ml environment update

Memperbarui lingkungan.

Hanya properti 'deskripsi' dan 'tag' yang dapat diperbarui.

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

Parameter yang Diperlukan

--name -n

Nama lingkungan.

Parameter Opsional

--add

Tambahkan objek ke daftar objek dengan menentukan jalur dan pasangan nilai kunci. Contoh: --add property.listProperty <key=value, string or JSON string>.

nilai default: []
--force-string

Saat menggunakan 'set' atau 'add', pertahankan literal string alih-alih mencoba mengonversi ke JSON.

nilai default: False
--label -l

Label lingkungan.

--registry-name

Jika disediakan, perintah akan menargetkan registri alih-alih ruang kerja. Oleh karena itu, grup sumber daya dan ruang kerja tidak akan diperlukan.

--remove

Menghapus properti atau elemen dari daftar. Contoh: --remove property.list <indexToRemove> ATAU --remove propertyToRemove.

nilai default: []
--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--set

Perbarui objek dengan menentukan jalur properti dan nilai yang akan diatur. Contoh: --set property1.property2=<value>.

nilai default: []
--version -v

Versi lingkungan.

--workspace-name -w

Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.