az ml environment

Catatan

Referensi ini adalah bagian dari ekstensi ml untuk Azure CLI (versi 2.15.0 atau yang lebih tinggi). Ekstensi akan secara otomatis diinstal saat 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

az ml environment archive	Mengarsipkan lingkungan.
az ml environment create	Membuat lingkungan.
az ml environment list	Mencantumkan lingkungan di ruang kerja.
az ml environment restore	Memulihkan lingkungan yang diarsipkan.
az ml environment show	Tampilkan detail untuk lingkungan.
az ml environment update	Memperbarui lingkungan.

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
                          --resource-group
                          --workspace-name
                          [--label]
                          [--version]

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.

--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 grup default menggunakan az configure --defaults workspace=<name>.

Parameter Opsional

--label -l

Label lingkungan.

--version -v

Versi lingkungan.

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.

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi yang lebih lengkap 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

Membuat 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 --resource-group
                         --workspace-name
                         [--build-context]
                         [--conda-file]
                         [--description]
                         [--dockerfile-path]
                         [--file]
                         [--image]
                         [--name]
                         [--os-type]
                         [--set]
                         [--tags]
                         [--version]

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

Parameter yang 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 grup default menggunakan az configure --defaults workspace=<name>.

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.

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

--os-type

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

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

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.

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi yang lebih lengkap 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 --resource-group
                       --workspace-name
                       [--archived-only]
                       [--include-archived]
                       [--max-results]
                       [--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

Parameter yang 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 grup default menggunakan az configure --defaults workspace=<name>.

Parameter Opsional

--archived-only

Cantumkan lingkungan yang diarsipkan saja.

--include-archived

Mencantumkan lingkungan yang diarsipkan dan lingkungan aktif.

--max-results -r

Jumlah maksimum hasil yang akan dikembalikan.

--name -n

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

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.

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi yang lebih lengkap 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
                          --resource-group
                          --workspace-name
                          [--label]
                          [--version]

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.

--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 grup default menggunakan az configure --defaults workspace=<name>.

Parameter Opsional

--label -l

Label lingkungan.

--version -v

Versi lingkungan.

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.

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi yang lebih lengkap 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
                       --resource-group
                       --workspace-name
                       [--label]
                       [--version]

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

Parameter yang Diperlukan

--name -n

Nama lingkungan.

--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 grup default menggunakan az configure --defaults workspace=<name>.

Parameter Opsional

--label -l

Label lingkungan.

--version -v

Versi lingkungan.

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.

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi yang lebih lengkap 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
                         --resource-group
                         --workspace-name
                         [--add]
                         [--force-string]
                         [--label]
                         [--registry-name]
                         [--remove]
                         [--set]
                         [--version]

Parameter yang Diperlukan

--name -n

Nama lingkungan.

--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 grup default menggunakan az configure --defaults workspace=<name>.

Parameter Opsional

--add

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

--force-string

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

--label -l

Label lingkungan.

--registry-name

Ini akan berinteraksi dengan nama yang disediakan registri, bukan menggunakan ruang kerja.

--remove

Menghapus properti atau elemen dari daftar. Contoh: --remove property.list OR --remove propertyToRemove.

--set

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

--version -v

Versi lingkungan.

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.

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi yang lebih lengkap 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.