Compartilhar via

AksCompute Classe

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

Os destinos do AKSCompute (Serviço de Kubernetes do Azure) normalmente são usados para implantações de produção de alta escala porque fornecem tempo de resposta rápido e dimensionamento automático do serviço implantado. Para obter mais informações, consulte 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 de computação associado ao workspace fornecido. Retorna uma instância de uma classe filho correspondente ao tipo específico do objeto compute recuperado.

Construtor

AksCompute(workspace, name)

Parâmetros

Nome Description
workspace
Obrigatório
Workspace

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
Workspace

O objeto de workspace que contém o objeto Compute a ser recuperado.
name
Obrigatório
str

O nome 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

DEPRECADO. Em vez disso, use o attach_configuration método.

Associe um recurso de computação do AKS existente ao workspace fornecido.
attach_configuration

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

Remova o objeto AksCompute de seu workspace associado.

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

Converta um objeto JSON em um objeto AksCompute.
detach

Desanexe o objeto AksCompute de seu workspace associado.

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

Recupere as credenciais para o destino do AKS.
provisioning_configuration

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

Execute uma atualização in-loco 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

Converta esse objeto AksCompute em um dicionário serializado json.
update

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

attach

DEPRECADO. Em vez disso, use o attach_configuration método.

Associe um recurso de computação do AKS existente ao workspace fornecido.

static attach(workspace, name, resource_id)

Parâmetros

Nome Description
workspace
Obrigatório
Workspace

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. 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
AksCompute

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

Exceções

Tipo Description
ComputeTargetException

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

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 componentes do Azure Machine Learning para garantir o nível desejado de tolerância a falhas e QoS. A ClusterPurpose classe 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 de 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. Ele só pode ser usado quando InternalLoadBalancer é usado como tipo de balanceador de carga. O valor padrão é aks-subnet.

Valor padrão: None

Retornos

Tipo Description
AksAttachConfiguration

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

delete

Remova o objeto AksCompute de seu workspace associado.

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

delete()

Exceções

Tipo Description
ComputeTargetException

deserialize

Converta um objeto JSON em um objeto AksCompute.

static deserialize(workspace, object_dict)

Parâmetros

Nome Description
workspace
Obrigatório
Workspace

O objeto de workspace ao qual o objeto AksCompute está associado.
object_dict
Obrigatório
dict

Um objeto JSON a ser convertido em um objeto AksCompute.

Retornos

Tipo Description
AksCompute

A representação aksCompute do objeto JSON fornecido.

Exceções

Tipo Description
ComputeTargetException

Comentários

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

detach

Desanexe o objeto AksCompute de seu workspace associado.

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

detach()

Exceções

Tipo Description
ComputeTargetException

get_credentials

Recupere as credenciais para o destino do AKS.

get_credentials()

Retornos

Tipo Description
dict

As credenciais para o destino do AKS.

Exceções

Tipo Description
ComputeTargetException

provisioning_configuration

Crie 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 se estiver habilitando 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 que contém 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 que contém 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 no qual 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 em que 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 de IP de notação CIDR do qual atribuir IPs de cluster de serviço.

Valor padrão: None
dns_service_ip
str

Endereço IP do servidor DNS de 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 componentes do Azure Machine Learning para 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. Ele só pode ser usado 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
AksProvisioningConfiguration

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

Exceções

Tipo Description
ComputeTargetException

refresh_state

Execute uma atualização in-loco 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()

serialize

Converta esse objeto AksCompute em um dicionário serializado json.

serialize()

Retornos

Tipo Description
dict

A representação JSON deste objeto AksCompute.

update

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

update(update_configuration)

Parâmetros

Nome Description
update_configuration
Obrigatório
AksUpdateConfiguration

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

Exceções

Tipo Description
ComputeTargetException