AksCompute Klas

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

Azure Kubernetes Service (AKSCompute) doelen worden meestal gebruikt voor grootschalige productie-implementaties, omdat ze een 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.

Haal een cloudweergave op 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 Rekenobject.

Overname
AksCompute

Constructor

AksCompute(workspace, name)

Parameters

workspace
Workspace
Vereist

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

name
str
Vereist

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

workspace
Workspace
Vereist

Het werkruimteobject met het rekenobject dat moet worden opgehaald.

name
str
Vereist

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 van de eigenschappen van het object uit.

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 JSON-geserialiseerde woordenlijst.

update

Werk het AksCompute-object bij met behulp van de bijwerkconfiguratie.

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

workspace
Workspace
Vereist

Het werkruimteobject waaraan de rekenresource moet worden gekoppeld.

name
str
Vereist

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
str
Vereist

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

Retouren

Een AksCompute-objectweergave van het rekenobject.

Retourtype

Uitzonderingen

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

resource_group
str
standaardwaarde: None

De naam van de resourcegroep waarin de AKS zich bevindt.

cluster_name
str
standaardwaarde: None

De naam van het AKS-cluster.

resource_id
str
standaardwaarde: None

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

cluster_purpose
str
standaardwaarde: None

Het beoogde 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.

load_balancer_type
str
standaardwaarde: None

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

load_balancer_subnet
str
standaardwaarde: None

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.

Retouren

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

Retourtype

Uitzonderingen

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

deserialize

Converteer een JSON-object naar een AksCompute-object.

static deserialize(workspace, object_dict)

Parameters

workspace
Workspace
Vereist

Het werkruimteobject waar het AksCompute-object aan is gekoppeld.

object_dict
dict
Vereist

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

Retouren

De AksCompute-weergave van het opgegeven JSON-object.

Retourtype

Uitzonderingen

Opmerkingen

Genereert een ComputeTargetException als de opgegeven werkruimte niet de werkruimte is waar de compute aan is gekoppeld.

detach

Koppel het AksCompute-object los van de bijbehorende werkruimte.

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

detach()

Uitzonderingen

get_credentials

Haal de referenties voor het AKS-doel op.

get_credentials()

Retouren

De referenties voor het AKS-doel.

Retourtype

Uitzonderingen

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

agent_count
int
standaardwaarde: None

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

vm_size
str
standaardwaarde: None

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

ssl_cname
str
standaardwaarde: None

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.

ssl_cert_pem_file
str
standaardwaarde: None

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.

ssl_key_pem_file
str
standaardwaarde: None

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.

location
str
standaardwaarde: None

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

vnet_resourcegroup_name
str
standaardwaarde: None

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

vnet_name
str
standaardwaarde: None

De naam van het virtuele netwerk.

subnet_name
str
standaardwaarde: None

De naam van het subnet in het vnet.

service_cidr
str
standaardwaarde: None

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

dns_service_ip
str
standaardwaarde: None

DNS-server-IP-adres van containers.

docker_bridge_cidr
str
standaardwaarde: None

Een CIDR-notatie-IP voor Docker Bridge.

cluster_purpose
str
standaardwaarde: None

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 is beschikbaar 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

load_balancer_type
str
standaardwaarde: None

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

load_balancer_subnet
str
standaardwaarde: None

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

Retouren

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

Retourtype

Uitzonderingen

refresh_state

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

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

serialize

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

serialize()

Retouren

De JSON-weergave van dit AksCompute-object.

Retourtype

Uitzonderingen

update

Werk het AksCompute-object bij met behulp van de bijwerkconfiguratie.

update(update_configuration)

Parameters

update_configuration
AksUpdateConfiguration
Vereist

Een configuratieobject voor AKS-update.

Uitzonderingen