az ml environment

  • Başvuru

Not

Bu başvuru, Azure CLI (sürüm 2.15.0 veya üzeri) için ml uzantısının bir parçasıdır. Uzantı, az ml environment komutunu ilk kez çalıştırdığınızda otomatik olarak yüklenir. Uzantılar hakkında daha fazla bilgi edinin.

Azure ML ortamlarını yönetme.

Azure ML ortamları, eğitim ve çıkarım bağımlılıklarını kapsülleyerek işler ve uç nokta dağıtımları için yürütme ortamını tanımlar. Bu ortam tanımları Docker görüntülerinde yerleşiktir.

Komutlar

Name Description Tür Durum
az ml environment archive

Bir ortamı arşivleyin.

 Dahili GA
az ml environment create

Ortam oluşturun.

 Dahili GA
az ml environment list

Çalışma alanında ortamları listeleme.

 Dahili GA
az ml environment restore

Arşivlenmiş bir ortamı geri yükleme.

 Dahili GA
az ml environment share

Çalışma alanından kayıt defterine belirli bir ortamı paylaşın.

 Dahili GA
az ml environment show

Bir ortamın ayrıntılarını gösterme.

 Dahili GA
az ml environment update

Bir ortamı güncelleştirme.

 Dahili GA

az ml environment archive

Bir ortamı arşivleyin.

Bir ortamı arşivleme, bunu varsayılan olarak liste sorgularından (az ml environment list ) gizler. İş akışlarınızda arşivlenmiş bir ortama başvurmaya ve kullanmaya devam edebilirsiniz. Bir ortam kapsayıcısı veya belirli bir ortam sürümünü arşivleyebilirsiniz. Ortam kapsayıcısının arşivlenmesi, ortamın tüm sürümlerini bu ad altında arşivler. arşivlenmiş bir ortamı kullanarak az ml environment restoregeri yükleyebilirsiniz. Ortam kapsayıcısının tamamı arşivlenmişse, ortamın tek tek sürümlerini geri yükleyemezsiniz. Ortam kapsayıcısını geri yüklemeniz gerekir.

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

Örnekler

Ortam kapsayıcısı arşivle (bu ortamın tüm sürümlerini arşivler)

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

Belirli bir ortam sürümünü arşivle

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

Gerekli Parametreler

--name -n

Ortamın adı.

İsteğe Bağlı Parametreler

--label -l

Ortamın etiketi.

--registry-name

Sağlanırsa, komut çalışma alanı yerine kayıt defterini hedefler. Bu nedenle kaynak grubu ve çalışma alanı gerekli olmayacaktır.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

--version -v

Ortamın sürümü.

--workspace-name -w

Azure ML çalışma alanının adı. varsayılan çalışma alanını kullanarak az configure --defaults workspace=<name>yapılandırabilirsiniz.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
varsayılan değer: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az ml environment create

Ortam oluşturun.

Ortamlar bir Docker görüntüsü, Dockerfile veya Conda dosyasından tanımlanabilir. Azure ML, temel görüntüler olarak kullanabileceğiniz bir dizi CPU ve GPU Docker görüntüsü tutar. Bu görüntüler hakkında bilgi için bkz https://github.com/Azure/AzureML-Containers. .

Oluşturulan ortam, çalışma alanında belirtilen ad ve sürüm altında izlenir.

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]

Örnekler

YAML belirtim dosyasından ortam oluşturma

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

Docker görüntüsünden ortam oluşturma

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

Derleme bağlamından ortam oluşturma

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

Conda belirtiminden ortam oluşturma

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

YAML belirtim dosyasından kayıt defterinde ortam oluşturma

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

İsteğe Bağlı Parametreler

--build-context -b

Docker derleme bağlamı olarak kullanılacak dizinin yerel yolu. --build-context/-b ve --image/-i birbirini dışlayan bağımsız değişkenlerdir.

--conda-file -c

Conda belirtimi dosyasının yerel yolu. Bu bağımsız değişken kullanılırsa --image/-i de belirtilmelidir.

--datastore

Yerel yapıtın yüklendiği veri deposu.

--description

Ortamın açıklaması.

--dockerfile-path -d

--build-context/-b tarafından belirtilen dizin içinde Dockerfile'ın göreli yolu. Atlanırsa, './Dockerfile' kullanılır.

varsayılan değer: /Dockerfile
--file -f

Azure ML ortam belirtimini içeren YAML dosyasının yerel yolu. Ortam için YAML başvuru belgelerine şu konumdan ulaşabilirsiniz: https://aka.ms/ml-cli-v2-environment-yaml-reference.

--image -i

Docker görüntüsü. --image/-i ve --build-context/-b birbirini dışlayan bağımsız değişkenlerdir.

--name -n

Ortamın adı.

--no-wait

Uzun süre çalışan işlemin bitmesini beklemeyin.

varsayılan değer: False
--os-type

İşletim sistemi türü. İzin verilen değerler: linux, windows. Varsayılan: linux.

--registry-name

Sağlanırsa, komut çalışma alanı yerine kayıt defterini hedefler. Bu nedenle kaynak grubu ve çalışma alanı gerekli olmayacaktır.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

--set

Ayarlanacağı özellik yolunu ve değerini belirterek nesneyi güncelleştirin. Örnek: --set property1.property2=.

--tags

Nesnenin etiketleri için boşlukla ayrılmış anahtar-değer çiftleri.

--version -v

Ortamın sürümü.

--workspace-name -w

Azure ML çalışma alanının adı. varsayılan çalışma alanını kullanarak az configure --defaults workspace=<name>yapılandırabilirsiniz.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
varsayılan değer: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az ml environment list

Çalışma alanında ortamları listeleme.

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

Örnekler

Çalışma alanında tüm ortamları listeleme

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

Çalışma alanında belirtilen ad için tüm ortam sürümlerini listeleme

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

Komutların sonuçlarında JMESPath sorgusu yürütmek için --query bağımsız değişkenini kullanarak çalışma alanında tüm ortamları listeleyin.

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

Kayıt defterindeki tüm ortamları listeleme

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

Bir kayıt defterinde belirtilen ad için tüm ortam sürümlerini listeleme

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

İsteğe Bağlı Parametreler

--archived-only

Yalnızca arşivlenmiş ortamları listeleyin.

varsayılan değer: False
--include-archived

Arşivlenmiş ortamları ve etkin ortamları listeleyin.

varsayılan değer: False
--max-results -r

Döndürülecek en fazla sonuç sayısı.

--name -n

Ortamın adı. Sağlanırsa, bu adın altındaki tüm ortam sürümleri döndürülür.

--registry-name

Sağlanırsa, komut çalışma alanı yerine kayıt defterini hedefler. Bu nedenle kaynak grubu ve çalışma alanı gerekli olmayacaktır.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

--workspace-name -w

Azure ML çalışma alanının adı. varsayılan çalışma alanını kullanarak az configure --defaults workspace=<name>yapılandırabilirsiniz.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
varsayılan değer: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az ml environment restore

Arşivlenmiş bir ortamı geri yükleme.

Arşivlenmiş bir ortam geri yüklendiğinde, artık liste sorgularından (az ml environment list ) gizlenmeyecektir. Tüm ortam kapsayıcısı arşivlenmişse, arşivlenmiş kapsayıcıyı geri yükleyebilirsiniz. Bu, ortamın bu adın altındaki tüm sürümlerini geri yükler. Ortam kapsayıcısının tamamı arşivlenmişse yalnızca belirli bir ortam sürümünü geri yükleyemezsiniz. Kapsayıcının tamamını geri yüklemeniz gerekir. Yalnızca tek bir ortam sürümü arşivlendiyse, bu belirli sürümü geri yükleyebilirsiniz.

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

Örnekler

Arşivlenmiş bir ortam kapsayıcısı geri yükleme (bu ortamın tüm sürümlerini geri yükler)

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

Belirli bir arşivlenmiş ortam sürümünü geri yükleme

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

Gerekli Parametreler

--name -n

Ortamın adı.

İsteğe Bağlı Parametreler

--label -l

Ortamın etiketi.

--registry-name

Sağlanırsa, komut çalışma alanı yerine kayıt defterini hedefler. Bu nedenle kaynak grubu ve çalışma alanı gerekli olmayacaktır.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

--version -v

Ortamın sürümü.

--workspace-name -w

Azure ML çalışma alanının adı. varsayılan çalışma alanını kullanarak az configure --defaults workspace=<name>yapılandırabilirsiniz.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
varsayılan değer: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az ml environment share

Çalışma alanından kayıt defterine belirli bir ortamı paylaşın.

Çalışma alanları arası yeniden kullanmak için var olan bir ortamı çalışma alanından kayıt defterine kopyalayın.

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

Örnekler

Var olan bir ortamı çalışma alanından kayıt defterine paylaşma

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

Gerekli Parametreler

--name -n

Ortamın adı.

--registry-name

Hedef kayıt defteri.

--share-with-name

Oluşturulacak ortamın adı.

--share-with-version

Oluşturulacak ortamın sürümü.

--version -v

Ortamın sürümü.

İsteğe Bağlı Parametreler

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

--workspace-name -w

Azure ML çalışma alanının adı. varsayılan çalışma alanını kullanarak az configure --defaults workspace=<name>yapılandırabilirsiniz.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
varsayılan değer: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az ml environment show

Bir ortamın ayrıntılarını gösterme.

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

Örnekler

Belirtilen ada ve sürüme sahip bir ortamın ayrıntılarını gösterme

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

Belirtilen ad ve sürüme sahip kayıt defterindeki bir ortamın ayrıntılarını gösterme

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

Gerekli Parametreler

--name -n

Ortamın adı.

İsteğe Bağlı Parametreler

--label -l

Ortamın etiketi.

--registry-name

Sağlanırsa, komut çalışma alanı yerine kayıt defterini hedefler. Bu nedenle kaynak grubu ve çalışma alanı gerekli olmayacaktır.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

--version -v

Ortamın sürümü.

--workspace-name -w

Azure ML çalışma alanının adı. varsayılan çalışma alanını kullanarak az configure --defaults workspace=<name>yapılandırabilirsiniz.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
varsayılan değer: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az ml environment update

Bir ortamı güncelleştirme.

Yalnızca 'description' ve 'tags' özellikleri güncelleştirilebilir.

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

Gerekli Parametreler

--name -n

Ortamın adı.

İsteğe Bağlı Parametreler

--add

Bir yol ve anahtar değer çiftleri belirterek nesne listesine nesne ekleyin. Örnek: --add property.listProperty <key=value, string or JSON string>.

varsayılan değer: []
--force-string

'set' veya 'add' kullanırken, JSON'a dönüştürmeye çalışmak yerine dize değişmez değerlerini koruyun.

varsayılan değer: False
--label -l

Ortamın etiketi.

--registry-name

Sağlanırsa, komut çalışma alanı yerine kayıt defterini hedefler. Bu nedenle kaynak grubu ve çalışma alanı gerekli olmayacaktır.

--remove

Bir özelliği veya öğeyi listeden kaldırın. Örnek: --remove property.list <indexToRemove> OR --remove propertyToRemove.

varsayılan değer: []
--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

--set

Ayarlanacağı özellik yolunu ve değerini belirterek nesneyi güncelleştirin. Örnek: --set property1.property2=<value>.

varsayılan değer: []
--version -v

Ortamın sürümü.

--workspace-name -w

Azure ML çalışma alanının adı. varsayılan çalışma alanını kullanarak az configure --defaults workspace=<name>yapılandırabilirsiniz.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
varsayılan değer: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.