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 être sur que cette redirection soit effectuée et que les en-têtes Location: générés par le serveur d'arrière-plan soient modifiés pour pointer vers le mandataire inverse, et non vers le serveur d'arrière-plan, la directive ProxyPassReverse est souvent requise :

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

Seules des URIs spécifiques peuvent être mandatées, 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.

Clusters et Balancers ¶

Utiliser un serveur d'arrière-plan unique n'est cependant pas une solution idéale car ce dernier peut devenir indisponible ou surchargé, et le mandatement inverse vers ce serveur ne présente alors plus aucun avantage. La solution réside dans la définition d'un groupe de serveurs d'arrière-plan qui vont se partager le traitement des requêtes via un mécanisme de répartition de charge et de gestion des indisponibilités pris en charge par le mandataire. Ce groupe de répartition est plus connu sous le nom de cluster, mais dans la terminologie d'Apache httpd, on utilise plutôt le terme de balancer. Un balancer se définit en utilisant les directives <Proxy> et BalancerMember comme suit :

<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 balancer nommé myset. Ce balancer 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 balancer myset un algorithme de répartition de charge basé sur le trafic entrées/sorties.

Configuration du Balancer et des BalancerMembers ¶

Vous pouvez configurer de manière détaillée les balancers et workers via les nombreux paramètres de la directive ProxyPass. Par exemple, si vous souhaitez que http://www3.example.com:8080 traite avec un facteur 3 le trafic avec un timeout d'une seconde, utilisez la configuration suivante :

<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 aussi définir finement des scénarios pour les cas d'indisponibilité d'un ou plusieurs serveurs d'arrière-plan en spécifiant quels serveurs 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 du même jeu de serveurs du répartiteur de charge. Un serveur est considéré comme indisponible s'il est en maintenance, arrêté ou en erreur. Les serveurs de standby à chaud sont utilisés 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 (avec leurs serveurs de standby et de remplacement à chaud respectifs) sont toujours sollicités dans l'ordre du plus bas lbset vers le plus haut.

Gestion du répartiteur de charge ¶

L'application balancer-manager fournie avec le mandataire inverse d'Apache httpd en est un des outils les plus utiles. Comme mod_status, balancer-manager affiche la configuration et l'activité actuelles des balancers actifs. L'affichage de ces informations n'est cependant pas sa seule fonction ; il permet aussi de modifier la plupart d'entre elles et même d'ajouter des membres au groupe de répartition de charge en temps réel. Pour activer ces fonctionnalités, vous devez ajouter les lignes suivantes à votre fichier de 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 à l'administrateur de modifier certains paramètres, de désactiver ou d'ajouter certains serveurs d'arrière-plan, et de modifier les règles de répartition de charge. Par exemple, si 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 d'arrière-plan ¶

Avant que le mandataire httpd ne fasse appel à un serveur d'arrière-plan, il peut "tester" si ce dernier 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 bande et de manière dynamique via le module mod_proxy_hcheck d'Apache httpd.

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 :