Schéma LoadBalancerProbe de définition Azure Cloud Services (classique)
Important
Cloud Services (classique) est désormais déconseillé pour tous les clients depuis le 1er septembre 2024. Tous les déploiements existants en cours d’exécution seront arrêtés par Microsoft, et les données seront définitivement perdues à partir d’octobre 2024. Les nouveaux déploiements doivent utiliser le nouveau modèle de déploiement basé sur Azure Resource Manager Azure Cloud Services (support étendu) .
La sonde d’équilibreur de charge est une sonde d’intégrité définie par le client qui vérifie les points de terminaison UDP et les points de terminaison dans les instances de rôle. LaLoadBalancerProbe n’est pas un élément autonome ; elle est associée au rôle Web ou au Worker dans un fichier de définition de service. Plusieurs rôles peuvent utiliser une LoadBalancerProbe.
L’extension par défaut du fichier de définition de service est .csdef.
Fonction d’une sonde d’équilibreur de charge
Azure Load Balancer est chargé du routage du trafic entrant vers vos instances de rôle. L’équilibreur de charge détermine quelles instances peuvent recevoir du trafic en sondant régulièrement chaque instance afin de déterminer son intégrité. L’équilibreur de charge sonde chaque instance plusieurs fois par minute. Il existe deux options pour fournir l’intégrité de l’instance à l’équilibreur de charge : la sonde d’équilibreur de charge par défaut ou une sonde d’équilibreur de charge personnalisée, qui est implémentée en définissant LoadBalancerProbe dans le fichier .csdef.
La sonde d’équilibreur de charge par défaut utilise l’agent invité de la machine virtuelle, qui écoute et répond avec une réponse HTTP 200 OK uniquement si l’état de l’instance est Prêt (c.-à-d., si l’état de l’instance n’est pas Occupé, Recyclage, Arrêté, etc.). Si l’agent invité ne répond pas avec HTTP 200 OK, Azure Load Balancer marque l’instance comme ne répondant pas et arrête d’envoyer du trafic vers celle-ci. Azure Load Balancer continue à effectuer des tests ping de l’instance, et si l’agent invité répond avec HTTP 200, Azure Load Balancer envoie de nouveau le trafic vers cette instance. Lorsque vous utilisez un rôle web, le code de votre site web s'exécute généralement dans w3wp.exe, que l’agent Azure Fabric et l’agent invité ne surveillent pas. Les échecs dans w3wp.exe (par exemple, les réponses HTTP 500) ne sont pas signalés à l’agent invité et l’équilibreur de charge ne sait pas sortir cette instance de la rotation.
La sonde d’équilibreur de charge personnalisée remplace la sonde de l’agent invité par défaut et vous permet de créer votre propre logique personnalisée pour déterminer l’intégrité de l’instance de rôle. L’équilibreur de charge sonde régulièrement votre point de terminaison (toutes les 15 secondes, par défaut). L’instance est considérée comme en rotation si elle répond avec un TCP ACK ou HTTP 200 dans le délai imparti (31 secondes par défaut). Ce processus peut être utile pour implémenter votre propre logique pour supprimer des instances de la rotation de l’équilibreur de charge (par exemple en retournant un état autre que 200 si l’instance représente plus de 90 % du processeur). Pour les rôles web qui utilisent w3wp.exe, cette configuration signifie également que vous obtenez une surveillance automatique de votre site web, dans la mesure où les échecs dans le code de votre site web retournent un état autre que 200 à la sonde d’équilibreur de charge. Si vous ne définissez pas de LoadBalancerProbe dans le fichier csdef, le comportement par défaut de l’équilibreur de charge (comme décrit précédemment) est utilisé.
Si vous utilisez une sonde d’équilibreur de charge personnalisée, vous devez vous assurer que votre logique prend en compte la méthode RoleEnvironment.OnStop. Lorsque vous utilisez la sonde d’équilibreur de charge par défaut, l’instance est extraite de la rotation avant qu’OnStop ne soit appelé, mais une sonde d’équilibreur de charge personnalisée peut continuer à retourner une réponse 200 OK pendant l’événement OnStop. Si vous utilisez l’événement OnStop pour nettoyer le cache, arrêter le service ou apporter toute autre modification pouvant affecter le comportement de l’exécution de votre service, vous devez vous assurer que votre logique de sonde d’équilibreur de charge personnalisée supprime l’instance de la rotation.
Schéma de définition de service de base pour une sonde d’équilibreur de charge
Le format de base d’un fichier de définition de service contenant une sonde d’équilibreur de charge est le suivant.
<ServiceDefinition …>
<LoadBalancerProbes>
<LoadBalancerProbe name="<load-balancer-probe-name>" protocol="[http|tcp]" path="<uri-for-checking-health-status-of-vm>" port="<port-number>" intervalInSeconds="<interval-in-seconds>" timeoutInSeconds="<timeout-in-seconds>"/>
</LoadBalancerProbes>
</ServiceDefinition>
Éléments du schéma
L’élément LoadBalancerProbes du fichier de définition de service inclut les éléments suivants :
Élément LoadBalancerProbes
L’élément LoadBalancerProbes décrit la collection de sondes d’équilibreur de charge. Cet élément est l'élément parent de l'élément LoadBalancerProbe.
Élément LoadBalancerProbe
L’élément LoadBalancerProbe définit la sonde d’intégrité pour un modèle. Vous pouvez définir plusieurs sondes d’équilibreur de charge.
Le tableau suivant décrit les attributs de l’élément LoadBalancerProbe :
| Attribut | Type | Description |
|---|---|---|
name |
string |
Obligatoire. Le nom de la sonde d’équilibreur de charge. Le nom doit être unique. |
protocol |
string |
Obligatoire. Spécifie le protocole du point de terminaison. Les valeurs possibles sont http ou tcp. Si tcp est spécifié, une réponse ACK est requise pour que la sonde réussisse. Si http est spécifié, une réponse 200 OK de l’URI spécifiée est requise pour que la sonde réussisse. |
path |
string |
L’URI utilisée pour demander l’état d’intégrité de la machine virtuelle. path est nécessaire si protocol est défini sur http. Sinon, il n’est pas autorisé.Il n’existe aucune valeur par défaut. |
port |
integer |
facultatif. Le port de communication de la sonde. Cet attribut est facultatif pour tous les points de terminaison, car le même port est utilisé pour la sonde. Vous pouvez également configurer un port différent pour leur détection. Les valeurs possibles sont comprises entre 1 et 65535, ces deux valeurs étant incluses. La valeur par défaut est définie par le point de terminaison. |
intervalInSeconds |
integer |
facultatif. L’intervalle, en secondes, de fréquence de détection de l’état d’intégrité du point de terminaison. En règle générale, l’intervalle est légèrement inférieur à la moitié du délai d’expiration alloué (en secondes), ce qui permet d’utiliser deux sondes complètes avant de mettre l’instance hors rotation. La valeur par défaut est 15. La valeur minimale est 5. |
timeoutInSeconds |
integer |
facultatif. Le délai d’expiration, en secondes, appliqué à la sonde lorsqu’aucune réponse n’entraîne l’arrêt du trafic vers le point de terminaison. Cette valeur permet d’extraire des points de terminaison de la rotation plus rapidement ou plus lentement que le nombre de fois habituel dans Azure (valeurs par défaut). La valeur par défaut est 31. La valeur minimale est 11. |