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
|
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
|
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 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
|
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
|
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
|
O nome do grupo de recursos no qual o AKS está localizado. Default value: None
|
cluster_name
|
O nome do cluster do AKS. Default value: None
|
resource_id
|
O ID de recurso do Azure para o recurso de computação que está a ser anexado. Default value: None
|
cluster_purpose
|
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
|
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
|
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
|
O número de agentes (VMs) para alojar contentores. A predefinição é 3. Default value: None
|
vm_size
|
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
|
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
|
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
|
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
|
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
|
O nome do grupo de recursos onde está localizada a rede virtual. Default value: None
|
vnet_name
|
O nome da rede virtual. Default value: None
|
subnet_name
|
O nome da sub-rede dentro da vnet. Default value: None
|
service_cidr
|
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
|
Endereço IP do servidor DNS de contentores. Default value: None
|
docker_bridge_cidr
|
Um IP de notação CIDR para a bridge do Docker. Default value: None
|
cluster_purpose
|
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
|
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
|
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 |
---|---|