Partilhar via

AksCompute Classe

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

Os destinos do Serviço Kubernetes do Azure (AKSCompute) geralmente são usados para implantações de produção em 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?

Classe ComputeTarget construtor.

Recupere uma representação na nuvem de um objeto Compute associado ao espaço de trabalho fornecido. Retorna uma instância de uma classe filho correspondente ao tipo específico do objeto Compute recuperado.

Construtor

AksCompute(workspace, name)

Parâmetros

Name Description
workspace
Necessário
Workspace

O objeto de espaço de trabalho que contém o objeto AksCompute a ser recuperado.
name
Necessário
str

O nome do objeto AksCompute a ser recuperado.
workspace
Necessário
Workspace

O objeto de espaço de trabalho que contém o objeto Compute a ser recuperado.
name
Necessário
str

O nome do objeto Compute a ser recuperado.

Observações

O exemplo a seguir mostra como criar um cluster AKS com máquinas habilitadas 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 attach_configuration método em vez disso.

Associe um recurso de computação AKS existente ao espaço de trabalho fornecido.
attach_configuration

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

Remova o objeto AksCompute de seu espaço de trabalho associado.

Se este objeto tiver sido criado através do Azure Machine Learning, os objetos baseados na nuvem correspondentes também serão eliminados. Se esse objeto foi criado externamente e anexado apenas ao espaço de trabalho, esse método gera um ComputeTargetException e nada é alterado.
deserialize

Converter um objeto JSON em um objeto AksCompute.
detach

Desanexe o objeto AksCompute de seu espaço de trabalho associado.

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

Recupere as credenciais para o destino AKS.
provisioning_configuration

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

Execute uma atualização in-loco das propriedades do objeto.

Este 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 este objeto AksCompute em um dicionário serializado json.
update

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

attach

PRETERIDO. Use o attach_configuration método em vez disso.

Associe um recurso de computação AKS existente ao espaço de trabalho fornecido.

static attach(workspace, name, resource_id)

Parâmetros

Name Description
workspace
Necessário
Workspace

O objeto de espaço de trabalho ao qual associar o recurso de computação.
name
Necessário
str

O nome a ser associado ao recurso de computação dentro do espaço de trabalho fornecido. Não precisa corresponder ao nome do recurso de computação a ser anexado.
resource_id
Necessário
str

A ID do recurso do Azure para o recurso de computação que está sendo anexado.

Devoluções

Tipo Description
AksCompute

Uma representação do objeto AksCompute do objeto compute.

Exceções

Tipo Description
ComputeTargetException

attach_configuration

Crie um objeto de configuração para anexar um destino de computação 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 AKS.

Default value: None
resource_id
str

A ID do recurso do Azure para o recurso de computação que está sendo anexado.

Default value: 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 AKS existente.

Default value: None
load_balancer_type
str

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

Default value: None
load_balancer_subnet
str

A sub-rede do balanceador de carga AKS. Ele pode ser usado somente quando InternalLoadBalancer é usado como tipo de balanceador de carga. O valor padrão é aks-subnet.

Default value: None

Devoluções

Tipo Description
AksAttachConfiguration

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

delete

Remova o objeto AksCompute de seu espaço de trabalho associado.

Se este objeto tiver sido criado através do Azure Machine Learning, os objetos baseados na nuvem correspondentes também serão eliminados. Se esse objeto foi criado externamente e anexado apenas ao espaço de trabalho, esse método gera um ComputeTargetException e nada é alterado.

delete()

Exceções

Tipo Description
ComputeTargetException

deserialize

Converter um objeto JSON em um objeto AksCompute.

static deserialize(workspace, object_dict)

Parâmetros

Name Description
workspace
Necessário
Workspace

O objeto de espaço de trabalho ao qual o objeto AksCompute está associado.
object_dict
Necessário
dict

Um objeto JSON para converter em um objeto AksCompute.

Devoluções

Tipo Description
AksCompute

A representação AksCompute do objeto JSON fornecido.

Exceções

Tipo Description
ComputeTargetException

Observações

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

detach

Desanexe o objeto AksCompute de seu espaço de trabalho associado.

Os 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 AKS.

get_credentials()

Devoluções

Tipo Description
dict

As credenciais para o alvo AKS.

Exceções

Tipo Description
ComputeTargetException

provisioning_configuration

Crie um objeto de configuração para provisionar um destino de computação 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 hospedar contêineres. O padrão é 3.

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

Default value: 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 cert e arquivo de chave para habilitar a validação SSL.

Default value: 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 cert e arquivo de chave para habilitar a validação SSL.

Default value: 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 cert e arquivo de chave para habilitar a validação SSL.

Default value: None
location
str

O local para provisionar o cluster. Se não for especificado, o padrão será o local do espaço de trabalho. As regiões disponíveis para este cálculo podem ser encontradas aqui: https://azure.microsoft.com/global-infrastructure/services/?regions=all& produtos=kubernetes-service

Default value: None
vnet_resourcegroup_name
str

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

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 contêineres.

Default value: None
docker_bridge_cidr
str

Um IP de notação CIDR para ponte Docker.

Default value: 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. AksCompute.ClusterPurpose classe é 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

Default value: None
load_balancer_type
str

Tipo de balanceador de carga do cluster AKS. Os valores válidos são PublicIp e InternalLoadBalancer. O valor padrão é PublicIp.

Default value: None
load_balancer_subnet
str

Sub-rede do balanceador de carga do cluster AKS. Ele pode ser usado somente quando o Balanceador de Carga Interno é usado como tipo de balanceador de carga. O valor padrão é aks-subnet.

Default value: None

Devoluções

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.

Este 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 este objeto AksCompute em um dicionário serializado json.

serialize()

Devoluções

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

Name Description
update_configuration
Necessário
AksUpdateConfiguration

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

Exceções

Tipo Description
ComputeTargetException