AksCompute Classe
Gestisce una destinazione di calcolo del servizio Azure Kubernetes in Azure Machine Learning.
Le destinazioni del servizio Azure Kubernetes (AKSCompute) vengono in genere usate per le distribuzioni di produzione su larga scala perché offrono tempi di risposta rapidi e scalabilità automatica del servizio distribuito. Per altre informazioni, vedere Che cosa sono le destinazioni di calcolo in Azure Machine Learning?
Costruttore ComputeTarget della 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.
Costruttore
AksCompute(workspace, name)
Parametri
| Nome | Descrizione |
|---|---|
|
workspace
Necessario
|
Oggetto workspace contenente l'oggetto AksCompute da recuperare. |
|
name
Necessario
|
Nome dell'oggetto AksCompute da recuperare. |
|
workspace
Necessario
|
Oggetto workspace contenente l'oggetto Compute da recuperare. |
|
name
Necessario
|
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. Usare invece il 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 e ComputeTargetException 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, ma 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. Usare invece il attach_configuration metodo .
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 workspace a cui associare la risorsa di calcolo. |
|
name
Necessario
|
Nome da associare alla risorsa di calcolo all'interno dell'area di lavoro specificata. Non deve corrispondere al nome della risorsa di calcolo da associare. |
|
resource_id
Necessario
|
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
|
Nome del gruppo di risorse in cui si trova il servizio Azure Kubernetes. Valore predefinito: None
|
|
cluster_name
|
Nome del cluster del servizio Azure Kubernetes. Valore predefinito: None
|
|
resource_id
|
ID risorsa di Azure per la risorsa di calcolo collegata. Valore predefinito: None
|
|
cluster_purpose
|
Utilizzo di destinazione 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
|
Tipo di cluster del servizio Azure Kubernetes. I valori validi sono PublicIp e InternalLoadBalancer. Il valore predefinito è PublicIp. Valore predefinito: None
|
|
load_balancer_subnet
|
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 utilizzare per il collegamento di un oggetto Compute. |
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 e ComputeTargetException 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 workspace 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 fornito. |
Eccezioni
| Tipo | Descrizione |
|---|---|
Commenti
Genera un oggetto ComputeTargetException se l'area di lavoro specificata non è l'area di lavoro a cui è associato l'ambiente di calcolo.
detach
Scollegare l'oggetto AksCompute dall'area di lavoro associata.
Gli oggetti cloud sottostanti non vengono eliminati, ma 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
|
Numero di agenti (VM) per ospitare contenitori. Il valore predefinito è 3. Valore predefinito: None
|
|
vm_size
|
Dimensioni delle macchine virtuali dell'agente. Un elenco completo delle opzioni è disponibile qui: https://aka.ms/azureml-aks-details. Il valore predefinito è Standard_D3_v2. Valore predefinito: None
|
|
ssl_cname
|
CName da usare se si abilita la convalida SSL nel cluster. Specificare tutti e tre i file CName, il file di certificato e il file di chiave per abilitare la convalida SSL. Valore predefinito: None
|
|
ssl_cert_pem_file
|
Percorso di un file contenente informazioni sul certificato per la convalida SSL. Specificare tutti e tre i file CName, il file di certificato e il file di chiave per abilitare la convalida SSL. Valore predefinito: None
|
|
ssl_key_pem_file
|
Percorso di un file contenente informazioni sulla chiave per la convalida SSL. Specificare tutti e tre i file CName, il file di certificato e il file di chiave per abilitare la convalida SSL. Valore predefinito: None
|
|
location
|
Percorso in cui effettuare il provisioning del cluster. Se non specificato, per impostazione predefinita verrà impostato 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
|
Nome del gruppo di risorse in cui si trova la rete virtuale. Valore predefinito: None
|
|
vnet_name
|
Nome della rete virtuale. Valore predefinito: None
|
|
subnet_name
|
Nome della subnet all'interno della rete virtuale. Valore predefinito: None
|
|
service_cidr
|
Intervallo IP di notazione CIDR da cui assegnare indirizzi IP del cluster di servizi. Valore predefinito: None
|
|
dns_service_ip
|
Indirizzo IP del server DNS dei contenitori. Valore predefinito: None
|
|
docker_bridge_cidr
|
IP di notazione CIDR per il bridge Docker. Valore predefinito: None
|
|
cluster_purpose
|
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. Informazioni più dettagliate su questi valori e sui relativi casi d'uso sono disponibili qui: https://aka.ms/azureml-create-attach-aks Valore predefinito: None
|
|
load_balancer_type
|
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
|
Subnet del servizio di bilanciamento del carico del cluster del servizio Azure Kubernetes. Può essere usato solo quando il servizio di bilanciamento del carico interno 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 utilizzare 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()
serialize
Convertire questo oggetto AksCompute in un dizionario serializzato json.
serialize()
Restituisce
| Tipo | Descrizione |
|---|---|
|
Rappresentazione JSON di questo oggetto AksCompute. |
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 |
|---|---|