Delen via

AksCompute Klas

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

AKSCompute-doelen (Azure Kubernetes Service) worden doorgaans 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 Compute-object 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.

Constructor

AksCompute(workspace, name)

Parameters

Name Description
workspace
Vereist
Workspace

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
Workspace

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

VEROUDERD. 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 is gekoppeld aan de werkruimte, wordt met deze methode een ComputeTargetException en 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

VEROUDERD. 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
Workspace

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
AksCompute

Een AksCompute-objectweergave van het rekenobject.

Uitzonderingen

Type Description
ComputeTargetException

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

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 een aks-subnet.

Default value: None

Retouren

Type Description
AksAttachConfiguration

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

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 is gekoppeld aan de werkruimte, wordt met deze methode een ComputeTargetException en niets gewijzigd.

delete()

Uitzonderingen

Type Description
ComputeTargetException

deserialize

Converteer een JSON-object naar een AksCompute-object.

static deserialize(workspace, object_dict)

Parameters

Name Description
workspace
Vereist
Workspace

Het werkruimteobject waarmee het AksCompute-object is gekoppeld.
object_dict
Vereist
dict

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

Retouren

Type Description
AksCompute

De AksCompute-weergave van het opgegeven JSON-object.

Uitzonderingen

Type Description
ComputeTargetException

Opmerkingen

Hiermee wordt een ComputeTargetException opgegeven als de opgegeven werkruimte niet de werkruimte is waarmee 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
ComputeTargetException

get_credentials

Haal de referenties voor het AKS-doel op.

get_credentials()

Retouren

Type Description
dict

De referenties voor het AKS-doel.

Uitzonderingen

Type Description
ComputeTargetException

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. Hier vindt u een volledige lijst met opties: 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-, certificaatbestand en 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-, certificaatbestand en 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-, certificaatbestand en 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 waar 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 van waaruit IP-adressen van serviceclusters moeten 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 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

Default value: None
load_balancer_type
str

Load balancer-type AKS-cluster. Geldige waarden zijn PublicIp en InternalLoadBalancer. De standaardwaarde is PublicIp.

Default value: None
load_balancer_subnet
str

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

Default value: None

Retouren

Type Description
AksProvisioningConfiguration

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

Uitzonderingen

Type Description
ComputeTargetException

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()

serialize

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

serialize()

Retouren

Type Description
dict

De JSON-weergave van dit AksCompute-object.

update

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

update(update_configuration)

Parameters

Name Description
update_configuration
Vereist
AksUpdateConfiguration

Een AKS-updateconfiguratieobject.

Uitzonderingen

Type Description
ComputeTargetException