az ml environment
Nota
Referensi ini adalah bagian dari ekstensi ml
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 |
Buat 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.
Pengarsipan lingkungan akan menyembunyikannya secara default dari kueri daftar (az ml environment list
). Anda masih dapat terus mereferensikan dan menggunakan lingkungan yang diarsipkan di alur kerja Anda. Anda dapat mengarsipkan kontainer lingkungan atau versi lingkungan tertentu. Pengarsipan 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
Nama lingkungan.
Parameter Opsional
Label lingkungan.
Jika disediakan, perintah akan menargetkan registri alih-alih ruang kerja. Oleh karena itu, grup sumber daya dan ruang kerja tidak akan diperlukan.
Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>
.
Versi lingkungan.
Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>
.
Parameter Global
Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.
Tampilkan pesan bantuan ini dan keluar.
Hanya tampilkan kesalahan, menekan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.
az ml environment create
Buat 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
Membuat 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
Jalur lokal ke direktori untuk digunakan sebagai konteks build Docker. --build-context/-b dan --image/-i adalah argumen yang saling eksklusif.
Jalur lokal ke file spesifikasi conda. --image/-i juga harus ditentukan jika argumen ini digunakan.
Datastore untuk mengunggah artefak lokal.
Deskripsi lingkungan.
Jalur relatif ke Dockerfile dalam direktori yang ditentukan oleh --build-context/-b. Jika dihilangkan, './Dockerfile' digunakan.
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.
Gambar Docker. --image/-i dan --build-context/-b adalah argumen yang saling eksklusif.
Nama lingkungan.
Jangan menunggu operasi jangka panjang selesai.
Jenis sistem operasi. Nilai yang diizinkan: linux, windows. Default: linux.
Jika disediakan, perintah akan menargetkan registri alih-alih ruang kerja. Oleh karena itu, grup sumber daya dan ruang kerja tidak akan diperlukan.
Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>
.
Perbarui objek dengan menentukan jalur properti dan nilai yang akan diatur. Contoh: --set property1.property2=value.
Pasangan kunci-nilai yang dipisahkan spasi untuk tag objek.
Versi lingkungan.
Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>
.
Parameter Global
Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.
Tampilkan pesan bantuan ini dan keluar.
Hanya tampilkan kesalahan, menekan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.
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
Cantumkan lingkungan yang diarsipkan saja.
Mencantumkan lingkungan yang diarsipkan dan lingkungan aktif.
Jumlah maksimum hasil yang akan dikembalikan.
Nama lingkungan. Jika disediakan, semua versi lingkungan dengan nama ini akan dikembalikan.
Jika disediakan, perintah akan menargetkan registri alih-alih ruang kerja. Oleh karena itu, grup sumber daya dan ruang kerja tidak akan diperlukan.
Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>
.
Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>
.
Parameter Global
Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.
Tampilkan pesan bantuan ini dan keluar.
Hanya tampilkan kesalahan, menekan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.
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
Nama lingkungan.
Parameter Opsional
Label lingkungan.
Jika disediakan, perintah akan menargetkan registri alih-alih ruang kerja. Oleh karena itu, grup sumber daya dan ruang kerja tidak akan diperlukan.
Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>
.
Versi lingkungan.
Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>
.
Parameter Global
Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.
Tampilkan pesan bantuan ini dan keluar.
Hanya tampilkan kesalahan, menekan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.
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
Nama lingkungan.
Registri tujuan.
Nama lingkungan yang akan dibuat.
Versi lingkungan yang akan dibuat.
Versi lingkungan.
Parameter Opsional
Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>
.
Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>
.
Parameter Global
Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.
Tampilkan pesan bantuan ini dan keluar.
Hanya tampilkan kesalahan, menekan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.
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
Nama lingkungan.
Parameter Opsional
Label lingkungan.
Jika disediakan, perintah akan menargetkan registri alih-alih ruang kerja. Oleh karena itu, grup sumber daya dan ruang kerja tidak akan diperlukan.
Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>
.
Versi lingkungan.
Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>
.
Parameter Global
Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.
Tampilkan pesan bantuan ini dan keluar.
Hanya tampilkan kesalahan, menekan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.
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
Nama lingkungan.
Parameter Opsional
Tambahkan objek ke daftar objek dengan menentukan jalur dan pasangan nilai kunci. Contoh: --add property.listProperty <key=value, string or JSON string>
.
Saat menggunakan 'set' atau 'add', pertahankan literal string alih-alih mencoba mengonversi ke JSON.
Label lingkungan.
Jika disediakan, perintah akan menargetkan registri alih-alih ruang kerja. Oleh karena itu, grup sumber daya dan ruang kerja tidak akan diperlukan.
Menghapus properti atau elemen dari daftar. Contoh: --remove property.list <indexToRemove>
OR --remove propertyToRemove
.
Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>
.
Perbarui objek dengan menentukan jalur properti dan nilai yang akan diatur. Contoh: --set property1.property2=<value>
.
Versi lingkungan.
Nama ruang kerja Azure ML. Anda dapat mengonfigurasi ruang kerja default menggunakan az configure --defaults workspace=<name>
.
Parameter Global
Tingkatkan verbositas pengelogan untuk menampilkan semua log debug.
Tampilkan pesan bantuan ini dan keluar.
Hanya tampilkan kesalahan, menekan peringatan.
Format output.
String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi dan contoh selengkapnya.
Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID
.
Tingkatkan verbositas pengelogan. Gunakan --debug untuk log debug penuh.