Compartilhar via


AksCompute Classe

Gerencia um destino de computação do Serviço de Kubernetes do Azure no Azure Machine Learning.

Os destinos (AksCompute) do Serviço de Kubernetes do Azure normalmente são usados para implantações de produção em grande escala, pois eles fornecem tempo de resposta rápido e dimensionamento automático do serviço implantado. Para obter mais informações, confira O que são destinos de computação no Azure Machine Learning?

Construtor ComputeTarget de classe.

Recupere uma representação na nuvem de um objeto Compute associado ao workspace fornecido. Retorna uma instância de uma classe filho correspondente ao tipo específico do objeto Compute recuperado.

Herança
AksCompute

Construtor

AksCompute(workspace, name)

Parâmetros

Nome Description
workspace
Obrigatório

O objeto de workspace que contém o objeto AksCompute a ser recuperado.

name
Obrigatório
str

O nome do objeto AksCompute a ser recuperado.

workspace
Obrigatório

O objeto de workspace que contém o objeto Compute a ser recuperado.

name
Obrigatório
str

O nome do do objeto Compute a ser recuperado.

Comentários

O exemplo a seguir mostra como criar um cluster do AKS com computadores habilitados para FPGA.


   from azureml.core.compute import AksCompute, ComputeTarget

   # Uses the specific FPGA enabled VM (sku: Standard_PB6s)
   # Standard_PB6s are available in: eastus, westus2, westeurope, southeastasia
   prov_config = AksCompute.provisioning_configuration(vm_size = "Standard_PB6s",
                                                       agent_count = 1,
                                                       location = "eastus")

   aks_name = 'my-aks-pb6'
   # Create the cluster
   aks_target = ComputeTarget.create(workspace = ws,
                                     name = aks_name,
                                     provisioning_configuration = prov_config)

Métodos

attach

PRETERIDO. Use o método attach_configuration em seu lugar.

Associa um recurso de computação do AKS com o workspace fornecido.

attach_configuration

Cria um objeto de configuração para anexar um destino de computação do AKS.

delete

Remove o objeto AksCompute do workspace associado.

Se esse objeto foi criado por meio do Azure Machine Learning, os objetos baseados em nuvem correspondentes também serão excluídos. Se esse objeto foi criado externamente e apenas anexado ao workspace, esse método gerará um ComputeTargetException e nada será alterado.

deserialize

Converte um objeto JSON em um objeto AksCompute.

detach

Desanexa o objeto AksCompute do workspace associado.

Os objetos de nuvem subjacentes não são excluídos, apenas a associação é removida.

get_credentials

Recupera as credenciais para o destino do AKS.

provisioning_configuration

Cria um objeto de configuração para provisionar um destino de computação do AKS.

refresh_state

Executar uma atualização local das propriedades do objeto.

Esse método atualiza as propriedades com base no estado atual do objeto de nuvem correspondente. Isso é usado principalmente para sondagem manual do estado de computação.

serialize

Converte esse objeto AksCompute em um dicionário serializado JSON.

update

Atualiza o objeto AksCompute usando a configuração de atualização fornecida.

attach

PRETERIDO. Use o método attach_configuration em seu lugar.

Associa um recurso de computação do AKS com o workspace fornecido.

static attach(workspace, name, resource_id)

Parâmetros

Nome Description
workspace
Obrigatório

O objeto de workspace ao qual associar o recurso de computação.

name
Obrigatório
str

O nome a ser associado ao recurso de computação dentro do workspace fornecido. Esse nome não precisa corresponder ao nome do recurso de computação a ser anexado.

resource_id
Obrigatório
str

A ID do recurso do Azure para o recurso de computação que está sendo anexado.

Retornos

Tipo Description

Uma representação de objeto AksCompute do objeto de computação.

Exceções

Tipo Description

attach_configuration

Cria um objeto de configuração para anexar um destino de computação do AKS.

static attach_configuration(resource_group=None, cluster_name=None, resource_id=None, cluster_purpose=None, load_balancer_type=None, load_balancer_subnet=None)

Parâmetros

Nome Description
resource_group
str

O nome do grupo de recursos no qual o AKS está localizado.

Valor padrão: None
cluster_name
str

O nome do cluster do AKS.

Valor padrão: None
resource_id
str

A ID do recurso do Azure para o recurso de computação que está sendo anexado.

Valor padrão: None
cluster_purpose
str

O uso direcionado do cluster. Isso é usado para provisionar os componentes do Azure Machine Learning a fim de garantir o nível desejado de tolerância a falhas e QoS. A classe ClusterPurpose define os valores possíveis. Para obter mais informações, consulte Anexar um cluster do AKS existente.

Valor padrão: None
load_balancer_type
str

O tipo do cluster do AKS. Os valores válidos são PublicIp e InternalLoadBalancer. O valor padrão é PublicIp.

Valor padrão: None
load_balancer_subnet
str

A sub-rede do balanceador de carga do AKS. Pode ser usado apenas quando o InternalLoadBalancer for usado como tipo de balanceador de carga. O valor padrão é aks-subnet.

Valor padrão: None

Retornos

Tipo Description

Um objeto de configuração a ser usado ao anexar um objeto Compute.

Exceções

Tipo Description

delete

Remove o objeto AksCompute do workspace associado.

Se esse objeto foi criado por meio do Azure Machine Learning, os objetos baseados em nuvem correspondentes também serão excluídos. Se esse objeto foi criado externamente e apenas anexado ao workspace, esse método gerará um ComputeTargetException e nada será alterado.

delete()

Exceções

Tipo Description

deserialize

Converte um objeto JSON em um objeto AksCompute.

static deserialize(workspace, object_dict)

Parâmetros

Nome Description
workspace
Obrigatório

O objeto de workspace ao qual o objeto AksCompute está associado.

object_dict
Obrigatório

Um objeto JSON para converter em um objeto AksCompute.

Retornos

Tipo Description

A representação AksCompute do objeto JSON fornecido.

Exceções

Tipo Description

Comentários

Gera uma ComputeTargetException se o workspace fornecido não é o workspace ao qual a computação está associada.

detach

Desanexa o objeto AksCompute do workspace associado.

Os objetos de nuvem subjacentes não são excluídos, apenas a associação é removida.

detach()

Exceções

Tipo Description

get_credentials

Recupera as credenciais para o destino do AKS.

get_credentials()

Retornos

Tipo Description

As credenciais para o destino do AKS.

Exceções

Tipo Description

provisioning_configuration

Cria um objeto de configuração para provisionar um destino de computação do AKS.

static provisioning_configuration(agent_count=None, vm_size=None, ssl_cname=None, ssl_cert_pem_file=None, ssl_key_pem_file=None, location=None, vnet_resourcegroup_name=None, vnet_name=None, subnet_name=None, service_cidr=None, dns_service_ip=None, docker_bridge_cidr=None, cluster_purpose=None, load_balancer_type=None, load_balancer_subnet=None)

Parâmetros

Nome Description
agent_count
int

O número de agentes (VMs) para hospedar contêineres. O valor padrão é 3.

Valor padrão: None
vm_size
str

O tamanho das VMs do agente. Uma lista completa de opções pode ser encontrada aqui: https://aka.ms/azureml-aks-details. O padrão é Standard_D3_v2.

Valor padrão: None
ssl_cname
str

Um CName a ser usado ao habilitar a validação SSL no cluster. Deve fornecer todos os três CName, arquivo de certificado e arquivo de chave para habilitar a validação SSL.

Valor padrão: None
ssl_cert_pem_file
str

Um caminho de arquivo para um arquivo contendo informações de certificado para validação SSL. Deve fornecer todos os três CName, arquivo de certificado e arquivo de chave para habilitar a validação SSL.

Valor padrão: None
ssl_key_pem_file
str

Um caminho de arquivo para um arquivo contendo informações de chave para validação SSL. Deve fornecer todos os três CName, arquivo de certificado e arquivo de chave para habilitar a validação SSL.

Valor padrão: None
location
str

O local onde provisionar o cluster. Se não for especificado, o padrão será o local do workspace. As regiões disponíveis para essa computação podem ser encontradas aqui: https://azure.microsoft.com/global-infrastructure/services/?regions=all& products=kubernetes-service

Valor padrão: None
vnet_resourcegroup_name
str

O nome do grupo de recursos no qual a rede virtual está localizada.

Valor padrão: None
vnet_name
str

O nome da rede virtual.

Valor padrão: None
subnet_name
str

O nome da sub-rede dentro da VNet.

Valor padrão: None
service_cidr
str

Um intervalo IP com notação CIDR do qual designar serviço cluster IPs.

Valor padrão: None
dns_service_ip
str

Endereço IP do servidor DNS dos contêineres.

Valor padrão: None
docker_bridge_cidr
str

Um IP de notação CIDR para a ponte do Docker.

Valor padrão: None
cluster_purpose
str

Uso direcionado do cluster. Isso é usado para provisionar os componentes do Azure Machine Learning a fim de garantir o nível desejado de tolerância a falhas e QoS. A classe AksCompute.ClusterPurpose é fornecida para conveniência de especificar valores disponíveis. Informações mais detalhadas sobre esses valores e seus casos de uso podem ser encontradas aqui: https://aka.ms/azureml-create-attach-aks

Valor padrão: None
load_balancer_type
str

Tipo de balanceador de carga do cluster do AKS. Os valores válidos são PublicIp e InternalLoadBalancer. O valor padrão é PublicIp.

Valor padrão: None
load_balancer_subnet
str

Sub-rede do balanceador de carga do cluster do AKS. Pode ser usado apenas quando o Load Balancer interno é usado como tipo de balanceador de carga. O valor padrão é aks-subnet.

Valor padrão: None

Retornos

Tipo Description

Um objeto de configuração a ser usado ao criar um objeto Compute

Exceções

Tipo Description

refresh_state

Executar uma atualização local das propriedades do objeto.

Esse método atualiza as propriedades com base no estado atual do objeto de nuvem correspondente. Isso é usado principalmente para sondagem manual do estado de computação.

refresh_state()

Exceções

Tipo Description

serialize

Converte esse objeto AksCompute em um dicionário serializado JSON.

serialize()

Retornos

Tipo Description

A representação JSON desse objeto AksCompute.

Exceções

Tipo Description

update

Atualiza o objeto AksCompute usando a configuração de atualização fornecida.

update(update_configuration)

Parâmetros

Nome Description
update_configuration
Obrigatório

Um objeto de configuração de atualização do AKS.

Exceções

Tipo Description