Guide de configuration d'un mandataire inverse

Mandataire inverse ¶

Mandatement inverse simple ¶

La directive ProxyPass permet de rediriger les requêtes entrantes vers un serveur d'arrière-plan (ou un cluster de serveurs plus connu sous le nom de groupe Balancer). Dans cet exemple le plus simple, toutes les requêtes ("/") sont redirigées vers un serveur d'arrière-plan unique :

ProxyPass "/"  "http://www.example.com/"

Pour s’assurer que les en-têtes Location: générés par le serveur dorsal soient modifiés pour pointer vers le mandataire inverse, et non vers le serveur d'arrière-plan, la directive ProxyPassReverse est en général requise :

ProxyPass "/"  "http://www.example.com/"
ProxyPassReverse "/"  "http://www.example.com/"

Il est possible de spécifier les URIs qui peuvent être mandatés, comme le montre l'exemple suivant :

ProxyPass "/images"  "http://www.example.com/"
ProxyPassReverse "/images"  "http://www.example.com/"

Dans l'exemple précédent, si le chemin d'une requête commence par /images, elle sera redirigée vers le serveur d'arrière-plan spécifié ; dans le cas contraire, elle sera traitée localement.

Grappes et répartiteurs de charge ¶

La configuration à un seul serveur dorsal ci-avant comporte un défaut évident : si ce serveur dorsal est éteint ou surchargé, le contenu mandaté ne sera pas disponible. Ce dont on a besoin ici est un groupe de serveurs dorsaux parmi lesquels le serveur mandataire pourra basculer et répartir la charge. Ce groupe est parfois appelé grappe (cluster) ; Apache httpd le nomme répartiteur de charge (balancer). Un répartiteur de charge se définit en utilisant les directives <Proxy> et BalancerMember :

<Proxy balancer://myset>
BalancerMember http://www2.example.com:8080
BalancerMember http://www3.example.com:8080
ProxySet lbmethod=bytraffic
</Proxy>

ProxyPass "/images/"  "balancer://myset/"
ProxyPassReverse "/images/"  "balancer://myset/"

Le protocole balancer:// indique à httpd que l'on souhaite créer un répartiteur de charge nommé myset. Ce répartiteur comporte deux serveurs d'arrière-plan référencés dans la terminologie httpd sous le nom de BalancerMembers. Avec cet exemple, toute requête dont le chemin commence par /images sera mandatée vers un des deux serveurs d'arrière-plan. La directive ProxySet définit ici pour le répartiteur myset un algorithme de répartition de charge basé sur le trafic entrées/sorties.

Configuration du répartiteur de charge et de ses membres (workers) ¶

Les répartiteurs de charge et leurs membres sont configurés à l’aide de paramètres de la directive ProxyPass. Par exemple, pour que http://www3.example.com:8080 gère le trafic avec un facteur 3 et un délai d’une seconde :

<Proxy balancer://myset>
BalancerMember http://www2.example.com:8080
BalancerMember http://www3.example.com:8080 loadfactor=3 timeout=1
ProxySet lbmethod=bytraffic
</Proxy>

ProxyPass "/images"  "balancer://myset/"
ProxyPassReverse "/images"  "balancer://myset/"

Gestion des indisponibilités (Failover) ¶

Vous pouvez définir finement des scénarios pour les cas d'indisponibilité d'un ou plusieurs serveurs dorsaux en spécifiant quels répartiteurs et leurs membres doivent alors prendre le relai. Dans l'exemple suivant, trois scénarios sont envisagés :

1. http://spare1.example.com:8080 et http://spare2.example.com:8080 ne sont sollicités que si http://www2.example.com:8080 ou http://www3.example.com:8080 est indisponible (un serveur de remplacement sera utilisé à la place d'un membre indisponible du même jeu de serveurs cibles).
2. http://hstandby.example.com:8080 n'est sollicité que si tous les autres serveurs cibles du jeu de serveurs 0 sont indisponibles.
3. Les serveurs http://bkup1.example.com:8080 et http://bkup2.example.com:8080 du jeu 1 ne seront sollicités que si tous les serveurs du jeu 0, tous les serveurs de remplacement et tous les serveurs de standby sont indisponibles.

Il est ainsi possible de définir un ou plusieurs serveurs de remplacement ou de standby pour chaque jeu de serveurs du répartiteur de charge.

<Proxy balancer://myset>
BalancerMember http://www2.example.com:8080
BalancerMember http://www3.example.com:8080 loadfactor=3 timeout=1
BalancerMember http://spare1.example.com:8080 status=+R
BalancerMember http://spare2.example.com:8080 status=+R
BalancerMember http://hstandby.example.com:8080 status=+H
BalancerMember http://bkup1.example.com:8080 lbset=1
BalancerMember http://bkup2.example.com:8080 lbset=1
ProxySet lbmethod=byrequests
</Proxy>

ProxyPass "/images/"  "balancer://myset/"
ProxyPassReverse "/images/"  "balancer://myset/"

Les serveurs de remplacement à chaud remplacent les serveurs indisponibles (en phase de vidage, arrêtés ou en état d’erreur) du même jeu de serveurs du répartiteur de charge. Les serveurs de standby à chaud ne sont activés que si tous les serveurs et serveurs de remplacement du jeu de serveurs du répartiteur de charge sont indisponibles. Les jeux de serveurs du répartiteur de charge sont sollicités dans l'ordre du plus bas lbset vers le plus haut.

Gestion du répartiteur de charge ¶

Apache httpd comporte un gestionnaire de répartiteur de charge (balancer-manager) intégré. Comme mod_status, il affiche la configuration et l’état actuels de vos répartiteurs de charge et de leurs membres. Il vous permet aussi de les reconfigurer à l’exécution — par exemple pour ajouter de nouveaux membres à un répartiteur existant. Pour l’activer, ajoutez les lignes suivantes à votre configuration :

<Location "/balancer-manager">
SetHandler balancer-manager
Require host localhost
</Location>

Lorsque vous accédez au serveur mandataire avec une adresse du style http://rproxy.example.com/balancer-manager/, la page suivante s'affiche :

Ce formulaire permet de modifier certains paramètres, de désactiver ou d'ajouter des serveurs dorsaux, et de modifier les règles de répartition de charge. Si l’on clique sur le répartiteur, la page suivante s'affiche :

Si on clique sur un membre du groupe de répartition de charge, la page suivante s'affiche :

Si vous souhaitez que ces modifications soient conservées après un redémarrage du serveur, assurez-vous que la directive BalancerPersist soit définie à On.

Vérification dynamique du bon fonctionnement d'un serveur dorsal ¶

Avant de mandater une requête, httpd peut "tester" si le serveur dorsal est disponible en définissant le paramètre ping de ce serveur via la directive ProxyPass. Cependant, il est souvent plus judicieux de vérifier le bon fonctionnement d'un serveur hors ibande via le module mod_proxy_hcheck.

Drapeaux d'état d'un membre du groupe de répartition de charge ¶

balancer-manager permet d'afficher et de modifier l'état d'un membre du groupe de répartition de charge. Les différents états et leurs significations sont les suivants :