CLI (v2) çalışma alanı YAML şeması

Makale
07/04/2023

ŞUNLAR IÇIN GEÇERLIDIR:Azure CLI ml uzantısı v2 (geçerli)

Kaynak JSON şeması adresinde https://azuremlschemas.azureedge.net/latest/workspace.schema.jsonbulunabilir.

Not

Bu belgede ayrıntılı olarak açıklanan YAML söz dizimi, ML CLI v2 uzantısının en son sürümünün JSON şemasını temel alır. Bu söz diziminin yalnızca ML CLI v2 uzantısının en son sürümüyle çalışacağı garanti edilir. Eski uzantı sürümleri için şemaları adresinde https://azuremlschemasprod.azureedge.net/bulabilirsiniz.

YAML söz dizimi

Anahtar	Tür	Açıklama	İzin verilen değerler	Varsayılan değer
`$schema`	string	YAML şeması. YAML dosyasını yazmak için Azure Machine Learning VS Code uzantısını kullanırsanız, dosyanızın üst kısmındakiler de dahil olmak üzere `$schema` şema ve kaynak tamamlamalarını çağırmanıza olanak tanır.
`name`	string	Gereklidir. Çalışma alanının adı.
`display_name`	string	Stüdyo kullanıcı arabiriminde çalışma alanının görünen adı. Kaynak grubu içinde benzersiz olmayabilir.
`description`	string	Çalışma alanının açıklaması.
`tags`	object	Çalışma alanı için etiket sözlüğü.
`location`	string	Çalışma alanının konumu. Atlanırsa, varsayılan olarak kaynak grubu konumu kullanılır.
`resource_group`	string	Gereklidir. Çalışma alanını içeren kaynak grubu. Kaynak grubu yoksa yeni bir grup oluşturulur.
`hbi_workspace`	boolean	Müşteri verilerinin, hassas iş bilgileri içeren yüksek iş etkisi (HBI) olup olmadığı. Daha fazla bilgi için bkz. Bekleyen verileri şifreleme.		`false`
`storage_account`	string	Çalışma alanı için varsayılan depolama hesabı olarak kullanılacak mevcut bir Azure depolama hesabının tam kaynak kimliği. Premium depolama alanına veya hiyerarşik ad alanına sahip bir depolama hesabı varsayılan depolama hesabı olarak kullanılamaz. Atlanırsa yeni bir depolama hesabı oluşturulur.
`container_registry`	string	Çalışma alanı için varsayılan kapsayıcı kayıt defteri olarak kullanılacak mevcut bir Azure kapsayıcı kayıt defterinin tam kaynak kimliği. Azure Machine Learning, eğitim ve dağıtım için kullanılan kapsayıcı görüntülerini yönetmek için Azure Container Registry (ACR) kullanır. Atlanırsa yeni bir kapsayıcı kayıt defteri oluşturulur. Oluşturma işlemi yavaş yüklendiğinden, kapsayıcı kayıt defteri ilk kez eğitim veya dağıtım için bir işlem için gerekli olduğunda oluşturulur.
`key_vault`	string	Çalışma alanı için varsayılan anahtar kasası olarak kullanılacak mevcut bir Azure anahtar kasasının tam kaynak kimliği. Atlanırsa yeni bir anahtar kasası oluşturulur.
`application_insights`	string	Çalışma alanı için varsayılan uygulama içgörüleri olarak kullanılacak mevcut Azure uygulama içgörülerinin tam kaynak kimliği. Atlanırsa yeni bir uygulama içgörüleri oluşturulur.
`customer_managed_key`	object	Azure Machine Learning, meta verileri bir Azure Cosmos DB örneğinde depolar. Varsayılan olarak veriler Bekleme sırasında Microsoft tarafından yönetilen anahtarlarla şifrelenir. Şifreleme için kendi müşteri tarafından yönetilen anahtarınızı kullanmak için bu bölümde müşteri tarafından yönetilen anahtar bilgilerini belirtin. Daha fazla bilgi için bkz. Azure Cosmos DB için veri şifreleme.
`customer_managed_key.key_vault`	string	Müşteri tarafından yönetilen anahtarı içeren anahtar kasasının tam kaynak kimliği. Bu anahtar kasası, içinde `key_vault`belirtilen varsayılan çalışma alanı anahtar kasasından farklı olabilir.
`customer_managed_key.key_uri`	string	Bekleyen verileri şifrelemek için müşteri tarafından yönetilen anahtarın anahtar URI'si. URI biçimi şeklindedir `https://<keyvault-dns-name>/keys/<key-name>/<key-version>`.
`image_build_compute`	string	Kapsayıcı kayıt defteri bir sanal ağın arkasında olduğunda ortam Docker görüntüleri oluşturmak için kullanılacak işlem hedefinin adı. Daha fazla bilgi için bkz . Sanal ağların arkasındaki çalışma alanı kaynaklarının güvenliğini sağlama.
`public_network_access`	string	Çalışma alanı Özel Bağlantı kullanacaksa genel uç nokta erişimine izin verilip verilmeyeceği. Daha fazla bilgi için bkz . Sanal ağların arkasındayken genel erişimi etkinleştirme.	`enabled`, `disabled`	`disabled`
`managed_network`	object	Azure Machine Learning Çalışma Alanı yönetilen ağ izolasyonu. Daha fazla bilgi için bkz. Çalışma alanı yönetilen ağ izolasyonu.

Açıklamalar

az ml workspace Komutu, Azure Machine Learning çalışma alanlarını yönetmek için kullanılabilir.

Örnekler

Örnekler GitHub deposunda bulunabilir. Aşağıda birkaçı gösterilmiştir.

YAML: temel

$schema: https://azuremlschemas.azureedge.net/latest/workspace.schema.json
name: mlw-basic-prod
location: eastus
display_name: Basic workspace-example
description: This example shows a YML configuration for a basic workspace. In case you use this configuration to deploy a new workspace, since no existing dependent resources are specified, these will be automatically created.
hbi_workspace: false
tags:
  purpose: demonstration

YAML: mevcut kaynaklarla

$schema: https://azuremlschemas.azureedge.net/latest/workspace.schema.json
name: mlw-basicex-prod
location: eastus
display_name: Bring your own dependent resources-example
description: This configuration specifies a workspace configuration with existing dependent resources
storage_account: /subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP>/providers/Microsoft.Storage/storageAccounts/<STORAGE_ACCOUNT>
container_registry: /subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP>/providers/Microsoft.ContainerRegistry/registries/<CONTAINER_REGISTRY>
key_vault: /subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP>/providers/Microsoft.KeyVault/vaults/<KEY_VAULT>
application_insights: /subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP>/providers/Microsoft.insights/components/<APP_INSIGHTS>
tags:
  purpose: demonstration

YAML: müşteri tarafından yönetilen anahtar

$schema: https://azuremlschemas.azureedge.net/latest/workspace.schema.json
name: mlw-cmkexample-prod
location: eastus
display_name: Customer managed key encryption-example
description: This configurations shows how to create a workspace that uses customer-managed keys for encryption.
customer_managed_key: 
  key_vault: /subscriptions/<SUBSCRIPTION_ID>/resourceGroups/<RESOURCE_GROUP>/providers/Microsoft.KeyVault/vaults/<KEY_VAULT>
  key_uri: https://<KEY_VAULT>.vault.azure.net/keys/<KEY_NAME>/<KEY_VERSION>
tags:
  purpose: demonstration

YAML: özel bağlantı

$schema: https://azuremlschemas.azureedge.net/latest/workspace.schema.json
name: mlw-privatelink-prod
location: eastus
display_name: Private Link endpoint workspace-example
description: When using private link, you must set the image_build_compute property to a cluster name to use for Docker image environment building. You can also specify whether the workspace should be accessible over the internet.
image_build_compute: cpu-compute
public_network_access: Disabled
tags:
  purpose: demonstration

YAML: yüksek iş etkisi

$schema: https://azuremlschemas.azureedge.net/latest/workspace.schema.json
name: mlw-hbiexample-prod
location: eastus
display_name: High business impact-example
description: This configuration shows how to configure a workspace with the hbi flag enabled. This flag specifies whether to reduce telemetry collection and enable additional encryption when high-business-impact data is used.
hbi_workspace: true
tags:
  purpose: demonstration

YAML: İnternet'e gidene izin veren yönetilen ağ

name: myworkspace_aio
managed_network:
  isolation_mode: allow_internet_outbound
  outbound_rules:
  - name: added-perule
    type: private_endpoint
    destination:
      service_resource_id: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/MyGroup/providers/Microsoft.Storage/storageAccounts/MyAccount1
      spark_enabled: true
      subresource_target: blob
  - name: added-perule2
    type: private_endpoint
    destination:
      service_resource_id: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/MyGroup/providers/Microsoft.Storage/storageAccounts/MyAccount2
      spark_enabled: true
      subresource_target: file

YAML: Yalnızca onaylanan gidene izin veren yönetilen ağ

name: myworkspace_dep
managed_network:
  isolation_mode: allow_only_approved_outbound
  outbound_rules:
  - name: added-servicetagrule
    type: service_tag
    destination:
      port_ranges: 80, 8080
      protocol: TCP
      service_tag: DataFactory
  - name: added-perule
    type: private_endpoint
    destination:
      service_resource_id: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/MyGroup/providers/Microsoft.Storage/storageAccounts/MyAccount2
      spark_enabled: true
      subresource_target: blob
  - name: added-fqdnrule
    type: fqdn
    destination: 'test2.com'

Sonraki adımlar

CLI'yi yükleme ve kullanma (v2)

Aracılığıyla paylaş