Schemat YAML obszaru roboczego interfejsu wiersza polecenia (wersja 2)

Artykuł
09/01/2024

DOTYCZY: Rozszerzenie interfejsu wiersza polecenia platformy Azure ml w wersji 2 (bieżąca)

Źródłowy schemat JSON można znaleźć pod adresem https://azuremlschemas.azureedge.net/latest/workspace.schema.json.

Uwaga

Składnia YAML szczegółowo w tym dokumencie jest oparta na schemacie JSON dla najnowszej wersji rozszerzenia interfejsu wiersza polecenia uczenia maszynowego w wersji 2. Ta składnia jest gwarantowana tylko do pracy z najnowszą wersją rozszerzenia interfejsu wiersza polecenia uczenia maszynowego w wersji 2. Schematy dla starszych wersji rozszerzeń można znaleźć pod adresem https://azuremlschemasprod.azureedge.net/.

Składnia YAML

Klucz	Type	Opis	Dozwolone wartości	Domyślna wartość
`$schema`	string	Schemat YAML. Jeśli używasz rozszerzenia programu VS Code usługi Azure Machine Learning do tworzenia pliku YAML, w tym `$schema` w górnej części pliku, możesz wywołać uzupełnianie schematu i zasobów.
`name`	string	Wymagany. Nazwa obszaru roboczego.
`display_name`	string	Nazwa wyświetlana obszaru roboczego w interfejsie użytkownika programu Studio. Może być nieu unikatowa w grupie zasobów.
`description`	string	Opis obszaru roboczego.
`tags`	obiekt	Słownik tagów dla obszaru roboczego.
`location`	string	Lokalizacja obszaru roboczego. W przypadku pominięcia wartość domyślna to lokalizacja grupy zasobów.
`resource_group`	string	Wymagany. Grupa zasobów zawierająca obszar roboczy. Jeśli grupa zasobów nie istnieje, zostanie utworzona nowa grupa zasobów.
`hbi_workspace`	boolean	Określa, czy dane klienta mają duży wpływ na działalność biznesową (HBI), zawierające poufne informacje biznesowe. Aby uzyskać więcej informacji, zobacz Szyfrowanie danych magazynowanych.		`false`
`storage_account`	string	W pełni kwalifikowany identyfikator zasobu istniejącego konta usługi Azure Storage do użycia jako domyślne konto magazynu dla obszaru roboczego. Konto magazynu z magazynem w warstwie Premium lub hierarchiczną przestrzenią nazw nie może być używane jako domyślne konto magazynu. W przypadku pominięcia zostanie utworzone nowe konto magazynu.
`container_registry`	string	W pełni kwalifikowany identyfikator zasobu istniejącego rejestru kontenerów platformy Azure do użycia jako domyślny rejestr kontenerów dla obszaru roboczego. Usługa Azure Machine Learning używa usługi Azure Container Registry (ACR) do zarządzania obrazami kontenerów używanymi do trenowania i wdrażania. W przypadku pominięcia zostanie utworzony nowy rejestr kontenerów. Tworzenie jest ładowane z opóźnieniem, więc rejestr kontenerów jest tworzony po raz pierwszy do wykonania operacji trenowania lub wdrażania.
`key_vault`	string	W pełni kwalifikowany identyfikator zasobu istniejącego magazynu kluczy platformy Azure do użycia jako domyślny magazyn kluczy dla obszaru roboczego. W przypadku pominięcia zostanie utworzony nowy magazyn kluczy.
`application_insights`	string	W pełni kwalifikowany identyfikator zasobu istniejącej usługi Azure Application Insights do użycia jako domyślna usługa Application Insights dla obszaru roboczego. W przypadku pominięcia zostanie utworzona nowa usługa Application Insights.
`customer_managed_key`	obiekt	Usługa Azure Machine Learning przechowuje metadane w wystąpieniu usługi Azure Cosmos DB. Domyślnie dane są szyfrowane w spoczynku przy użyciu kluczy zarządzanych przez firmę Microsoft. Aby użyć własnego klucza zarządzanego przez klienta do szyfrowania, określ informacje o kluczu zarządzanym przez klienta w tej sekcji. Aby uzyskać więcej informacji, zobacz Szyfrowanie danych dla usługi Azure Cosmos DB.
`customer_managed_key.key_vault`	string	W pełni kwalifikowany identyfikator zasobu magazynu kluczy zawierający klucz zarządzany przez klienta. Ten magazyn kluczy może być inny niż domyślny magazyn kluczy obszaru roboczego określony w pliku `key_vault`.
`customer_managed_key.key_uri`	string	Identyfikator URI klucza zarządzanego przez klienta do szyfrowania danych magazynowanych. Format identyfikatora URI to `https://<keyvault-dns-name>/keys/<key-name>/<key-version>`.
`image_build_compute`	string	Nazwa docelowego obiektu obliczeniowego używanego do kompilowania obrazów platformy Docker, gdy rejestr kontenerów znajduje się za siecią wirtualną. Aby uzyskać więcej informacji, zobacz Zabezpieczanie zasobów obszaru roboczego za sieciami wirtualnymi.
`public_network_access`	string	Czy dostęp do publicznego punktu końcowego jest dozwolony, jeśli obszar roboczy będzie używał usługi Private Link. Aby uzyskać więcej informacji, zobacz Włączanie dostępu publicznego, gdy znajduje się za sieciami wirtualnymi.	`enabled`, `disabled`	`disabled`
`managed_network`	obiekt	Zarządzana izolacja sieci obszaru roboczego usługi Azure Machine Learning. Aby uzyskać więcej informacji, zobacz Obszar roboczy zarządzana izolacja sieci.

Uwagi

Polecenie az ml workspace może służyć do zarządzania obszarami roboczymi usługi Azure Machine Learning.

Przykłady

Przykłady są dostępne w repozytorium GitHub przykłady. Poniżej przedstawiono kilka z poniższych elementów.

YAML: podstawowy

$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: z istniejącymi zasobami

$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: klucz zarządzany przez klienta

$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: link prywatny

$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: duży wpływ na działalność biznesową

$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: zarządzana sieć z zezwalają na ruch wychodzący z Internetu

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: zarządzana sieć z dozwolonymi tylko zatwierdzonymi wychodzącymi

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'

Następne kroki

Instalowanie i używanie interfejsu wiersza polecenia (wersja 2)

Udostępnij za pośrednictwem