AksCompute Classe

Gere um destino de computação Azure Kubernetes Service no Azure Machine Learning.

Azure Kubernetes Service (AKSCompute) são normalmente utilizados para implementações de produção de alta escala, uma vez que fornecem tempo de resposta rápido e dimensionamento automático do serviço implementado. Para obter mais informações, veja O que são destinos de computação no Azure Machine Learning?

Construtor Class ComputeTarget.

Obtenha uma representação na cloud de um objeto de Computação associado à área de trabalho fornecida. Devolve uma instância de uma classe subordinada correspondente ao tipo específico do objeto de Computação obtido.

Herança
AksCompute

Construtor

AksCompute(workspace, name)

Parâmetros

workspace
Workspace
Necessário

O objeto da área de trabalho que contém o objeto AksCompute a obter.

name
str
Necessário

O nome do objeto AksCompute a obter.

workspace
Workspace
Necessário

O objeto da área de trabalho que contém o objeto Computação a obter.

name
str
Necessário

O nome do objeto Computação a obter.

Observações

O exemplo seguinte mostra como criar um cluster do AKS com máquinas compatíveis com 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. Em alternativa, utilize o attach_configuration método .

Associe um recurso de computação do AKS existente à área de trabalho fornecida.

attach_configuration

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

delete

Remova o objeto AksCompute da área de trabalho associada.

Se este objeto tiver sido criado através do Azure Machine Learning, os objetos baseados na cloud correspondentes também serão eliminados. Se este objeto tiver sido criado externamente e apenas anexado à área de trabalho, este método gera um ComputeTargetException e nada é alterado.

deserialize

Converta um objeto JSON num objeto AksCompute.

detach

Desanexe o objeto AksCompute da área de trabalho associada.

Os objetos de cloud subjacentes não são eliminados, apenas a associação é removida.

get_credentials

Obtenha as credenciais para o destino do AKS.

provisioning_configuration

Crie um objeto de configuração para aprovisionar um destino de computação do AKS.

refresh_state

Efetue uma atualização no local das propriedades do objeto.

Este método atualiza as propriedades com base no estado atual do objeto de cloud correspondente. Isto é utilizado principalmente para consultas manuais do estado de computação.

serialize

Converta este objeto AksCompute num dicionário json serializado.

update

Atualize o objeto AksCompute com a configuração de atualização fornecida.

attach

PRETERIDO. Em alternativa, utilize o attach_configuration método .

Associe um recurso de computação do AKS existente à área de trabalho fornecida.

static attach(workspace, name, resource_id)

Parâmetros

workspace
Workspace
Necessário

O objeto da área de trabalho ao qual associar o recurso de computação.

name
str
Necessário

O nome a associar ao recurso de computação dentro da área de trabalho fornecida. Não tem de corresponder ao nome do recurso de computação a anexar.

resource_id
str
Necessário

O ID de recurso do Azure para o recurso de computação que está a ser anexado.

Devoluções

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

Tipo de retorno

Exceções

attach_configuration

Crie 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

resource_group
str
valor predefinido: None

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

cluster_name
str
valor predefinido: None

O nome do cluster do AKS.

resource_id
str
valor predefinido: None

O ID de recurso do Azure para o recurso de computação que está a ser anexado.

cluster_purpose
str
valor predefinido: None

A utilização direcionada do cluster. Isto é utilizado para aprovisionar componentes do Azure Machine Learning para garantir o nível pretendido de tolerância a falhas e QoS. A ClusterPurpose classe define os valores possíveis. Para obter mais informações, veja Anexar um cluster do AKS existente.

load_balancer_type
str
valor predefinido: None

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

load_balancer_subnet
str
valor predefinido: None

A sub-rede do balanceador de carga do AKS. Só pode ser utilizado quando InternalLoadBalancer é utilizado como tipo de balanceador de carga. O valor predefinido é aks-sub-net.

Devoluções

Um objeto de configuração a ser utilizado ao anexar um objeto de Computação.

Tipo de retorno

Exceções

delete

Remova o objeto AksCompute da área de trabalho associada.

Se este objeto tiver sido criado através do Azure Machine Learning, os objetos baseados na cloud correspondentes também serão eliminados. Se este objeto tiver sido criado externamente e apenas anexado à área de trabalho, este método gera um ComputeTargetException e nada é alterado.

delete()

Exceções

deserialize

Converta um objeto JSON num objeto AksCompute.

static deserialize(workspace, object_dict)

Parâmetros

workspace
Workspace
Necessário

O objeto da área de trabalho ao que o objeto AksCompute está associado.

object_dict
dict
Necessário

Um objeto JSON para converter num objeto AksCompute.

Devoluções

A representação AksCompute do objeto JSON fornecido.

Tipo de retorno

Exceções

Observações

Gera um ComputeTargetException se a área de trabalho fornecida não for a área de trabalho à que a Computação está associada.

detach

Desanexe o objeto AksCompute da área de trabalho associada.

Os objetos de cloud subjacentes não são eliminados, apenas a associação é removida.

detach()

Exceções

get_credentials

Obtenha as credenciais para o destino do AKS.

get_credentials()

Devoluções

As credenciais do destino do AKS.

Tipo de retorno

Exceções

provisioning_configuration

Crie um objeto de configuração para aprovisionar 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

agent_count
int
valor predefinido: None

O número de agentes (VMs) para alojar contentores. A predefinição é 3.

vm_size
str
valor predefinido: None

O tamanho das VMs do agente. Pode encontrar uma lista completa de opções aqui: https://aka.ms/azureml-aks-details. A predefinição é Standard_D3_v2.

ssl_cname
str
valor predefinido: None

Um CName a utilizar se ativar a validação de SSL no cluster. Tem de fornecer os três ficheiros CName, cert e key para ativar a validação SSL.

ssl_cert_pem_file
str
valor predefinido: None

Um caminho de ficheiro para um ficheiro que contém informações de certificado para validação SSL. Tem de fornecer os três ficheiros CName, cert e key para ativar a validação SSL.

ssl_key_pem_file
str
valor predefinido: None

Um caminho de ficheiro para um ficheiro que contém informações de chave para validação SSL. Tem de fornecer os três ficheiros CName, cert e key para ativar a validação SSL.

location
str
valor predefinido: None

A localização para aprovisionar o cluster. Se não for especificado, a predefinição será a localização da área de trabalho. As regiões disponíveis para esta computação podem ser encontradas aqui: https://azure.microsoft.com/global-infrastructure/services/?regions=all& products=kubernetes-service

vnet_resourcegroup_name
str
valor predefinido: None

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

vnet_name
str
valor predefinido: None

O nome da rede virtual.

subnet_name
str
valor predefinido: None

O nome da sub-rede dentro da vnet.

service_cidr
str
valor predefinido: None

Um intervalo de IP de notação CIDR a partir do qual atribuir IPs de cluster de serviço.

dns_service_ip
str
valor predefinido: None

Endereço IP do servidor DNS de contentores.

docker_bridge_cidr
str
valor predefinido: None

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

cluster_purpose
str
valor predefinido: None

Utilização direcionada do cluster. Isto é utilizado para aprovisionar componentes do Azure Machine Learning para garantir o nível pretendido de tolerância a falhas e QoS. A classe AksCompute.ClusterPurpose é fornecida para conveniência de especificar valores disponíveis. Pode encontrar informações mais detalhadas sobre estes valores e os respetivos casos de utilização aqui: https://aka.ms/azureml-create-attach-aks

load_balancer_type
str
valor predefinido: None

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

load_balancer_subnet
str
valor predefinido: None

Sub-rede do balanceador de carga do cluster do AKS. Só pode ser utilizado quando a Balanceador de Carga interna é utilizada como tipo de balanceador de carga. O valor predefinido é aks-sub-net.

Devoluções

Um objeto de configuração a ser utilizado ao criar um objeto de Computação

Tipo de retorno

Exceções

refresh_state

Efetue uma atualização no local das propriedades do objeto.

Este método atualiza as propriedades com base no estado atual do objeto de cloud correspondente. Isto é utilizado principalmente para consultas manuais do estado de computação.

refresh_state()

Exceções

serialize

Converta este objeto AksCompute num dicionário json serializado.

serialize()

Devoluções

A representação JSON deste objeto AksCompute.

Tipo de retorno

Exceções

update

Atualize o objeto AksCompute com a configuração de atualização fornecida.

update(update_configuration)

Parâmetros

update_configuration
AksUpdateConfiguration
Necessário

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

Exceções