AksCompute Classe

Gère une cible de calcul Azure Kubernetes Service dans Azure Machine Learning.

Les cibles Azure Kubernetes Service (AKSCompute) sont généralement utilisées pour les déploiements de production à grande échelle, car elles fournissent un temps de réponse rapide et une mise à l’échelle automatique du service déployé. Pour plus d’informations, consultez Quelles sont les cibles de calcul dans Azure Machine Learning ?

Constructeur ComputeTarget de classe.

Récupérez une représentation cloud d’un objet Compute associé à l’espace de travail fourni. Retourne une instance d’une classe enfant correspondant au type spécifique de l’objet Compute récupéré.

Constructeur

AksCompute(workspace, name)

Paramètres

Nom	Description
workspace Obligatoire	Workspace Objet d’espace de travail contenant l’objet AksCompute à récupérer.
name Obligatoire	str Nom de l’objet AksCompute à récupérer.
workspace Obligatoire	Workspace Objet d’espace de travail contenant l’objet Compute à récupérer.
name Obligatoire	str Nom de l’objet Compute à récupérer.

Remarques

L’exemple suivant montre comment créer un cluster AKS avec des machines compatibles 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)

Méthodes

attach	OBSOLESCENT. Utilisez plutôt la `attach_configuration` méthode. Associez une ressource de calcul AKS existante à l’espace de travail fourni.
attach_configuration	Créez un objet de configuration pour attacher une cible de calcul AKS.
delete	Supprimez l’objet AksCompute de son espace de travail associé. Si cet objet a été créé via Azure Machine Learning, les objets cloud correspondants sont également supprimés. Si cet objet a été créé en externe et attaché uniquement à l’espace de travail, cette méthode déclenche une ComputeTargetException opération et rien n’est modifié.
deserialize	Convertissez un objet JSON en objet AksCompute.
detach	Détachez l’objet AksCompute de son espace de travail associé. Les objets cloud sous-jacents ne sont pas supprimés, seule l’association est supprimée.
get_credentials	Récupérez les informations d’identification de la cible AKS.
provisioning_configuration	Créez un objet de configuration pour l’approvisionnement d’une cible de calcul AKS.
refresh_state	Effectuez une mise à jour sur place des propriétés de l’objet. Cette méthode met à jour les propriétés en fonction de l’état actuel de l’objet cloud correspondant. Ceci est principalement utilisé pour l’interrogation manuelle de l’état de calcul.
serialize	Convertissez cet objet AksCompute en dictionnaire sérialisé json.
update	Mettez à jour l’objet AksCompute à l’aide de la configuration de mise à jour fournie.

attach

OBSOLESCENT. Utilisez plutôt la attach_configuration méthode.

Associez une ressource de calcul AKS existante à l’espace de travail fourni.

static attach(workspace, name, resource_id)

Paramètres

Nom	Description
workspace Obligatoire	Workspace Objet d’espace de travail auquel associer la ressource de calcul.
name Obligatoire	str Nom à associer à la ressource de calcul à l’intérieur de l’espace de travail fourni. Ne doit pas correspondre au nom de la ressource de calcul à joindre.
resource_id Obligatoire	str ID de ressource Azure pour la ressource de calcul attachée.

Retours

Type	Description
AksCompute	Représentation d’objet AksCompute de l’objet de calcul.

Exceptions

Type	Description
ComputeTargetException

attach_configuration

Créez un objet de configuration pour attacher une cible de calcul AKS.

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

Paramètres

Nom	Description
resource_group	str Nom du groupe de ressources dans lequel se trouve AKS. Valeur par défaut: None
cluster_name	str Nom du cluster AKS. Valeur par défaut: None
resource_id	str ID de ressource Azure pour la ressource de calcul attachée. Valeur par défaut: None
cluster_purpose	str Utilisation ciblée du cluster. Cela permet de provisionner des composants Azure Machine Learning pour garantir le niveau de tolérance de panne et de qoS souhaité. La ClusterPurpose classe définit les valeurs possibles. Pour plus d’informations, consultez Attacher un cluster AKS existant. Valeur par défaut: None
load_balancer_type	str Type de cluster AKS. Les valeurs valides sont PublicIp et InternalLoadBalancer. La valeur par défaut est PublicIp. Valeur par défaut: None
load_balancer_subnet	str Sous-réseau de l’équilibreur de charge AKS. Elle ne peut être utilisée que lorsque InternalLoadBalancer est utilisé comme type d’équilibreur de charge. La valeur par défaut est aks-subnet. Valeur par défaut: None

Retours

Type	Description
AksAttachConfiguration	Objet de configuration à utiliser lors de l’attachement d’un objet Compute.

delete

Supprimez l’objet AksCompute de son espace de travail associé.

Si cet objet a été créé via Azure Machine Learning, les objets cloud correspondants sont également supprimés. Si cet objet a été créé en externe et attaché uniquement à l’espace de travail, cette méthode déclenche une ComputeTargetException opération et rien n’est modifié.

delete()

Exceptions

Type	Description
ComputeTargetException

deserialize

Convertissez un objet JSON en objet AksCompute.

static deserialize(workspace, object_dict)

Paramètres

Nom	Description
workspace Obligatoire	Workspace L’objet d’espace de travail auquel l’objet AksCompute est associé.
object_dict Obligatoire	dict Objet JSON à convertir en objet AksCompute.

Retours

Type	Description
AksCompute	Représentation AksCompute de l’objet JSON fourni.

Exceptions

Type	Description
ComputeTargetException

Remarques

Déclenche une ComputeTargetException opération si l’espace de travail fourni n’est pas l’espace de travail associé au calcul.

detach

Détachez l’objet AksCompute de son espace de travail associé.

Les objets cloud sous-jacents ne sont pas supprimés, seule l’association est supprimée.

detach()

Exceptions

Type	Description
ComputeTargetException

get_credentials

Récupérez les informations d’identification de la cible AKS.

get_credentials()

Retours

Type	Description
dict	Informations d’identification pour la cible AKS.

Exceptions

Type	Description
ComputeTargetException

provisioning_configuration

Créez un objet de configuration pour l’approvisionnement d’une cible de calcul 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)

Paramètres

Nom	Description
agent_count	int Nombre d’agents (machines virtuelles) pour héberger des conteneurs. La valeur par défaut est 3. Valeur par défaut: None
vm_size	str Taille des machines virtuelles de l’agent. Vous trouverez ici la liste complète des options : https://aka.ms/azureml-aks-details. La valeur par défaut est Standard_D3_v2. Valeur par défaut: None
ssl_cname	str Nom C à utiliser si vous activez la validation SSL sur le cluster. Doit fournir les trois fichiers CName, cert et key pour activer la validation SSL. Valeur par défaut: None
ssl_cert_pem_file	str Chemin d’accès d’un fichier contenant des informations de certificat pour la validation SSL. Doit fournir les trois fichiers CName, cert et key pour activer la validation SSL. Valeur par défaut: None
ssl_key_pem_file	str Chemin d’accès d’un fichier contenant des informations de clé pour la validation SSL. Doit fournir les trois fichiers CName, cert et key pour activer la validation SSL. Valeur par défaut: None
location	str Emplacement dans lequel approvisionner le cluster. S’il n’est pas spécifié, la valeur par défaut est l’emplacement de l’espace de travail. Les régions disponibles pour ce calcul sont disponibles ici : ;https://azure.microsoft.com/global-infrastructure/services/?regions=all& products=kubernetes-service Valeur par défaut: None
vnet_resourcegroup_name	str Nom du groupe de ressources où se trouve le réseau virtuel. Valeur par défaut: None
vnet_name	str nom du réseau virtuel. Valeur par défaut: None
subnet_name	str Nom du sous-réseau à l’intérieur du réseau virtuel. Valeur par défaut: None
service_cidr	str Plage d’adresses IP de notation CIDR à partir de laquelle attribuer des adresses IP de cluster de service. Valeur par défaut: None
dns_service_ip	str Conteneurs adresse IP du serveur DNS. Valeur par défaut: None
docker_bridge_cidr	str Adresse IP de notation CIDR pour le pont Docker. Valeur par défaut: None
cluster_purpose	str Utilisation ciblée du cluster. Cela permet de provisionner des composants Azure Machine Learning pour garantir le niveau de tolérance de panne et de qoS souhaité. La classe AksCompute.ClusterPurpose est fournie pour la commodité de spécifier des valeurs disponibles. Vous trouverez ici des informations plus détaillées sur ces valeurs et leurs cas d’usage : https://aka.ms/azureml-create-attach-aks Valeur par défaut: None
load_balancer_type	str Type d’équilibreur de charge du cluster AKS. Les valeurs valides sont PublicIp et InternalLoadBalancer. La valeur par défaut est PublicIp. Valeur par défaut: None
load_balancer_subnet	str Sous-réseau de l’équilibreur de charge du cluster AKS. Elle ne peut être utilisée que lorsque l’équilibreur de charge interne est utilisé comme type d’équilibreur de charge. La valeur par défaut est aks-subnet. Valeur par défaut: None

Retours

Type	Description
AksProvisioningConfiguration	Objet de configuration à utiliser lors de la création d’un objet Compute

Exceptions

Type	Description
ComputeTargetException

refresh_state

Effectuez une mise à jour sur place des propriétés de l’objet.

Cette méthode met à jour les propriétés en fonction de l’état actuel de l’objet cloud correspondant. Ceci est principalement utilisé pour l’interrogation manuelle de l’état de calcul.

refresh_state()

serialize

Convertissez cet objet AksCompute en dictionnaire sérialisé json.

serialize()

Retours

Type	Description
dict	Représentation JSON de cet objet AksCompute.

update

Mettez à jour l’objet AksCompute à l’aide de la configuration de mise à jour fournie.

update(update_configuration)

Paramètres

Nom	Description
update_configuration Obligatoire	AksUpdateConfiguration Objet de configuration de mise à jour AKS.

Exceptions

Type	Description
ComputeTargetException

Commentaires

Cette page a-t-elle été utile ?

Partager via

AksCompute Classe

Constructeur

Paramètres

Remarques

Méthodes

attach

Paramètres

Retours

Exceptions

attach_configuration

Paramètres

Retours

delete

Exceptions

deserialize

Paramètres

Retours

Exceptions

Remarques

detach

Exceptions

get_credentials

Retours

Exceptions

provisioning_configuration

Paramètres

Retours

Exceptions

refresh_state

serialize

Retours

update

Paramètres

Exceptions

Commentaires