Partilhar via

Esquema YAML do cluster de computação CLI (v2) (AmlCompute)

  • Artigo

APLICA-SE A: Azure CLI ml extension v2 (atual)

O esquema JSON de origem pode ser encontrado em https://azuremlschemas.azureedge.net/latest/amlCompute.schema.json.

Nota

A sintaxe YAML detalhada neste documento é baseada no esquema JSON para a versão mais recente da extensão ML CLI v2. Esta sintaxe é garantida apenas para funcionar com a versão mais recente da extensão ML CLI v2. Você pode encontrar os esquemas para versões de extensão mais antigas em https://azuremlschemasprod.azureedge.net/.

Sintaxe YAML

Chave Tipo Description Valores permitidos Default value
$schema string O esquema YAML. Se você usar a extensão VS Code do Aprendizado de Máquina do Azure para criar o arquivo YAML, inclusive $schema na parte superior do arquivo permitirá que você invoque o esquema e as completações de recursos.
type string Obrigatório. O tipo de computação. amlcompute
name string Obrigatório. Nome do cálculo.
description string Descrição do cálculo.
location string O local para a computação. Se omitido, o padrão será o local do espaço de trabalho.
size string O tamanho da VM a ser usado para o cluster. Para obter mais informações, consulte Série e tamanhos de VM suportados. Observe que nem todos os tamanhos estão disponíveis em todas as regiões. Para obter a lista de tamanhos suportados em uma determinada região, use az ml compute list-sizes. Standard_DS3_v2
tier string A camada de prioridade da VM a ser usada para o cluster. As VMs de baixa prioridade são pré-emptíveis, mas têm um custo reduzido em comparação com as VMs dedicadas. dedicated, low_priority dedicated
min_instances integer O número mínimo de nós a serem usados no cluster. Definir o número mínimo de nós para 0 permitir que o Aprendizado de Máquina do Azure dimensione automaticamente o cluster para zero nós quando não estiver em uso. Qualquer valor maior do que 0 manterá esse número de nós em execução, mesmo que o cluster não esteja em uso. 0
max_instances integer O número máximo de nós a serem usados no cluster. 1
idle_time_before_scale_down integer Tempo ocioso do nó em segundos antes de reduzir o cluster. 120
ssh_public_access_enabled boolean Se o acesso SSH público deve ser habilitado nos nós do cluster. false
ssh_settings objeto Configurações de SSH para conexão com o cluster.
ssh_settings.admin_username string O nome da conta de usuário administrador que pode ser usada para SSH em nós.
ssh_settings.admin_password string A senha da conta de usuário administrador. Um dos admin_password ou ssh_key_value é obrigatório.
ssh_settings.ssh_key_value string A chave pública SSH da conta de usuário administrador. Um dos admin_password ou ssh_key_value é obrigatório.
network_settings objeto Configurações de segurança de rede.
network_settings.vnet_name string Nome da rede virtual (VNet) ao criar uma nova ou fazer referência a uma existente.
network_settings.subnet string O nome da sub-rede ao criar uma nova VNet ou fazer referência a uma existente, ou a ID de recurso totalmente qualificada de uma sub-rede em uma VNet existente. Não especifique network_settings.vnet_name se o ID da sub-rede é especificado. O ID da sub-rede pode referir-se a uma rede virtual/sub-rede em outro grupo de recursos.
identity objeto A configuração de identidade gerenciada a ser atribuída à computação. Os clusters AmlCompute suportam apenas uma identidade atribuída pelo sistema ou várias identidades atribuídas pelo usuário, não ambas simultaneamente.
identity.type string O tipo de identidade gerenciada a ser atribuída à computação. Se o tipo for user_assigned, a identity.user_assigned_identities propriedade também deve ser especificada. system_assigned, user_assigned
identity.user_assigned_identities matriz Lista de IDs de recursos totalmente qualificados das identidades atribuídas pelo usuário.

Observações

Os az ml compute comandos podem ser usados para gerenciar clusters de computação do Azure Machine Learning (AmlCompute).

Exemplos

Exemplos estão disponíveis no repositório GitHub de exemplos. Vários são mostrados abaixo.

YAML: mínimo

$schema: https://azuremlschemas.azureedge.net/latest/amlCompute.schema.json 
name: minimal-example
type: amlcompute

YAML: básico

$schema: https://azuremlschemas.azureedge.net/latest/amlCompute.schema.json 
name: basic-example
type: amlcompute
size: STANDARD_DS3_v2
min_instances: 0
max_instances: 2
idle_time_before_scale_down: 120

YAML: localização personalizada

$schema: https://azuremlschemas.azureedge.net/latest/amlCompute.schema.json 
name: location-example
type: amlcompute
size: STANDARD_DS3_v2
min_instances: 0
max_instances: 2
idle_time_before_scale_down: 120
location: westus

YAML: baixa prioridade

$schema: https://azuremlschemas.azureedge.net/latest/amlCompute.schema.json 
name: low-pri-example
type: amlcompute
size: STANDARD_DS3_v2
min_instances: 0
max_instances: 2
idle_time_before_scale_down: 120
tier: low_priority

YAML: SSH nome de usuário e senha

$schema: https://azuremlschemas.azureedge.net/latest/amlCompute.schema.json 
name: ssh-example
type: amlcompute
size: STANDARD_DS3_v2
min_instances: 0
max_instances: 2
idle_time_before_scale_down: 120
ssh_settings:
  admin_username: example-user
  admin_password: example-password

Próximos passos