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
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 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
O objeto da área de trabalho ao qual associar o recurso de computação.
- name
- 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
- str
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
O nome do grupo de recursos no qual o AKS está localizado.
- resource_id
- str
O ID de recurso do Azure para o recurso de computação que está a ser anexado.
- 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.
- load_balancer_type
- str
O tipo de cluster do AKS. Os valores válidos são PublicIp e InternalLoadBalancer. O valor predefinido é PublicIp.
- 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.
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
O objeto da área de trabalho ao que o objeto AksCompute está associado.
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
O número de agentes (VMs) para alojar contentores. A predefinição é 3.
- 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.
- 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.
- 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.
- 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.
- 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
- vnet_resourcegroup_name
- str
O nome do grupo de recursos onde está localizada a rede virtual.
- service_cidr
- str
Um intervalo de IP de notação CIDR a partir do qual atribuir IPs de cluster de serviço.
- 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
- 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.
- 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.
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
Um objeto de configuração de atualização do AKS.
Exceções
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários