Delen via


AksCompute Klas

Hiermee beheert u een Azure Kubernetes Service rekendoel in Azure Machine Learning.

Azure Kubernetes Service (AKSCompute) doelen worden doorgaans gebruikt voor grootschalige productie-implementaties, omdat ze snelle reactietijd en automatische schaalaanpassing van de geïmplementeerde service bieden. Zie Wat zijn rekendoelen in Azure Machine Learning? voor meer informatie.

Klasse ComputeTarget-constructor.

Een cloudweergave ophalen van een rekenobject dat is gekoppeld aan de opgegeven werkruimte. Retourneert een exemplaar van een onderliggende klasse die overeenkomt met het specifieke type van het opgehaalde Compute-object.

Overname
AksCompute

Constructor

AksCompute(workspace, name)

Parameters

Name Description
workspace
Vereist

Het werkruimteobject met het AksCompute-object dat moet worden opgehaald.

name
Vereist
str

De naam van het AksCompute-object dat moet worden opgehaald.

workspace
Vereist

Het werkruimteobject met het rekenobject dat moet worden opgehaald.

name
Vereist
str

De naam van het rekenobject dat moet worden opgehaald.

Opmerkingen

In het volgende voorbeeld ziet u hoe u een AKS-cluster maakt met computers met FPGA-functionaliteit.


   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

AFGEKEURD. Gebruik in plaats daarvan de attach_configuration methode.

Koppel een bestaande AKS-rekenresource aan de opgegeven werkruimte.

attach_configuration

Maak een configuratieobject voor het koppelen van een AKS-rekendoel.

delete

Verwijder het AksCompute-object uit de bijbehorende werkruimte.

Als dit object is gemaakt via Azure Machine Learning, worden de bijbehorende cloudobjecten ook verwijderd. Als dit object extern is gemaakt en alleen aan de werkruimte is gekoppeld, wordt met deze methode een ComputeTargetException gegenereerd en wordt er niets gewijzigd.

deserialize

Converteer een JSON-object naar een AksCompute-object.

detach

Koppel het AksCompute-object los van de bijbehorende werkruimte.

Onderliggende cloudobjecten worden niet verwijderd, alleen de koppeling wordt verwijderd.

get_credentials

Haal de referenties voor het AKS-doel op.

provisioning_configuration

Maak een configuratieobject voor het inrichten van een AKS-rekendoel.

refresh_state

Voer een in-place update uit van de eigenschappen van het object.

Met deze methode worden de eigenschappen bijgewerkt op basis van de huidige status van het bijbehorende cloudobject. Dit wordt voornamelijk gebruikt voor handmatige polling van de rekenstatus.

serialize

Converteer dit AksCompute-object naar een geserialiseerde JSON-woordenlijst.

update

Werk het AksCompute-object bij met behulp van de opgegeven updateconfiguratie.

attach

AFGEKEURD. Gebruik in plaats daarvan de attach_configuration methode.

Koppel een bestaande AKS-rekenresource aan de opgegeven werkruimte.

static attach(workspace, name, resource_id)

Parameters

Name Description
workspace
Vereist

Het werkruimteobject waaraan de rekenresource moet worden gekoppeld.

name
Vereist
str

De naam die moet worden gekoppeld aan de rekenresource in de opgegeven werkruimte. Hoeft niet overeen te komen met de naam van de rekenresource die moet worden gekoppeld.

resource_id
Vereist
str

De Azure-resource-id voor de rekenresource die wordt gekoppeld.

Retouren

Type Description

Een AksCompute-objectweergave van het rekenobject.

Uitzonderingen

Type Description

attach_configuration

Maak een configuratieobject voor het koppelen van een AKS-rekendoel.

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

Parameters

Name Description
resource_group
str

De naam van de resourcegroep waarin de AKS zich bevindt.

Default value: None
cluster_name
str

De naam van het AKS-cluster.

Default value: None
resource_id
str

De Azure-resource-id voor de rekenresource die wordt gekoppeld.

Default value: None
cluster_purpose
str

Het gerichte gebruik van het cluster. Dit wordt gebruikt om Azure Machine Learning-onderdelen in te richten om het gewenste niveau van fouttolerantie en QoS te garanderen. De ClusterPurpose klasse definieert de mogelijke waarden. Zie Een bestaand AKS-cluster koppelen voor meer informatie.

Default value: None
load_balancer_type
str

Het AKS-clustertype. Geldige waarden zijn PublicIp en InternalLoadBalancer. De standaardwaarde is PublicIp.

Default value: None
load_balancer_subnet
str

Het subnet van de AKS-load balancer. Deze kan alleen worden gebruikt wanneer InternalLoadBalancer wordt gebruikt als load balancer-type. De standaardwaarde is aks-subnet.

Default value: None

Retouren

Type Description

Een configuratieobject dat moet worden gebruikt bij het koppelen van een compute-object.

Uitzonderingen

Type Description

delete

Verwijder het AksCompute-object uit de bijbehorende werkruimte.

Als dit object is gemaakt via Azure Machine Learning, worden de bijbehorende cloudobjecten ook verwijderd. Als dit object extern is gemaakt en alleen aan de werkruimte is gekoppeld, wordt met deze methode een ComputeTargetException gegenereerd en wordt er niets gewijzigd.

delete()

Uitzonderingen

Type Description

deserialize

Converteer een JSON-object naar een AksCompute-object.

static deserialize(workspace, object_dict)

Parameters

Name Description
workspace
Vereist

Het werkruimteobject waar het AksCompute-object aan is gekoppeld.

object_dict
Vereist

Een JSON-object dat moet worden geconverteerd naar een AksCompute-object.

Retouren

Type Description

De AksCompute-weergave van het opgegeven JSON-object.

Uitzonderingen

Type Description

Opmerkingen

Verhoogt een ComputeTargetException als de opgegeven werkruimte niet de werkruimte is die de compute is gekoppeld.

detach

Koppel het AksCompute-object los van de bijbehorende werkruimte.

Onderliggende cloudobjecten worden niet verwijderd, alleen de koppeling wordt verwijderd.

detach()

Uitzonderingen

Type Description

get_credentials

Haal de referenties voor het AKS-doel op.

get_credentials()

Retouren

Type Description

De referenties voor het AKS-doel.

Uitzonderingen

Type Description

provisioning_configuration

Maak een configuratieobject voor het inrichten van een AKS-rekendoel.

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)

Parameters

Name Description
agent_count
int

Het aantal agents (VM's) voor het hosten van containers. Standaardwaarde is 3.

Default value: None
vm_size
str

De grootte van agent-VM's. Een volledige lijst met opties vindt u hier: https://aka.ms/azureml-aks-details. De standaardinstelling is Standard_D3_v2.

Default value: None
ssl_cname
str

Een CName die moet worden gebruikt bij het inschakelen van SSL-validatie op het cluster. Moet alle drie de CName, het certificaatbestand en het sleutelbestand opgeven om SSL-validatie in te schakelen.

Default value: None
ssl_cert_pem_file
str

Een bestandspad naar een bestand met certificaatgegevens voor SSL-validatie. Moet alle drie de CName, het certificaatbestand en het sleutelbestand opgeven om SSL-validatie in te schakelen.

Default value: None
ssl_key_pem_file
str

Een bestandspad naar een bestand met belangrijke informatie voor SSL-validatie. Moet alle drie de CName, het certificaatbestand en het sleutelbestand opgeven om SSL-validatie in te schakelen.

Default value: None
location
str

De locatie waarin het cluster moet worden ingericht. Als dit niet is opgegeven, wordt standaard de locatie van de werkruimte ingesteld. Beschikbare regio's voor deze berekening vindt u hier: https://azure.microsoft.com/global-infrastructure/services/?regions=all& products=kubernetes-service

Default value: None
vnet_resourcegroup_name
str

De naam van de resourcegroep waarin het virtuele netwerk zich bevindt.

Default value: None
vnet_name
str

De naam van het virtuele netwerk.

Default value: None
subnet_name
str

De naam van het subnet in het vnet.

Default value: None
service_cidr
str

Een IP-adresbereik voor CIDR-notatie waaruit IP-adressen van serviceclusters kunnen worden toegewezen.

Default value: None
dns_service_ip
str

IP-adres van DNS-server containers.

Default value: None
docker_bridge_cidr
str

Een CIDR-notatie-IP voor Docker-brug.

Default value: None
cluster_purpose
str

Gericht gebruik van het cluster. Dit wordt gebruikt om Azure Machine Learning-onderdelen in te richten om het gewenste niveau van fouttolerantie en QoS te garanderen. De klasse AksCompute.ClusterPurpose wordt geleverd voor het gemak van het opgeven van beschikbare waarden. Meer gedetailleerde informatie over deze waarden en hun gebruiksvoorbeelden vindt u hier: https://aka.ms/azureml-create-attach-aks

Default value: None
load_balancer_type
str

Type load balancer van AKS-cluster. Geldige waarden zijn PublicIp en InternalLoadBalancer. De standaardwaarde is PublicIp.

Default value: None
load_balancer_subnet
str

Het subnet van de load balancer van het AKS-cluster. Het kan alleen worden gebruikt wanneer interne Load Balancer wordt gebruikt als load balancer-type. De standaardwaarde is aks-subnet.

Default value: None

Retouren

Type Description

Een configuratieobject dat moet worden gebruikt bij het maken van een rekenobject

Uitzonderingen

Type Description

refresh_state

Voer een in-place update uit van de eigenschappen van het object.

Met deze methode worden de eigenschappen bijgewerkt op basis van de huidige status van het bijbehorende cloudobject. Dit wordt voornamelijk gebruikt voor handmatige polling van de rekenstatus.

refresh_state()

Uitzonderingen

Type Description

serialize

Converteer dit AksCompute-object naar een geserialiseerde JSON-woordenlijst.

serialize()

Retouren

Type Description

De JSON-weergave van dit AksCompute-object.

Uitzonderingen

Type Description

update

Werk het AksCompute-object bij met behulp van de opgegeven updateconfiguratie.

update(update_configuration)

Parameters

Name Description
update_configuration
Vereist

Een configuratieobject voor AKS-update.

Uitzonderingen

Type Description