Compartilhar via

Esquema YAML de cluster de cálculo (AmlCompute) da CLI (v2)

  • Artigo

APLICA-SE A: Extensão de ML da CLI do Azurev2 (atual)

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

Observação

A sintaxe YAML detalhada neste documento baseia-se no esquema JSON da última versão da extensão de ML da CLI v2. Essa sintaxe só tem a garantia de funcionar com a última versão da extensão de ML da CLI v2. Encontre os esquemas para as versões mais antigas da extensão em https://azuremlschemasprod.azureedge.net/.

Sintaxe YAML

Chave Type Descrição Valores permitidos Valor padrão
$schema string O esquema YAML. Se você usar a extensão do Azure Machine Learning para VS Code para criar o arquivo YAML, a inclusão de $schema no início do arquivo permitirá invocar conclusões de esquema e recursos.
type string Obrigatórios. O tipo de computação. amlcompute
name string Obrigatórios. Nome da computação.
description string Descrição da computação.
location string O local do cálculo. 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 saber mais, confira Tamanhos e séries de VM compatíveis. Note que nem todos os tamanhos estão disponíveis em todas as regiões. Para obter a lista de tamanhos com suporte em uma determinada região, use az ml compute list-sizes. Standard_DS3_v2
tier string O nível de prioridade da VM a ser usado para o cluster. As VMs de baixa prioridade são preemptivas, mas têm um custo reduzido em comparação com as VMs dedicadas. dedicated, low_priority dedicated
min_instances inteiro O número mínimo de nós a ser usado no cluster. A definição do número mínimo de nós como 0 permite que o Azure Machine Learning escale automaticamente o cluster para zero nós quando ele não estiver em uso. Qualquer valor maior do que 0 manterá esse número de nós em execução, mesmo se o cluster não estiver em uso. 0
max_instances inteiro O número máximo de nós a ser usado no cluster. 1
idle_time_before_scale_down inteiro Tempo ocioso do nó em segundos antes de reduzir verticalmente o cluster. 120
ssh_public_access_enabled booleano Se deve o acesso público ao SSH deve ser habilitado nos nós do cluster. false
ssh_settings objeto Configurações de SSH para conectar-se ao 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 do usuário administrador. Um dos dois é obrigatório, admin_password ou ssh_key_value.
ssh_settings.ssh_key_value string A chave pública SSH da conta do usuário administrador. Um dos dois é obrigatório, admin_password ou ssh_key_value.
network_settings objeto Configurações de segurança de rede.
network_settings.vnet_name string O nome da VNet (rede virtual) ao criar ou fazer referência a alguma existente.
network_settings.subnet string O nome da sub-rede ao criar uma nova VNet ou fazer referência a alguma existente, ou a ID de recurso totalmente qualificada de uma sub-rede em uma VNet existente. Não especifique network_settings.vnet_name se a ID da sub-rede tiver sido especificada. A ID de sub-rede pode fazer referência a uma VNet/sub-rede em outro grupo de recursos.
identity objeto A configuração de identidade gerenciada a ser atribuída ao cálculo. Os clusters AmlCompute oferecem suporte a apenas uma identidade atribuída pelo sistema ou a várias identidades atribuídas pelo usuário, não às duas simultaneamente.
identity.type string O tipo de identidade gerenciada a ser atribuído ao cálculo. Se o tipo for user_assigned, a propriedade identity.user_assigned_identities também deverá ser especificada. system_assigned, user_assigned
identity.user_assigned_identities array Lista de IDs de recurso totalmente qualificadas das identidades atribuídas pelo usuário.

Comentários

O comando az ml compute pode ser usado para gerenciar clusters de cálculo do Azure Machine Learning (AmlCompute).

Exemplos

Os exemplos estão disponíveis no repositório de exemplos do GitHub. 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: nome de usuário e senha SSH

$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óximas etapas