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
|
Der Name des abzurufenden AksCompute-Objekts. |
|
workspace
Erforderlich
|
Das Arbeitsbereichsobjekt, das das compute-Objekt enthält, das abgerufen werden soll. |
|
name
Erforderlich
|
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 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
|
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
|
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
|
Der Name der Ressourcengruppe, in der sich die AKS befindet. Standardwert: None
|
|
cluster_name
|
Der Name des AKS-Clusters. Standardwert: None
|
|
resource_id
|
Die Azure-Ressourcen-ID für die zugeordnete Computeressource. Standardwert: None
|
|
cluster_purpose
|
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
|
Der AKS-Clustertyp. Gültige Werte sind PublicIp und InternalLoadBalancer. Der Standardwert ist PublicIp. Standardwert: None
|
|
load_balancer_subnet
|
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
|
Die Anzahl der Agents (VMs) zum Hosten von Containern. Der Standardwert ist 3. Standardwert: None
|
|
vm_size
|
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
|
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
|
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
|
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
|
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
|
Der Name der Ressourcengruppe, in der sich das virtuelle Netzwerk befindet. Standardwert: None
|
|
vnet_name
|
Den Namen des virtuellen Netzwerks. Standardwert: None
|
|
subnet_name
|
Der Name des Subnetzes innerhalb des vnet. Standardwert: None
|
|
service_cidr
|
Ein CIDR-Notations-IP-Bereich, aus dem Dienstcluster-IPs zugewiesen werden sollen. Standardwert: None
|
|
dns_service_ip
|
IP-Adresse des DNS-Servers für Container. Standardwert: None
|
|
docker_bridge_cidr
|
Eine CIDR-Notations-IP für Docker-Brücke. Standardwert: None
|
|
cluster_purpose
|
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
|
Lastenausgleichstyp des AKS-Clusters. Gültige Werte sind PublicIp und InternalLoadBalancer. Der Standardwert ist PublicIp. Standardwert: None
|
|
load_balancer_subnet
|
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 |
|---|---|