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
- workspace
- Workspace
O objeto de workspace que contém o objeto AksCompute 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 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
- name
- 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
- str
A ID do recurso do Azure para o recurso de computação que está sendo anexado.
Retornos
Uma representação de objeto AksCompute do objeto de computação.
Tipo de retorno
Exceções
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
- resource_id
- str
A ID do recurso do Azure para o recurso de computação que está sendo anexado.
- 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.
- load_balancer_type
- str
O tipo do cluster do AKS. Os valores válidos são PublicIp e InternalLoadBalancer. O valor padrão é PublicIp.
- 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.
Retornos
Um objeto de configuração a ser usado ao anexar um objeto Compute.
Tipo de retorno
Exceções
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
deserialize
Converte um objeto JSON em um objeto AksCompute.
static deserialize(workspace, object_dict)
Parâmetros
Retornos
A representação AksCompute do objeto JSON fornecido.
Tipo de retorno
Exceções
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
get_credentials
Recupera as credenciais para o destino do AKS.
get_credentials()
Retornos
As credenciais para o destino do AKS.
Tipo de retorno
Exceções
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
- agent_count
- int
O número de agentes (VMs) para hospedar contêineres. O valor padrão é 3.
- 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.
- 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.
- 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.
- 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.
- 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
- vnet_resourcegroup_name
- str
O nome do grupo de recursos no qual a rede virtual está localizada.
- service_cidr
- str
Um intervalo IP com notação CIDR do qual designar serviço cluster IPs.
- 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
- 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.
- 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.
Retornos
Um objeto de configuração a ser usado ao criar um objeto Compute
Tipo de retorno
Exceções
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
serialize
Converte esse objeto AksCompute em um dicionário serializado JSON.
serialize()
Retornos
A representação JSON desse objeto AksCompute.
Tipo de retorno
Exceções
update
Atualiza o objeto AksCompute usando 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.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de