AksCompute Classe

Gestisce una destinazione di calcolo servizio Azure Kubernetes in Azure Machine Learning.

le destinazioni servizio Azure Kubernetes (AKSCompute) vengono in genere usate per le distribuzioni di produzione su larga scala perché forniscono tempi di risposta rapidi e scalabilità automatica del servizio distribuito. Per altre informazioni, vedere Informazioni sulle destinazioni di calcolo in Azure Machine Learning?

Costruttore ComputeTarget di classe.

Recuperare una rappresentazione cloud di un oggetto Compute associato all'area di lavoro specificata. Restituisce un'istanza di una classe figlio corrispondente al tipo specifico dell'oggetto Compute recuperato.

Ereditarietà
AksCompute

Costruttore

AksCompute(workspace, name)

Parametri

Nome Descrizione
workspace
Necessario

Oggetto dell'area di lavoro contenente l'oggetto AksCompute da recuperare.

name
Necessario
str

Nome dell'oggetto AksCompute da recuperare.

workspace
Necessario

Oggetto dell'area di lavoro contenente l'oggetto Compute da recuperare.

name
Necessario
str

Nome dell'oggetto Compute da recuperare.

Commenti

L'esempio seguente illustra come creare un cluster del servizio Azure Kubernetes con computer abilitati per 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)

Metodi

attach

DEPRECATO. Al suo posto usa il metodo attach_configuration.

Associare una risorsa di calcolo del servizio Azure Kubernetes esistente all'area di lavoro fornita.

attach_configuration

Creare un oggetto di configurazione per collegare una destinazione di calcolo del servizio Azure Kubernetes.

delete

Rimuovere l'oggetto AksCompute dall'area di lavoro associata.

Se questo oggetto è stato creato tramite Azure Machine Learning, verranno eliminati anche gli oggetti basati sul cloud corrispondenti. Se questo oggetto è stato creato esternamente e collegato solo all'area di lavoro, questo metodo genera un ComputeTargetException oggetto e non viene modificato nulla.

deserialize

Convertire un oggetto JSON in un oggetto AksCompute.

detach

Scollegare l'oggetto AksCompute dall'area di lavoro associata.

Gli oggetti cloud sottostanti non vengono eliminati, solo l'associazione viene rimossa.

get_credentials

Recuperare le credenziali per la destinazione del servizio Azure Kubernetes.

provisioning_configuration

Creare un oggetto di configurazione per il provisioning di una destinazione di calcolo del servizio Azure Kubernetes.

refresh_state

Eseguire un aggiornamento sul posto delle proprietà dell'oggetto.

Questo metodo aggiorna le proprietà in base allo stato corrente dell'oggetto cloud corrispondente. Viene usato principalmente per il polling manuale dello stato di calcolo.

serialize

Convertire questo oggetto AksCompute in un dizionario serializzato json.

update

Aggiornare l'oggetto AksCompute usando la configurazione di aggiornamento fornita.

attach

DEPRECATO. Al suo posto usa il metodo attach_configuration.

Associare una risorsa di calcolo del servizio Azure Kubernetes esistente all'area di lavoro fornita.

static attach(workspace, name, resource_id)

Parametri

Nome Descrizione
workspace
Necessario

Oggetto area di lavoro con cui associare la risorsa di calcolo.

name
Necessario
str

Nome da associare alla risorsa di calcolo all'interno dell'area di lavoro specificata. Non deve corrispondere al nome della risorsa di calcolo da collegare.

resource_id
Necessario
str

ID risorsa di Azure per la risorsa di calcolo collegata.

Restituisce

Tipo Descrizione

Rappresentazione dell'oggetto AksCompute dell'oggetto di calcolo.

Eccezioni

Tipo Descrizione

attach_configuration

Creare un oggetto di configurazione per collegare una destinazione di calcolo del servizio Azure Kubernetes.

static attach_configuration(resource_group=None, cluster_name=None, resource_id=None, cluster_purpose=None, load_balancer_type=None, load_balancer_subnet=None)

Parametri

Nome Descrizione
resource_group
str

Nome del gruppo di risorse in cui si trova il servizio Azure Kubernetes.

Valore predefinito: None
cluster_name
str

Nome del cluster del servizio Azure Kubernetes.

Valore predefinito: None
resource_id
str

ID risorsa di Azure per la risorsa di calcolo collegata.

Valore predefinito: None
cluster_purpose
str

Utilizzo mirato del cluster. Viene usato per effettuare il provisioning dei componenti di Azure Machine Learning per garantire il livello desiderato di tolleranza di errore e QoS. La ClusterPurpose classe definisce i valori possibili. Per altre informazioni, vedere Collegare un cluster del servizio Azure Kubernetes esistente.

Valore predefinito: None
load_balancer_type
str

Tipo di cluster del servizio Azure Kubernetes. I valori validi sono PublicIp e InternalLoadBalancer. Il valore predefinito è PublicIp.

Valore predefinito: None
load_balancer_subnet
str

Subnet del servizio di bilanciamento del carico del servizio Azure Kubernetes. Può essere usato solo quando InternalLoadBalancer viene usato come tipo di servizio di bilanciamento del carico. Il valore predefinito è aks-subnet.

Valore predefinito: None

Restituisce

Tipo Descrizione

Oggetto di configurazione da usare quando si collega un oggetto Compute.

Eccezioni

Tipo Descrizione

delete

Rimuovere l'oggetto AksCompute dall'area di lavoro associata.

Se questo oggetto è stato creato tramite Azure Machine Learning, verranno eliminati anche gli oggetti basati sul cloud corrispondenti. Se questo oggetto è stato creato esternamente e collegato solo all'area di lavoro, questo metodo genera un ComputeTargetException oggetto e non viene modificato nulla.

delete()

Eccezioni

Tipo Descrizione

deserialize

Convertire un oggetto JSON in un oggetto AksCompute.

static deserialize(workspace, object_dict)

Parametri

Nome Descrizione
workspace
Necessario

L'oggetto dell'area di lavoro a cui è associato l'oggetto AksCompute.

object_dict
Necessario

Oggetto JSON da convertire in un oggetto AksCompute.

Restituisce

Tipo Descrizione

Rappresentazione AksCompute dell'oggetto JSON specificato.

Eccezioni

Tipo Descrizione

Commenti

Genera un valore ComputeTargetException se l'area di lavoro specificata non è l'area di lavoro a cui è associato il calcolo.

detach

Scollegare l'oggetto AksCompute dall'area di lavoro associata.

Gli oggetti cloud sottostanti non vengono eliminati, solo l'associazione viene rimossa.

detach()

Eccezioni

Tipo Descrizione

get_credentials

Recuperare le credenziali per la destinazione del servizio Azure Kubernetes.

get_credentials()

Restituisce

Tipo Descrizione

Credenziali per la destinazione del servizio Azure Kubernetes.

Eccezioni

Tipo Descrizione

provisioning_configuration

Creare un oggetto di configurazione per il provisioning di una destinazione di calcolo del servizio Azure Kubernetes.

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)

Parametri

Nome Descrizione
agent_count
int

Numero di agenti (VM) per ospitare contenitori. Il valore predefinito è 3.

Valore predefinito: None
vm_size
str

Dimensioni delle macchine virtuali dell'agente. Un elenco completo di opzioni è disponibile qui: https://aka.ms/azureml-aks-details. Impostazione predefinita per Standard_D3_v2.

Valore predefinito: None
ssl_cname
str

CName da usare se si abilita la convalida SSL nel cluster. Per abilitare la convalida SSL, è necessario specificare tutti e tre i file CName, file di certificato e file chiave.

Valore predefinito: None
ssl_cert_pem_file
str

Percorso file di un file contenente informazioni sul certificato per la convalida SSL. Per abilitare la convalida SSL, è necessario specificare tutti e tre i file CName, file di certificato e file chiave.

Valore predefinito: None
ssl_key_pem_file
str

Percorso file di un file contenente le informazioni sulla chiave per la convalida SSL. Per abilitare la convalida SSL, è necessario specificare tutti e tre i file CName, file di certificato e file chiave.

Valore predefinito: None
location
str

Percorso in cui effettuare il provisioning del cluster. Se non specificato, verrà predefinito il percorso dell'area di lavoro. Le aree disponibili per questo calcolo sono disponibili qui: https://azure.microsoft.com/global-infrastructure/services/?regions=all& products=kubernetes-service

Valore predefinito: None
vnet_resourcegroup_name
str

Nome del gruppo di risorse in cui si trova la rete virtuale.

Valore predefinito: None
vnet_name
str

nome della rete virtuale.

Valore predefinito: None
subnet_name
str

Nome della subnet all'interno della rete virtuale.

Valore predefinito: None
service_cidr
str

Intervallo IP in notazione CIDR da cui assegnare gli indirizzi IP dei cluster del servizio.

Valore predefinito: None
dns_service_ip
str

Contenitori indirizzo IP del server DNS.

Valore predefinito: None
docker_bridge_cidr
str

Ip di notazione CIDR per il bridge Docker.

Valore predefinito: None
cluster_purpose
str

Utilizzo mirato del cluster. Viene usato per effettuare il provisioning dei componenti di Azure Machine Learning per garantire il livello desiderato di tolleranza di errore e QoS. La classe AksCompute.ClusterPurpose viene fornita per praticità per specificare i valori disponibili. Sono disponibili informazioni più dettagliate su questi valori e sui relativi casi d'uso: https://aka.ms/azureml-create-attach-aks

Valore predefinito: None
load_balancer_type
str

Tipo di servizio di bilanciamento del carico del cluster del servizio Azure Kubernetes. I valori validi sono PublicIp e InternalLoadBalancer. Il valore predefinito è PublicIp.

Valore predefinito: None
load_balancer_subnet
str

Subnet del servizio di bilanciamento del carico del cluster del servizio Azure Kubernetes. Può essere usato solo quando viene usato Load Balancer interno come tipo di servizio di bilanciamento del carico. Il valore predefinito è aks-subnet.

Valore predefinito: None

Restituisce

Tipo Descrizione

Oggetto di configurazione da usare durante la creazione di un oggetto Compute

Eccezioni

Tipo Descrizione

refresh_state

Eseguire un aggiornamento sul posto delle proprietà dell'oggetto.

Questo metodo aggiorna le proprietà in base allo stato corrente dell'oggetto cloud corrispondente. Viene usato principalmente per il polling manuale dello stato di calcolo.

refresh_state()

Eccezioni

Tipo Descrizione

serialize

Convertire questo oggetto AksCompute in un dizionario serializzato json.

serialize()

Restituisce

Tipo Descrizione

Rappresentazione JSON di questo oggetto AksCompute.

Eccezioni

Tipo Descrizione

update

Aggiornare l'oggetto AksCompute usando la configurazione di aggiornamento fornita.

update(update_configuration)

Parametri

Nome Descrizione
update_configuration
Necessario

Oggetto di configurazione dell'aggiornamento del servizio Azure Kubernetes.

Eccezioni

Tipo Descrizione