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

Name Description
workspace
Necessário

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

name
Necessário
str

O nome do objeto AksCompute a obter.

workspace
Necessário

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

name
Necessário
str

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

Name Description
workspace
Necessário

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

name
Necessário
str

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
Necessário
str

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

Devoluções

Tipo Description

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

Exceções

Tipo Description

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

Name Description
resource_group
str

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

Default value: None
cluster_name
str

O nome do cluster do AKS.

Default value: None
resource_id
str

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

Default value: None
cluster_purpose
str

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.

Default value: None
load_balancer_type
str

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

Default value: None
load_balancer_subnet
str

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.

Default value: None

Devoluções

Tipo Description

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

Exceções

Tipo Description

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

Tipo Description

deserialize

Converta um objeto JSON num objeto AksCompute.

static deserialize(workspace, object_dict)

Parâmetros

Name Description
workspace
Necessário

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

object_dict
Necessário

Um objeto JSON para converter num objeto AksCompute.

Devoluções

Tipo Description

A representação AksCompute do objeto JSON fornecido.

Exceções

Tipo Description

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

Tipo Description

get_credentials

Obtenha as credenciais para o destino do AKS.

get_credentials()

Devoluções

Tipo Description

As credenciais do destino do AKS.

Exceções

Tipo Description

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

Name Description
agent_count
int

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

Default value: None
vm_size
str

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.

Default value: None
ssl_cname
str

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.

Default value: None
ssl_cert_pem_file
str

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.

Default value: None
ssl_key_pem_file
str

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.

Default value: None
location
str

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

Default value: None
vnet_resourcegroup_name
str

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

Default value: None
vnet_name
str

O nome da rede virtual.

Default value: None
subnet_name
str

O nome da sub-rede dentro da vnet.

Default value: None
service_cidr
str

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

Default value: None
dns_service_ip
str

Endereço IP do servidor DNS de contentores.

Default value: None
docker_bridge_cidr
str

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

Default value: None
cluster_purpose
str

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

Default value: 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 predefinido é PublicIp.

Default value: None
load_balancer_subnet
str

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.

Default value: None

Devoluções

Tipo Description

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

Exceções

Tipo Description

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

Tipo Description

serialize

Converta este objeto AksCompute num dicionário json serializado.

serialize()

Devoluções

Tipo Description

A representação JSON deste objeto AksCompute.

Exceções

Tipo Description

update

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

update(update_configuration)

Parâmetros

Name Description
update_configuration
Necessário

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

Exceções

Tipo Description