AksCompute Klasa

Zarządza obiektem docelowym obliczeń Azure Kubernetes Service w usłudze Azure Machine Learning.

cele Azure Kubernetes Service (AKSCompute) są zwykle używane w przypadku wdrożeń produkcyjnych na dużą skalę, ponieważ zapewniają one szybki czas odpowiedzi i skalowanie automatyczne wdrożonej usługi. Aby uzyskać więcej informacji, zobacz Co to są docelowe obiekty obliczeniowe w usłudze Azure Machine Learning?

Klasa ComputeTarget, konstruktor.

Pobieranie reprezentacji chmury obiektu obliczeniowego skojarzonego z podanym obszarem roboczym. Zwraca wystąpienie klasy podrzędnej odpowiadające określonemu typowi pobranego obiektu obliczeniowego.

Dziedziczenie
AksCompute

Konstruktor

AksCompute(workspace, name)

Parametry

workspace
Workspace
Wymagane

Obiekt obszaru roboczego zawierający obiekt AksCompute do pobrania.

name
str
Wymagane

Nazwa obiektu AksCompute do pobrania.

workspace
Workspace
Wymagane

Obiekt obszaru roboczego zawierający obiekt Compute do pobrania.

name
str
Wymagane

Nazwa obiektu Compute do pobrania.

Uwagi

W poniższym przykładzie pokazano, jak utworzyć klaster usługi AKS z maszynami z włączoną funkcją FPGA.


   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)

Metody

attach

PRZESTARZAŁE. attach_configuration Zamiast tego użyj metody .

Skojarz istniejący zasób obliczeniowy usługi AKS z podanym obszarem roboczym.

attach_configuration

Utwórz obiekt konfiguracji do dołączania docelowego obiektu obliczeniowego usługi AKS.

delete

Usuń obiekt AksCompute z skojarzonego obszaru roboczego.

Jeśli ten obiekt został utworzony za pośrednictwem usługi Azure Machine Learning, odpowiednie obiekty oparte na chmurze zostaną również usunięte. Jeśli ten obiekt został utworzony zewnętrznie i dołączony tylko do obszaru roboczego, ta metoda zgłasza ComputeTargetException wartość i nic nie zostanie zmienione.

deserialize

Przekonwertuj obiekt JSON na obiekt AksCompute.

detach

Odłącz obiekt AksCompute od skojarzonego obszaru roboczego.

Bazowe obiekty w chmurze nie są usuwane, tylko skojarzenie jest usuwane.

get_credentials

Pobierz poświadczenia dla obiektu docelowego usługi AKS.

provisioning_configuration

Utwórz obiekt konfiguracji na potrzeby aprowizowania docelowego obiektu obliczeniowego usługi AKS.

refresh_state

Wykonaj aktualizację w miejscu właściwości obiektu.

Ta metoda aktualizuje właściwości na podstawie bieżącego stanu odpowiedniego obiektu w chmurze. Jest to używane głównie do ręcznego sondowania stanu obliczeniowego.

serialize

Przekonwertuj ten obiekt AksCompute na słownik serializacji json.

update

Zaktualizuj obiekt AksCompute przy użyciu podanej konfiguracji aktualizacji.

attach

PRZESTARZAŁE. attach_configuration Zamiast tego użyj metody .

Skojarz istniejący zasób obliczeniowy usługi AKS z podanym obszarem roboczym.

static attach(workspace, name, resource_id)

Parametry

workspace
Workspace
Wymagane

Obiekt obszaru roboczego do skojarzenia zasobu obliczeniowego z.

name
str
Wymagane

Nazwa do skojarzenia z zasobem obliczeniowym w podanym obszarze roboczym. Nie musi być zgodna z nazwą zasobu obliczeniowego do dołączenia.

resource_id
str
Wymagane

Identyfikator zasobu platformy Azure dla dołączonego zasobu obliczeniowego.

Zwraca

Reprezentacja obiektu obliczeniowego w obiekcie AksCompute.

Typ zwracany

Wyjątki

attach_configuration

Utwórz obiekt konfiguracji do dołączania docelowego obiektu obliczeniowego usługi AKS.

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

Parametry

resource_group
str
wartość domyślna: None

Nazwa grupy zasobów, w której znajduje się usługa AKS.

cluster_name
str
wartość domyślna: None

Nazwa klastra usługi AKS.

resource_id
str
wartość domyślna: None

Identyfikator zasobu platformy Azure dla dołączonego zasobu obliczeniowego.

cluster_purpose
str
wartość domyślna: None

Docelowe użycie klastra. Służy to do aprowizowania składników usługi Azure Machine Learning w celu zapewnienia żądanego poziomu odporności na uszkodzenia i QoS. Klasa ClusterPurpose definiuje możliwe wartości. Aby uzyskać więcej informacji, zobacz Dołączanie istniejącego klastra usługi AKS.

load_balancer_type
str
wartość domyślna: None

Typ klastra usługi AKS. Prawidłowe wartości to PublicIp i InternalLoadBalancer. Wartość domyślna to PublicIp.

load_balancer_subnet
str
wartość domyślna: None

Podsieć modułu równoważenia obciążenia usługi AKS. Można go używać tylko wtedy, gdy moduł InternalLoadBalancer jest używany jako typ modułu równoważenia obciążenia. Wartość domyślna to aks-subnet.

Zwraca

Obiekt konfiguracji, który ma być używany podczas dołączania obiektu obliczeniowego.

Typ zwracany

Wyjątki

delete

Usuń obiekt AksCompute z skojarzonego obszaru roboczego.

Jeśli ten obiekt został utworzony za pośrednictwem usługi Azure Machine Learning, odpowiednie obiekty oparte na chmurze zostaną również usunięte. Jeśli ten obiekt został utworzony zewnętrznie i dołączony tylko do obszaru roboczego, ta metoda zgłasza ComputeTargetException wartość i nic nie zostanie zmienione.

delete()

Wyjątki

deserialize

Przekonwertuj obiekt JSON na obiekt AksCompute.

static deserialize(workspace, object_dict)

Parametry

workspace
Workspace
Wymagane

Obiekt obszaru roboczego, z który jest skojarzony obiekt AksCompute.

object_dict
dict
Wymagane

Obiekt JSON do konwersji na obiekt AksCompute.

Zwraca

Reprezentacja AksCompute dostarczonego obiektu JSON.

Typ zwracany

Wyjątki

Uwagi

Zgłasza wartość , ComputeTargetException jeśli podany obszar roboczy nie jest obszarem roboczym skojarzonym z usługą Compute.

detach

Odłącz obiekt AksCompute od skojarzonego obszaru roboczego.

Bazowe obiekty w chmurze nie są usuwane, tylko skojarzenie jest usuwane.

detach()

Wyjątki

get_credentials

Pobierz poświadczenia dla obiektu docelowego usługi AKS.

get_credentials()

Zwraca

Poświadczenia obiektu docelowego usługi AKS.

Typ zwracany

Wyjątki

provisioning_configuration

Utwórz obiekt konfiguracji na potrzeby aprowizowania docelowego obiektu obliczeniowego usługi AKS.

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)

Parametry

agent_count
int
wartość domyślna: None

Liczba agentów (maszyn wirtualnych) do hostowania kontenerów. Wartość domyślna to 3.

vm_size
str
wartość domyślna: None

Rozmiar maszyn wirtualnych agenta. Pełną listę opcji można znaleźć tutaj: https://aka.ms/azureml-aks-details. Wartość domyślna to Standard_D3_v2.

ssl_cname
str
wartość domyślna: None

CName do użycia w przypadku włączenia walidacji SSL w klastrze. Aby włączyć walidację protokołu SSL, należy podać wszystkie trzy nazwy CName, plik certyfikatu i plik klucza.

ssl_cert_pem_file
str
wartość domyślna: None

Ścieżka pliku do pliku zawierającego informacje o certyfikacie na potrzeby walidacji protokołu SSL. Aby włączyć walidację protokołu SSL, należy podać wszystkie trzy nazwy CName, plik certyfikatu i plik klucza.

ssl_key_pem_file
str
wartość domyślna: None

Ścieżka pliku do pliku zawierającego informacje o kluczu do weryfikacji protokołu SSL. Aby włączyć walidację protokołu SSL, należy podać wszystkie trzy nazwy CName, plik certyfikatu i plik klucza.

location
str
wartość domyślna: None

Lokalizacja aprowizacji klastra. Jeśli nie zostanie określony, wartość domyślna to lokalizacja obszaru roboczego. Dostępne regiony dla tego obliczeniowego można znaleźć tutaj: https://azure.microsoft.com/global-infrastructure/services/?regions=all& products=kubernetes-service

vnet_resourcegroup_name
str
wartość domyślna: None

Nazwa grupy zasobów, w której znajduje się sieć wirtualna.

vnet_name
str
wartość domyślna: None

Nazwa sieci wirtualnej.

subnet_name
str
wartość domyślna: None

Nazwa podsieci wewnątrz sieci wirtualnej.

service_cidr
str
wartość domyślna: None

Zakres adresów IP notacji CIDR, z którego mają zostać przypisane adresy IP klastra usług.

dns_service_ip
str
wartość domyślna: None

Kontenery adres IP serwera DNS.

docker_bridge_cidr
str
wartość domyślna: None

Adres IP notacji CIDR dla mostka platformy Docker.

cluster_purpose
str
wartość domyślna: None

Docelowe użycie klastra. Służy to do aprowizowania składników usługi Azure Machine Learning w celu zapewnienia żądanego poziomu odporności na uszkodzenia i QoS. Klasa AksCompute.ClusterPurpose jest udostępniana dla wygody określania dostępnych wartości. Bardziej szczegółowe informacje o tych wartościach i ich przypadkach użycia można znaleźć tutaj: https://aka.ms/azureml-create-attach-aks

load_balancer_type
str
wartość domyślna: None

Typ modułu równoważenia obciążenia klastra usługi AKS. Prawidłowe wartości to PublicIp i InternalLoadBalancer. Wartość domyślna to PublicIp.

load_balancer_subnet
str
wartość domyślna: None

Podsieć modułu równoważenia obciążenia klastra usługi AKS. Może być używany tylko wtedy, gdy wewnętrzny Load Balancer jest używany jako typ modułu równoważenia obciążenia. Wartość domyślna to aks-subnet.

Zwraca

Obiekt konfiguracji, który ma być używany podczas tworzenia obiektu obliczeniowego

Typ zwracany

Wyjątki

refresh_state

Wykonaj aktualizację w miejscu właściwości obiektu.

Ta metoda aktualizuje właściwości na podstawie bieżącego stanu odpowiedniego obiektu w chmurze. Jest to używane głównie do ręcznego sondowania stanu obliczeniowego.

refresh_state()

Wyjątki

serialize

Przekonwertuj ten obiekt AksCompute na słownik serializacji json.

serialize()

Zwraca

Reprezentacja JSON tego obiektu AksCompute.

Typ zwracany

Wyjątki

update

Zaktualizuj obiekt AksCompute przy użyciu podanej konfiguracji aktualizacji.

update(update_configuration)

Parametry

update_configuration
AksUpdateConfiguration
Wymagane

Obiekt konfiguracji aktualizacji usługi AKS.

Wyjątki