AksServiceDeploymentConfiguration Classe
Représente les informations de configuration de déploiement pour un service déployé sur Azure Kubernetes Service.
Crée un objet AksServiceDeploymentConfiguration à l’aide de la méthode deploy_configuration
de la classe AksWebservice.
Initialisez un objet de configuration pour le déploiement sur une cible de calcul AKS.
- Héritage
-
AksServiceDeploymentConfiguration
Constructeur
AksServiceDeploymentConfiguration(autoscale_enabled, autoscale_min_replicas, autoscale_max_replicas, autoscale_refresh_seconds, autoscale_target_utilization, collect_model_data, auth_enabled, cpu_cores, memory_gb, enable_app_insights, scoring_timeout_ms, replica_max_concurrent_requests, max_request_wait_time, num_replicas, primary_key, secondary_key, tags, properties, description, gpu_cores, period_seconds, initial_delay_seconds, timeout_seconds, success_threshold, failure_threshold, namespace, token_auth_enabled, compute_target_name, cpu_cores_limit, memory_gb_limit, blobfuse_enabled=None)
Paramètres
Nom | Description |
---|---|
cpu_cores_limit
Obligatoire
|
Nombre maximal de cœurs de processeur que ce Webservice est autorisé à utiliser. Peut être un nombre décimal. |
memory_gb_limit
Obligatoire
|
Quantité maximale de mémoire (en Go) que ce Webservice est autorisé à utiliser. Peut être un nombre décimal. |
autoscale_enabled
Obligatoire
|
Indique s’il est nécessaire d’activer la mise à l’échelle automatique pour ce service web.
La valeur par défaut est True si |
autoscale_min_replicas
Obligatoire
|
Nombre minimal de conteneurs à utiliser durant la mise à l’échelle automatique de ce Webservice. La valeur par défaut est de 1. |
autoscale_max_replicas
Obligatoire
|
Nombre maximal de conteneurs à utiliser durant la mise à l’échelle automatique de ce Webservice. La valeur par défaut est 10 |
autoscale_refresh_seconds
Obligatoire
|
Fréquence à laquelle l’autoscaler doit tenter de mettre à l’échelle ce Webservice. La valeur par défaut est de 1. |
autoscale_target_utilization
Obligatoire
|
Utilisation cible en pourcentage que l’autoscaler doit tenter de conserver pour ce Webservice. La valeur par défaut est 70. |
collect_model_data
Obligatoire
|
Indique s’il est nécessaire ou non d’activer la collecte de données de modèle pour ce Webservice. Valeur par défaut False. |
auth_enabled
Obligatoire
|
Indique s’il faut activer ou pas l’authentification pour ce service web. La valeur par défaut est True. |
cpu_cores
Obligatoire
|
Nombre de cœurs de processeur à allouer pour ce Webservice. Peut être un nombre décimal. La valeur par défaut est 0.1 |
memory_gb
Obligatoire
|
Quantité de mémoire (en Go) à allouer pour ce Webservice. Peut être un nombre décimal. La valeur par défaut est 0.5 |
enable_app_insights
Obligatoire
|
Indique s’il est nécessaire ou non d’activer la journalisation Application Insights pour ce Webservice. Par défaut, False |
scoring_timeout_ms
Obligatoire
|
Délai d’expiration à appliquer pour le scoring des appels à ce Webservice. La valeur par défaut est 60000. |
replica_max_concurrent_requests
Obligatoire
|
Nombre maximal de requêtes simultanées par réplica à autoriser pour ce Webservice. La valeur par défaut est de 1. Ne modifiez pas la valeur de ce paramètre (la valeur par défaut est 1), sauf indication contraire du support technique Microsoft ou d’un membre de l’équipe Azure Machine Learning. |
max_request_wait_time
Obligatoire
|
Durée maximale pendant laquelle une requête reste en file d’attente (en millisecondes) avant de retourner une erreur 503. La valeur par défaut est 500. |
num_replicas
Obligatoire
|
Nombre de conteneurs à allouer pour ce Webservice. Aucune valeur par défaut. Si ce paramètre n’est pas défini, l’autoscaler est activé par défaut. |
primary_key
Obligatoire
|
Clé d’authentification primaire à utiliser pour ce Webservice. |
secondary_key
Obligatoire
|
Clé d’authentification secondaire à utiliser pour ce Webservice. |
tags
Obligatoire
|
Dictionnaire d’étiquettes (clé-valeur) à fournir à ce Webservice. |
properties
Obligatoire
|
Dictionnaire de propriétés (clé-valeur) à fournir à ce Webservice. Vous ne pouvez pas changer ces propriétés après le déploiement. Toutefois, vous pouvez ajouter de nouvelles paires clé-valeur. |
description
Obligatoire
|
Description à fournir à ce Webservice. |
gpu_cores
Obligatoire
|
Nombre de cœurs GPU à allouer pour ce service web. La valeur par défaut est 0. |
period_seconds
Obligatoire
|
Fréquence (en secondes) d’exécution de probe liveness. La valeur par défaut est 10 secondes. La valeur minimale est 1. |
initial_delay_seconds
Obligatoire
|
Nombre de secondes après le démarrage du conteneur avant le lancement des probes liveness. La valeur par défaut est 310. |
timeout_seconds
Obligatoire
|
Délai d’expiration en secondes de la probe liveness. La valeur par défaut est de 2 secondes. La valeur minimale est 1. |
success_threshold
Obligatoire
|
Nombre minimal de réussites consécutives pour que la probe liveness soit considérée comme réussie après avoir échoué. La valeur par défaut est de 1. La valeur minimale est 1. |
failure_threshold
Obligatoire
|
Lorsqu’un Pod démarre et que la probe liveness échoue, Kubernetes essaie |
namespace
Obligatoire
|
Espace de noms Kubernetes sur lequel déployer ce Webservice : jusqu’à 63 caractères alphanumériques minuscules (lettres allant de « a » à « z », chiffres allant de « 0 » à « 9 » et traits d’union (« - »)). Le premier caractère et le dernier caractère ne peuvent pas être des traits d’union. |
token_auth_enabled
Obligatoire
|
Indique s’il est nécessaire ou non d’activer l’authentification Azure Active Directory pour ce service web. Si cette option est activée, les utilisateurs peuvent accéder au Webservice en récupérant un jeton d’accès à l’aide de leurs informations d’identification Azure Active Directory. Valeur par défaut False. |
cpu_cores_limit
Obligatoire
|
Nombre maximal de cœurs de processeur que ce Webservice est autorisé à utiliser. Peut être un nombre décimal. |
memory_gb_limit
Obligatoire
|
Quantité maximale de mémoire (en Go) que ce Webservice est autorisé à utiliser. Peut être un nombre décimal. |
blobfuse_enabled
|
Indique s’il faut ou non activer blobfuse pour le téléchargement de modèle pour ce Webservice. La valeur par défaut est True Valeur par défaut: None
|
autoscale_enabled
Obligatoire
|
Indique s’il est nécessaire d’activer la mise à l’échelle automatique pour ce service web.
La valeur par défaut est True si |
autoscale_min_replicas
Obligatoire
|
Nombre minimal de conteneurs à utiliser durant la mise à l’échelle automatique de ce Webservice. La valeur par défaut est de 1. |
autoscale_max_replicas
Obligatoire
|
Nombre maximal de conteneurs à utiliser durant la mise à l’échelle automatique de ce Webservice. La valeur par défaut est 10 |
autoscale_refresh_seconds
Obligatoire
|
Fréquence à laquelle l’autoscaler doit tenter de mettre à l’échelle ce Webservice. La valeur par défaut est de 1. |
autoscale_target_utilization
Obligatoire
|
Utilisation cible en pourcentage que l’autoscaler doit tenter de conserver pour ce Webservice. La valeur par défaut est 70. |
collect_model_data
Obligatoire
|
Indique s’il est nécessaire ou non d’activer la collecte de données de modèle pour ce Webservice. Valeur par défaut False. |
auth_enabled
Obligatoire
|
Indique s’il faut activer ou pas l’authentification pour ce service web. La valeur par défaut est True. |
cpu_cores
Obligatoire
|
Nombre de cœurs de processeur à allouer pour ce Webservice. Peut être un nombre décimal. La valeur par défaut est 0.1 |
memory_gb
Obligatoire
|
Quantité de mémoire (en Go) à allouer pour ce Webservice. Peut être un nombre décimal. La valeur par défaut est 0.5 |
enable_app_insights
Obligatoire
|
Indique s’il est nécessaire ou non d’activer la journalisation Application Insights pour ce Webservice. Par défaut, False |
scoring_timeout_ms
Obligatoire
|
Délai d’expiration à appliquer pour le scoring des appels à ce Webservice. La valeur par défaut est 60000. |
replica_max_concurrent_requests
Obligatoire
|
Nombre maximal de requêtes simultanées par réplica à autoriser pour ce Webservice. La valeur par défaut est de 1. Ne modifiez pas la valeur de ce paramètre (la valeur par défaut est 1), sauf indication contraire du support technique Microsoft ou d’un membre de l’équipe Azure Machine Learning. |
max_request_wait_time
Obligatoire
|
Durée maximale pendant laquelle une requête reste en file d’attente (en millisecondes) avant de retourner une erreur 503. La valeur par défaut est 500. |
num_replicas
Obligatoire
|
Nombre de conteneurs à allouer pour ce Webservice. Aucune valeur par défaut. Si ce paramètre n’est pas défini, l’autoscaler est activé par défaut. |
primary_key
Obligatoire
|
Clé d’authentification primaire à utiliser pour ce Webservice. |
secondary_key
Obligatoire
|
Clé d’authentification secondaire à utiliser pour ce Webservice. |
tags
Obligatoire
|
Dictionnaire d’étiquettes (clé-valeur) à fournir à ce Webservice. |
properties
Obligatoire
|
Dictionnaire de propriétés (clé-valeur) à fournir à ce Webservice. Vous ne pouvez pas changer ces propriétés après le déploiement. Toutefois, vous pouvez ajouter de nouvelles paires clé-valeur. |
description
Obligatoire
|
Description à fournir à ce Webservice. |
gpu_cores
Obligatoire
|
Nombre de cœurs GPU à allouer pour ce service web. La valeur par défaut est 0. |
period_seconds
Obligatoire
|
Fréquence (en secondes) d’exécution de probe liveness. La valeur par défaut est 10 secondes. La valeur minimale est 1. |
initial_delay_seconds
Obligatoire
|
Nombre de secondes après le démarrage du conteneur avant le lancement des probes liveness. La valeur par défaut est 310. |
timeout_seconds
Obligatoire
|
Délai d’expiration en secondes de la probe liveness. La valeur par défaut est de 2 secondes. La valeur minimale est 1. |
success_threshold
Obligatoire
|
Nombre minimal de réussites consécutives pour que la probe liveness soit considérée comme réussie après avoir échoué. La valeur par défaut est de 1. La valeur minimale est 1. |
failure_threshold
Obligatoire
|
Lorsqu’un Pod démarre et que la probe liveness échoue, Kubernetes essaie |
namespace
Obligatoire
|
Espace de noms Kubernetes sur lequel déployer ce Webservice : jusqu’à 63 caractères alphanumériques minuscules (lettres allant de « a » à « z », chiffres allant de « 0 » à « 9 » et traits d’union (« - »)). Le premier caractère et le dernier caractère ne peuvent pas être des traits d’union. |
token_auth_enabled
Obligatoire
|
Indique s’il est nécessaire ou non d’activer l’authentification Azure Active Directory pour ce service web. Si cette option est activée, les utilisateurs peuvent accéder au Webservice en récupérant un jeton d’accès à l’aide de leurs informations d’identification Azure Active Directory. Valeur par défaut False. |
compute_target_name
Obligatoire
|
Nom de la cible de calcul sur laquelle effectuer le déploiement |
cpu_cores_limit
Obligatoire
|
Nombre maximal de cœurs de processeur que ce Webservice est autorisé à utiliser. Peut être un nombre décimal. |
memory_gb_limit
Obligatoire
|
Quantité maximale de mémoire (en Go) que ce Webservice est autorisé à utiliser. Peut être un nombre décimal. |
blobfuse_enabled
Obligatoire
|
Indique s’il faut ou non activer blobfuse pour le téléchargement de modèle pour ce Webservice. La valeur par défaut est True |
Variables
Nom | Description |
---|---|
autoscale_enabled
|
Indique s’il est nécessaire d’activer la mise à l’échelle automatique pour ce service web.
La valeur par défaut est True si |
autoscale_min_replicas
|
Nombre minimal de conteneurs à utiliser durant la mise à l’échelle automatique de ce Webservice. La valeur par défaut est de 1. |
autoscale_max_replicas
|
Nombre maximal de conteneurs à utiliser durant la mise à l’échelle automatique de ce Webservice. La valeur par défaut est 10 |
autoscale_refresh_seconds
|
Fréquence à laquelle l’autoscaler doit tenter de mettre à l’échelle ce Webservice. La valeur par défaut est de 1. |
autoscale_target_utilization
|
Utilisation cible en pourcentage que l’autoscaler doit tenter de conserver pour ce Webservice. La valeur par défaut est 70. |
collect_model_data
|
Indique s’il est nécessaire ou non d’activer la collecte de données de modèle pour ce Webservice. Valeur par défaut False. |
auth_enabled
|
Indique s’il faut activer ou pas l’authentification pour ce service web. La valeur par défaut est True. |
cpu_cores
|
Nombre de cœurs de processeur à allouer pour ce Webservice. Peut être un nombre décimal. La valeur par défaut est 0.1 |
memory_gb
|
Quantité de mémoire (en Go) à allouer pour ce Webservice. Peut être un nombre décimal. La valeur par défaut est 0.5 |
enable_app_insights
|
Indique s’il est nécessaire ou non d’activer la journalisation Application Insights pour ce Webservice. Par défaut, False |
scoring_timeout_ms
|
Délai d’expiration à appliquer pour le scoring des appels à ce Webservice. La valeur par défaut est 60000. |
replica_max_concurrent_requests
|
Nombre maximal de requêtes simultanées par réplica à autoriser pour ce Webservice. La valeur par défaut est de 1. Ne modifiez pas la valeur de ce paramètre (la valeur par défaut est 1), sauf indication contraire du support technique Microsoft ou d’un membre de l’équipe Azure Machine Learning. |
max_request_wait_time
|
Durée maximale pendant laquelle une requête reste en file d’attente (en millisecondes) avant de retourner une erreur 503. La valeur par défaut est 500. |
num_replicas
|
Nombre de conteneurs à allouer pour ce Webservice. Aucune valeur par défaut. Si ce paramètre n’est pas défini, l’autoscaler est activé par défaut. |
primary_key
|
Clé d’authentification primaire à utiliser pour ce Webservice. |
secondary_key
|
Clé d’authentification secondaire à utiliser pour ce Webservice. |
azureml.core.webservice.AksServiceDeploymentConfiguration.tags
|
Dictionnaire d’étiquettes (clé-valeur) à fournir à ce Webservice. |
azureml.core.webservice.AksServiceDeploymentConfiguration.properties
|
Dictionnaire de propriétés (clé-valeur) à fournir à ce Webservice. Vous ne pouvez pas changer ces propriétés après le déploiement. Toutefois, vous pouvez ajouter de nouvelles paires clé-valeur. |
azureml.core.webservice.AksServiceDeploymentConfiguration.description
|
Description à fournir à ce Webservice. |
gpu_cores
|
Nombre de cœurs GPU à allouer pour ce service web. La valeur par défaut est 0. |
period_seconds
|
Fréquence (en secondes) d’exécution de probe liveness. La valeur par défaut est 10 secondes. La valeur minimale est 1. |
initial_delay_seconds
|
Nombre de secondes après le démarrage du conteneur avant le lancement des probes liveness. La valeur par défaut est 310. |
timeout_seconds
|
Délai d’expiration en secondes de la probe liveness. La valeur par défaut est de 2 secondes. La valeur minimale est 1. |
success_threshold
|
Nombre minimal de réussites consécutives pour que la probe liveness soit considérée comme réussie après avoir échoué. La valeur par défaut est de 1. La valeur minimale est 1. |
failure_threshold
|
Lorsqu’un Pod démarre et que la probe liveness échoue, Kubernetes essaie |
azureml.core.webservice.AksServiceDeploymentConfiguration.namespace
|
Espace de noms Kubernetes sur lequel déployer ce Webservice : jusqu’à 63 caractères alphanumériques minuscules (lettres allant de « a » à « z », chiffres allant de « 0 » à « 9 » et traits d’union (« - »)). Le premier caractère et le dernier caractère ne peuvent pas être des traits d’union. |
token_auth_enabled
|
Indique s’il est nécessaire ou non d’activer l’authentification Azure Active Directory pour ce service web. Si cette option est activée, les utilisateurs peuvent accéder au Webservice en récupérant un jeton d’accès à l’aide de leurs informations d’identification Azure Active Directory. Valeur par défaut False. |
Méthodes
print_deploy_configuration |
Imprimez la configuration du déploiement. |
validate_configuration |
Vérifiez que les valeurs de configuration spécifiées sont valides. Lève une WebserviceException si la validation échoue. |
print_deploy_configuration
Imprimez la configuration du déploiement.
print_deploy_configuration()
validate_configuration
Vérifiez que les valeurs de configuration spécifiées sont valides.
Lève une WebserviceException si la validation échoue.
validate_configuration()
Exceptions
Type | Description |
---|---|