Freigeben über


AksCompute Klasse

Verwaltet ein Azure Kubernetes-Dienst-Computeziel in Azure Machine Learning.

Azure Kubernetes Service (AKSCompute)-Ziele werden in der Regel für hochskalierende Produktionsbereitstellungen verwendet, da sie schnelle Reaktionszeiten und automatische Skalierung des bereitgestellten Diensts bieten. Weitere Informationen finden Sie unter Was sind Computeziele in Azure Machine Learning?

Class ComputeTarget-Konstruktor.

Rufen Sie eine Clouddarstellung eines Compute-Objekts ab, das dem bereitgestellten Arbeitsbereich zugeordnet ist. Gibt eine Instanz einer untergeordneten Klasse zurück, die dem spezifischen Typ des abgerufenen Compute-Objekts entspricht.

Konstruktor

AksCompute(workspace, name)

Parameter

Name Beschreibung
workspace
Erforderlich

Das Arbeitsbereichsobjekt, das das abzurufende AksCompute-Objekt enthält.

name
Erforderlich
str

Der Name des abzurufenden AksCompute-Objekts.

workspace
Erforderlich

Das Arbeitsbereichsobjekt, das das compute-Objekt enthält, das abgerufen werden soll.

name
Erforderlich
str

Der Name des abzurufenden Compute-Objekts.

Hinweise

Das folgende Beispiel zeigt, wie Sie einen AKS-Cluster mit FPGA-fähigen Computern erstellen.


   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)

Methoden

attach

VERALTET. Verwenden Sie stattdessen die attach_configuration Methode.

Ordnen Sie eine vorhandene AKS-Computeressource dem bereitgestellten Arbeitsbereich zu.

attach_configuration

Erstellen Sie ein Konfigurationsobjekt zum Anfügen eines AKS-Computeziels.

delete

Entfernen Sie das AksCompute-Objekt aus dem zugeordneten Arbeitsbereich.

Wenn dieses Objekt über Azure Machine Learning erstellt wurde, werden auch die entsprechenden cloudbasierten Objekte gelöscht. Wenn dieses Objekt extern erstellt und nur an den Arbeitsbereich angefügt wurde, löst diese Methode eine Änderung aus ComputeTargetException .

deserialize

Konvertieren Sie ein JSON-Objekt in ein AksCompute-Objekt.

detach

Trennen Sie das AksCompute-Objekt vom zugeordneten Arbeitsbereich.

Zugrunde liegende Cloudobjekte werden nicht gelöscht, nur die Zuordnung wird entfernt.

get_credentials

Rufen Sie die Anmeldeinformationen für das AKS-Ziel ab.

provisioning_configuration

Erstellen Sie ein Konfigurationsobjekt für die Bereitstellung eines AKS-Computeziels.

refresh_state

Führen Sie eine direkte Aktualisierung der Eigenschaften des Objekts durch.

Diese Methode aktualisiert die Eigenschaften basierend auf dem aktuellen Zustand des entsprechenden Cloudobjekts. Dies wird in erster Linie für die manuelle Abfrage des Berechnungszustands verwendet.

serialize

Konvertieren Sie dieses AksCompute-Objekt in ein serialisiertes JSON-Wörterbuch.

update

Aktualisieren Sie das AksCompute-Objekt mithilfe der bereitgestellten Updatekonfiguration.

attach

VERALTET. Verwenden Sie stattdessen die attach_configuration Methode.

Ordnen Sie eine vorhandene AKS-Computeressource dem bereitgestellten Arbeitsbereich zu.

static attach(workspace, name, resource_id)

Parameter

Name Beschreibung
workspace
Erforderlich

Das Arbeitsbereichsobjekt, dem die Computeressource zugeordnet werden soll.

name
Erforderlich
str

Der Name, der der Computeressource innerhalb des bereitgestellten Arbeitsbereichs zugeordnet werden soll. Muss nicht mit dem Namen der compute-Ressource übereinstimmen, die angefügt werden soll.

resource_id
Erforderlich
str

Die Azure-Ressourcen-ID für die zugeordnete Computeressource.

Gibt zurück

Typ Beschreibung

Eine AksCompute-Objektdarstellung des Computeobjekts.

Ausnahmen

Typ Beschreibung

attach_configuration

Erstellen Sie ein Konfigurationsobjekt zum Anfügen eines AKS-Computeziels.

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

Parameter

Name Beschreibung
resource_group
str

Der Name der Ressourcengruppe, in der sich die AKS befindet.

Standardwert: None
cluster_name
str

Der Name des AKS-Clusters.

Standardwert: None
resource_id
str

Die Azure-Ressourcen-ID für die zugeordnete Computeressource.

Standardwert: None
cluster_purpose
str

Die gezielte Verwendung des Clusters. Dies wird verwendet, um Azure Machine Learning-Komponenten bereitzustellen, um die gewünschte Fehlertoleranz und QoS sicherzustellen. Die ClusterPurpose Klasse definiert die möglichen Werte. Weitere Informationen finden Sie unter Anfügen eines vorhandenen AKS-Clusters.

Standardwert: None
load_balancer_type
str

Der AKS-Clustertyp. Gültige Werte sind PublicIp und InternalLoadBalancer. Der Standardwert ist PublicIp.

Standardwert: None
load_balancer_subnet
str

Das AKS-Lastenausgleichs-Subnetz. Sie kann nur verwendet werden, wenn InternalLoadBalancer als Lastenausgleichstyp verwendet wird. Der Standardwert ist ein Aks-Subnetz.

Standardwert: None

Gibt zurück

Typ Beschreibung

Ein Konfigurationsobjekt, das beim Anfügen eines Compute-Objekts verwendet werden soll.

delete

Entfernen Sie das AksCompute-Objekt aus dem zugeordneten Arbeitsbereich.

Wenn dieses Objekt über Azure Machine Learning erstellt wurde, werden auch die entsprechenden cloudbasierten Objekte gelöscht. Wenn dieses Objekt extern erstellt und nur an den Arbeitsbereich angefügt wurde, löst diese Methode eine Änderung aus ComputeTargetException .

delete()

Ausnahmen

Typ Beschreibung

deserialize

Konvertieren Sie ein JSON-Objekt in ein AksCompute-Objekt.

static deserialize(workspace, object_dict)

Parameter

Name Beschreibung
workspace
Erforderlich

Das Arbeitsbereichsobjekt, dem das AksCompute-Objekt zugeordnet ist.

object_dict
Erforderlich

Ein JSON-Objekt, das in ein AksCompute-Objekt konvertiert werden soll.

Gibt zurück

Typ Beschreibung

Die AksCompute-Darstellung des bereitgestellten JSON-Objekts.

Ausnahmen

Typ Beschreibung

Hinweise

Löst ein ComputeTargetException , wenn der bereitgestellte Arbeitsbereich nicht der Arbeitsbereich ist, dem die Compute zugeordnet ist.

detach

Trennen Sie das AksCompute-Objekt vom zugeordneten Arbeitsbereich.

Zugrunde liegende Cloudobjekte werden nicht gelöscht, nur die Zuordnung wird entfernt.

detach()

Ausnahmen

Typ Beschreibung

get_credentials

Rufen Sie die Anmeldeinformationen für das AKS-Ziel ab.

get_credentials()

Gibt zurück

Typ Beschreibung

Die Anmeldeinformationen für das AKS-Ziel.

Ausnahmen

Typ Beschreibung

provisioning_configuration

Erstellen Sie ein Konfigurationsobjekt für die Bereitstellung eines AKS-Computeziels.

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)

Parameter

Name Beschreibung
agent_count
int

Die Anzahl der Agents (VMs) zum Hosten von Containern. Der Standardwert ist 3.

Standardwert: None
vm_size
str

Die Größe von Agent-VMs. Eine vollständige Liste der Optionen finden Sie hier: https://aka.ms/azureml-aks-details. Standardmäßig wird Standard_D3_v2.

Standardwert: None
ssl_cname
str

Ein CName, der verwendet werden soll, wenn die SSL-Validierung für den Cluster aktiviert wird. Muss alle drei CName-, Zertifikat- und Schlüsseldateien bereitstellen, um die SSL-Validierung zu aktivieren.

Standardwert: None
ssl_cert_pem_file
str

Ein Dateipfad zu einer Datei, die Zertifikatinformationen für die SSL-Überprüfung enthält. Muss alle drei CName-, Zertifikat- und Schlüsseldateien bereitstellen, um die SSL-Validierung zu aktivieren.

Standardwert: None
ssl_key_pem_file
str

Ein Dateipfad zu einer Datei mit Schlüsselinformationen für die SSL-Überprüfung. Muss alle drei CName-, Zertifikat- und Schlüsseldateien bereitstellen, um die SSL-Validierung zu aktivieren.

Standardwert: None
location
str

Der Speicherort, in dem Cluster bereitgestellt werden soll. Wenn nicht angegeben, wird standardmäßig der Arbeitsbereichsspeicherort verwendet. Verfügbare Regionen für diese Berechnung finden Sie hier: https://azure.microsoft.com/global-infrastructure/services/?regions=all& products=kubernetes-service

Standardwert: None
vnet_resourcegroup_name
str

Der Name der Ressourcengruppe, in der sich das virtuelle Netzwerk befindet.

Standardwert: None
vnet_name
str

Den Namen des virtuellen Netzwerks.

Standardwert: None
subnet_name
str

Der Name des Subnetzes innerhalb des vnet.

Standardwert: None
service_cidr
str

Ein CIDR-Notations-IP-Bereich, aus dem Dienstcluster-IPs zugewiesen werden sollen.

Standardwert: None
dns_service_ip
str

IP-Adresse des DNS-Servers für Container.

Standardwert: None
docker_bridge_cidr
str

Eine CIDR-Notations-IP für Docker-Brücke.

Standardwert: None
cluster_purpose
str

Gezielte Nutzung des Clusters. Dies wird verwendet, um Azure Machine Learning-Komponenten bereitzustellen, um die gewünschte Fehlertoleranz und QoS sicherzustellen. Die AksCompute.ClusterPurpose-Klasse wird zur Vereinfachung der Angabe verfügbarer Werte bereitgestellt. Ausführlichere Informationen zu diesen Werten und ihren Anwendungsfällen finden Sie hier: https://aka.ms/azureml-create-attach-aks

Standardwert: None
load_balancer_type
str

Lastenausgleichstyp des AKS-Clusters. Gültige Werte sind PublicIp und InternalLoadBalancer. Der Standardwert ist PublicIp.

Standardwert: None
load_balancer_subnet
str

Lastenausgleichs-Subnetz des AKS-Clusters. Sie kann nur verwendet werden, wenn der interne Lastenausgleichsmodul als Lastenausgleichstyp verwendet wird. Der Standardwert ist ein Aks-Subnetz.

Standardwert: None

Gibt zurück

Typ Beschreibung

Ein Konfigurationsobjekt, das beim Erstellen eines Compute-Objekts verwendet werden soll

Ausnahmen

Typ Beschreibung

refresh_state

Führen Sie eine direkte Aktualisierung der Eigenschaften des Objekts durch.

Diese Methode aktualisiert die Eigenschaften basierend auf dem aktuellen Zustand des entsprechenden Cloudobjekts. Dies wird in erster Linie für die manuelle Abfrage des Berechnungszustands verwendet.

refresh_state()

serialize

Konvertieren Sie dieses AksCompute-Objekt in ein serialisiertes JSON-Wörterbuch.

serialize()

Gibt zurück

Typ Beschreibung

Die JSON-Darstellung dieses AksCompute-Objekts.

update

Aktualisieren Sie das AksCompute-Objekt mithilfe der bereitgestellten Updatekonfiguration.

update(update_configuration)

Parameter

Name Beschreibung
update_configuration
Erforderlich

Ein AKS-Updatekonfigurationsobjekt.

Ausnahmen

Typ Beschreibung