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
Name | Description |
---|---|
workspace
Vereist
|
Het werkruimteobject met het AksCompute-object dat moet worden opgehaald. |
name
Vereist
|
De naam van het AksCompute-object dat moet worden opgehaald. |
workspace
Vereist
|
Het werkruimteobject met het rekenobject dat moet worden opgehaald. |
name
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 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
Name | Description |
---|---|
workspace
Vereist
|
Het werkruimteobject waaraan de rekenresource moet worden gekoppeld. |
name
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
Vereist
|
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
|
De naam van de resourcegroep waarin de AKS zich bevindt. Default value: None
|
cluster_name
|
De naam van het AKS-cluster. Default value: None
|
resource_id
|
De Azure-resource-id voor de rekenresource die wordt gekoppeld. Default value: None
|
cluster_purpose
|
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
|
Het AKS-clustertype. Geldige waarden zijn PublicIp en InternalLoadBalancer. De standaardwaarde is PublicIp. Default value: None
|
load_balancer_subnet
|
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
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
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
|
Het aantal agents (VM's) voor het hosten van containers. Standaardwaarde is 3. Default value: None
|
vm_size
|
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. Default value: None
|
ssl_cname
|
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
|
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
|
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
|
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 Default value: None
|
vnet_resourcegroup_name
|
De naam van de resourcegroep waarin het virtuele netwerk zich bevindt. Default value: None
|
vnet_name
|
De naam van het virtuele netwerk. Default value: None
|
subnet_name
|
De naam van het subnet in het vnet. Default value: None
|
service_cidr
|
Een IP-adresbereik van CIDR-notatie waaruit IP-adressen van serviceclusters moeten worden toegewezen. Default value: None
|
dns_service_ip
|
DNS-server-IP-adres van containers. Default value: None
|
docker_bridge_cidr
|
Een CIDR-notatie-IP voor Docker Bridge. Default value: None
|
cluster_purpose
|
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
|
Het type load balancer van het AKS-cluster. Geldige waarden zijn PublicIp en InternalLoadBalancer. De standaardwaarde is PublicIp. Default value: None
|
load_balancer_subnet
|
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. Default value: None
|
Retouren
Type | Description |
---|---|
Een configuratieobject dat moet worden gebruikt bij het maken van een compute-object |
Uitzonderingen
Type | Description |
---|---|
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
Type | Description |
---|---|
serialize
Converteer dit AksCompute-object naar een JSON-geserialiseerde 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 bijwerkconfiguratie.
update(update_configuration)
Parameters
Name | Description |
---|---|
update_configuration
Vereist
|
Een configuratieobject voor AKS-update. |
Uitzonderingen
Type | Description |
---|---|