mirror of
https://github.com/apache/httpd.git
synced 2025-11-03 17:53:20 +03:00
ae6b0541d5
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1780462 13f79535-47bb-0310-9956-ffa450edef68
361 lines
17 KiB
Plaintext
361 lines
17 KiB
Plaintext
<?xml version="1.0" encoding="UTF-8" ?>
|
|
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
|
|
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
|
|
<!-- English Revision: 1731532 -->
|
|
<!-- French translation : Lucien GENTIS -->
|
|
<!-- Reviewed by : Vincent Deffontaines -->
|
|
|
|
<!--
|
|
Licensed to the Apache Software Foundation (ASF) under one or more
|
|
contributor license agreements. See the NOTICE file distributed with
|
|
this work for additional information regarding copyright ownership.
|
|
The ASF licenses this file to You under the Apache License, Version 2.0
|
|
(the "License"); you may not use this file except in compliance with
|
|
the License. You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
-->
|
|
|
|
<modulesynopsis metafile="mod_proxy_balancer.xml.meta">
|
|
|
|
<name>mod_proxy_balancer</name>
|
|
<description>Extension de <module>mod_proxy</module> pour le support de
|
|
la répartition de charge</description>
|
|
<status>Extension</status>
|
|
<sourcefile>mod_proxy_balancer.c</sourcefile>
|
|
<identifier>proxy_balancer_module</identifier>
|
|
|
|
<summary>
|
|
<p>Pour pouvoir fonctionner, ce module <em>requiert</em> le
|
|
chargement de <module>mod_proxy</module>, et il fournit le support de
|
|
la répartition de charge pour tous les protocoles supportés. Parmi ces
|
|
protocoles, les plus importants sont :</p>
|
|
<ul>
|
|
<li>HTTP, avec le module <module>mod_proxy_http</module></li>
|
|
<li>FTP, avec le module <module>mod_proxy_ftp</module></li>
|
|
<li>AJP13, avec le module <module>mod_proxy_ajp</module></li>
|
|
<li>WebSocket, avec le module <module>mod_proxy_wstunnel</module></li>
|
|
</ul>
|
|
|
|
|
|
<p>L'algorithme de planification de la répartition de charge n'est pas
|
|
fourni par ce module, mais par ceux-ci :</p>
|
|
<ul>
|
|
<li><module>mod_lbmethod_byrequests</module></li>
|
|
<li><module>mod_lbmethod_bytraffic</module></li>
|
|
<li><module>mod_lbmethod_bybusyness</module></li>
|
|
<li><module>mod_lbmethod_heartbeat</module></li>
|
|
</ul>
|
|
|
|
<p>Ainsi, pour mettre en oeuvre la répartition de charge,
|
|
<module>mod_proxy</module>, <module>mod_proxy_balancer</module> et
|
|
au moins un des modules fournissant l'algorithme de planification de
|
|
la répartition de charge doivent être chargés dans le serveur.</p>
|
|
|
|
<note type="warning"><title>Avertissement</title>
|
|
<p>N'activez pas la fonctionnalité de mandataire avant d'avoir <a
|
|
href="mod_proxy.html#access">sécurisé votre serveur</a>. Les
|
|
serveurs mandataires ouverts sont dangereux non seulement pour
|
|
votre réseau, mais aussi pour l'Internet au sens large.</p>
|
|
</note>
|
|
</summary>
|
|
<seealso><module>mod_proxy</module></seealso>
|
|
|
|
<section id="scheduler">
|
|
<title>L'algorithme de planification de la répartition de
|
|
charge</title>
|
|
<p>A l'heure actuelle, 3 algorithmes de planification de la
|
|
répartition de charge sont disponibles : ils se basent
|
|
respectivement sur le comptage des requêtes, la mesure du trafic et
|
|
le comptage des requêtes en attente. Ils sont contrôlés par la
|
|
valeur de <code>lbmethod</code> dans la définition du répartiteur.
|
|
Voir la directive <directive
|
|
module="mod_proxy">ProxyPass</directive> pour plus de détails, et en
|
|
particulier la configuration du répartiteur et de ses membres.</p>
|
|
</section>
|
|
|
|
<section id="stickyness">
|
|
<title>Répartition de charge avec abonnement utilisateur
|
|
(stickyness)</title>
|
|
<p>Le répartiteur supporte l'abonnement utilisateur. Lorsqu'une
|
|
requête est mandatée vers un serveur d'arrière-plan particulier,
|
|
toutes les requêtes suivantes du même utilisateur seront alors
|
|
mandatées vers le même serveur d'arrière-plan. De nombreux
|
|
répartiteurs de charge implémentent cette fonctionnalité via une
|
|
table qui associe les adresses IP des clients aux serveurs
|
|
d'arrière-plan. Cette approche est transparente aux clients et aux
|
|
serveurs d'arrière-plan, mais induit certains problèmes :
|
|
distribution de charge inégale si les clients se trouvent eux-mêmes
|
|
derrière un mandataire, erreurs d'abonnement lorsqu'un client
|
|
possède une adresse IP dynamique qui peut changer au cours d'une
|
|
session et perte d'abonnement en cas de dépassement de la table de
|
|
correspondances.</p>
|
|
<p>Le module <module>mod_proxy_balancer</module> implémente
|
|
l'abonnement selon deux alternatives : les cookies et le codage
|
|
d'URL. Le cookie peut être fourni par le serveur d'arrière-plan ou
|
|
par le serveur web Apache lui-même, alors que le codage d'URL est en
|
|
général effectué par le serveur d'arrière-plan.</p>
|
|
|
|
</section>
|
|
|
|
<section id="example">
|
|
<title>Exemples de configuration d'un répartiteur</title>
|
|
<p>Avant de nous plonger dans les détails techniques, voici un
|
|
exemple d'utilisation de <module>mod_proxy_balancer</module> mettant
|
|
en oeuvre la répartition de charge entre deux serveurs
|
|
d'arrière-plan :
|
|
</p>
|
|
|
|
<highlight language="config">
|
|
<Proxy balancer://mycluster>
|
|
BalancerMember http://192.168.1.50:80
|
|
BalancerMember http://192.168.1.51:80
|
|
</Proxy>
|
|
ProxyPass "/test" "balancer://mycluster"
|
|
ProxyPassReverse "/test" "balancer://mycluster"
|
|
</highlight>
|
|
|
|
|
|
<p>Voici un autre exemple de répartiteur de charge avec
|
|
abonnement utilisant <module>mod_headers</module>,
|
|
fonctionnant même si le serveur d'arrière-plan ne définit pas de
|
|
cookie de session approprié :
|
|
</p>
|
|
|
|
<highlight language="config">
|
|
Header add Set-Cookie "ROUTEID=.%{BALANCER_WORKER_ROUTE}e; path=/" env=BALANCER_ROUTE_CHANGED
|
|
<Proxy balancer://mycluster>
|
|
BalancerMember http://192.168.1.50:80 route=1
|
|
BalancerMember http://192.168.1.51:80 route=2
|
|
ProxySet stickysession=ROUTEID
|
|
</Proxy>
|
|
ProxyPass "/test" "balancer://mycluster"
|
|
ProxyPassReverse "/test" "balancer://mycluster"
|
|
</highlight>
|
|
|
|
</section>
|
|
|
|
<section id="environment">
|
|
<title>Variables d'environnement exportées</title>
|
|
<p>A l'heure actuelle, 6 variables d'environnement sont exportées :</p>
|
|
|
|
<dl>
|
|
<!-- ============= BALANCER_SESSION_STICKY =============== -->
|
|
<dt><var><a name="balancer_session_sticky" id="balancer_session_sticky">BALANCER_SESSION_STICKY</a></var></dt>
|
|
<dd>
|
|
<p>Cette variable se voir assignée la valeur de
|
|
<var>stickysession</var> pour la requête courante. Il s'agit du
|
|
nom du cookie ou du paramètre de requête utilisé pour les sessions
|
|
avec abonnement.</p>
|
|
</dd>
|
|
|
|
<!-- ============= BALANCER_SESSION_ROUTE ================ -->
|
|
<dt><var><a name="balancer_session_route" id="balancer_session_route">BALANCER_SESSION_ROUTE</a></var></dt>
|
|
<dd>
|
|
<p>Cette variable se voit assignée la <var>route</var> interprétée
|
|
pour la requête courante.</p>
|
|
</dd>
|
|
|
|
<!-- ============= BALANCER_NAME ========================= -->
|
|
<dt><var><a name="balancer_name" id="balancer_name">BALANCER_NAME</a></var></dt>
|
|
<dd>
|
|
<p>Cette variable se voit assigné le nom du répartiteur pour la
|
|
requête courante. Il s'agit d'une valeur du style
|
|
<code>balancer://foo</code>.</p>
|
|
</dd>
|
|
|
|
<!-- ============= BALANCER_WORKER_NAME ================== -->
|
|
<dt><var><a name="balancer_worker_name" id="balancer_worker_name">BALANCER_WORKER_NAME</a></var></dt>
|
|
<dd>
|
|
<p>Cette variable se voit assigné le nom du membre du groupe de
|
|
répartition de charge utilisé pour la requête courante. Il s'agit
|
|
d'une valeur du style <code>http://hostA:1234</code>.</p>
|
|
</dd>
|
|
|
|
<!-- ============= BALANCER_WORKER_ROUTE ================= -->
|
|
<dt><var><a name="balancer_worker_route" id="balancer_worker_route">BALANCER_WORKER_ROUTE</a></var></dt>
|
|
<dd>
|
|
<p>Cette variable se voit assignée la <var>route</var> du membre du
|
|
groupe de répartition de charge qui sera utilisé pour la requête
|
|
courante.</p>
|
|
</dd>
|
|
|
|
<!-- ============= BALANCER_ROUTE_CHANGED ================= -->
|
|
<dt><var><a name="balancer_route_changed" id="balancer_route_changed">BALANCER_ROUTE_CHANGED</a></var></dt>
|
|
<dd>
|
|
<p>Cette variable est définie à 1 si la route de la session ne
|
|
correspond pas à celle du membre du groupe de répartition de charge
|
|
(BALANCER_SESSION_ROUTE != BALANCER_WORKER_ROUTE), ou si la session
|
|
ne possède pas encore de route établie. Elle peut servir à
|
|
déterminer quand il est éventuellement nécessaire d'envoyer au
|
|
client une route mise à jour lorsque les sessions persistantes sont
|
|
utilisées.</p>
|
|
</dd>
|
|
</dl>
|
|
|
|
</section>
|
|
|
|
<section id="balancer_manager">
|
|
<title>Activation du support du gestionnaire de répartiteur</title>
|
|
<p>Cette fonctionnalité <em>nécessite</em> le chargement du module
|
|
<module>mod_status</module>. Le gestionnaire de répartiteur permet
|
|
la mise à jour dynamique des membres du groupe de répartition de
|
|
charge. Vous pouvez utiliser le gestionnaire de répartiteur pour
|
|
modifier le facteur de charge d'un membre particulier, ou passer ce
|
|
dernier en mode hors ligne.
|
|
</p>
|
|
|
|
<p>Ainsi, pour mettre en oeuvre la gestion du répartiteur de charge,
|
|
<module>mod_status</module> et <module>mod_proxy_balancer</module>
|
|
doivent être chargés dans le serveur.</p>
|
|
|
|
<p>Pour permettre la gestion du répartiteur de charge aux
|
|
navigateurs appartenant au domaine example.com, ajoutez ces lignes à
|
|
votre fichier de configuration <code>httpd.conf</code> :</p>
|
|
<highlight language="config">
|
|
<Location "/balancer-manager">
|
|
SetHandler balancer-manager
|
|
Require host example.com
|
|
</Location>
|
|
</highlight>
|
|
|
|
<p>Vous pourrez alors accéder au gestionnaire du répartiteur de
|
|
charge en utilisant un navigateur web pour afficher la page
|
|
<code>http://nom.de.votre.serveur/balancer-manager</code>. Notez que
|
|
pour pouvoir contrôler dynamiquement un membre de groupe de
|
|
répartition, ce dernier ne doit pas être défini au sein d'une
|
|
section <code><Location ...></code>.</p>
|
|
</section>
|
|
|
|
<section id="stickyness_implementation">
|
|
<title>Détails à propos de la répartition de charge par abonnement
|
|
(stickyness)</title>
|
|
<p>Si l'abonnement s'appuie sur un cookie, vous devez définir le nom
|
|
de ce cookie dont le contenu précise le serveur d'arrière-plan à
|
|
utiliser. Pour ce faire, on utilise l'attribut
|
|
<var>stickysession</var> avec la directive <directive
|
|
module="mod_proxy">ProxyPass</directive> ou <directive
|
|
module="mod_proxy">ProxySet</directive>. Le nom du cookie est
|
|
sensible à la casse. Le répartiteur extrait le contenu du cookie et
|
|
recherche un serveur membre dont la <var>route</var> correspond à
|
|
cette valeur. La route doit aussi être définie dans la directive <directive
|
|
module="mod_proxy">ProxyPass</directive> ou <directive
|
|
module="mod_proxy">ProxySet</directive>. Le cookie peut être défini
|
|
soit par le serveur d'arrière-plan, soit, comme indiqué dans l'<a
|
|
href="#example">exemple</a> ci-dessus par le serveur web Apache
|
|
lui-même.</p>
|
|
<p>Certains serveurs d'arrière-plan, tels qu'Apache Tomcat,
|
|
utilisent une forme sensiblement différente de cookie d'abonnement.
|
|
Tomcat ajoute le nom de l'instance Tomcat à la fin de son
|
|
identifiant de session, précédé par un point. Ainsi, si le serveur
|
|
web Apache trouve un point dans la valeur du cookie d'abonnement, il
|
|
n'utilisera que la partie située après ce point pour
|
|
rechercher sa route. Pour que Tomcat puisse connaître son nom
|
|
d'instance, vous devez définir l'attribut <code>jvmRoute</code> dans
|
|
son fichier de configuration <code>conf/server.xml</code> à la
|
|
valeur de la <var>route</var> du serveur qui se connecte au Tomcat
|
|
considéré. Le nom du cookie de session utilisé par Tomcat (et plus
|
|
généralement par les applications web Java à base de servlets) est
|
|
<code>JSESSIONID</code> (en majuscules), mais peut être modifié.</p>
|
|
|
|
<p>La seconde méthode pour implémenter l'abonnement est le codage
|
|
d'URL. Ici, le serveur web recherche un paramètre dans l'URL de la
|
|
requête. Le nom du paramètre est spécifié par l'attribut
|
|
<var>stickysession</var>. Pour trouver un serveur membre, on
|
|
recherche un serveur dont la <var>route</var> est égale à la valeur
|
|
du paramètre. Comme il n'est pas aisé d'extraire et de manipuler
|
|
tous les liens URL contenus dans les réponses, le travail consistant
|
|
à ajouter les paramètres à chaque lien est généralement effectué par
|
|
le serveur d'arrière-plan qui génère le contenu. Bien qu'il soit
|
|
possible dans certains cas d'effectuer ces ajouts au niveau du
|
|
serveur web via les modules <module>mod_substitute</module> ou
|
|
<module>mod_sed</module>, cette méthode peut dégrader les
|
|
performances.</p>
|
|
|
|
<p>Les standards Java implémentent le codage d'URL de manière
|
|
sensiblement différente. Ils ajoutent une information de chemin à
|
|
l'URL en utilisant un point-virgule (<code>;</code>) comme
|
|
séparateur, puis ajoutent enfin l'identifiant de session. Comme dans
|
|
le cas des cookies, Apache Tomcat peut insérer la valeur de
|
|
l'attribut <code>jvmRoute</code> dans cette information de chemin.
|
|
Pour qu'Apache puisse trouver ce genre d'information de chemin, vous
|
|
devez définir <code>scolonpathdelim</code> à <code>On</code> dans la
|
|
directive <directive module="mod_proxy">ProxyPass</directive> ou
|
|
<directive module="mod_proxy">ProxySet</directive>.</p>
|
|
|
|
<p>Enfin, vous pouvez utiliser simultanément les cookies et le codage
|
|
d'URL en définissant le nom du cookie et le nom du paramètre d'URL
|
|
séparés par une barre verticale (<code>|</code>) comme dans
|
|
l'exemple suivant :</p>
|
|
<highlight language="config">
|
|
ProxyPass "/test" "balancer://mycluster" stickysession=JSESSIONID|jsessionid scolonpathdelim=On
|
|
<Proxy balancer://mycluster>
|
|
BalancerMember http://192.168.1.50:80 route=node1
|
|
BalancerMember http://192.168.1.51:80 route=node2
|
|
</Proxy>
|
|
</highlight>
|
|
<p>Si le cookie et le paramètre de requête fournissent tous deux une
|
|
information de route correcte pour la même requête, c'est
|
|
l'information en provenance du paramètre de requête qui sera
|
|
retenue.</p>
|
|
</section>
|
|
|
|
<section id="stickyness_troubleshooting">
|
|
<title>Résolution des problèmes liés à la répartition de charge par
|
|
abonnement</title>
|
|
<p>Si vous êtes confronté à des erreurs d'abonnement, comme la
|
|
nécessité pour les utilisateurs de se reconnecter suite à une perte
|
|
de session d'application, vous devez tout d'abord vérifier si ceci
|
|
n'est pas du à une indisponibilité sporadique des serveurs
|
|
d'arrière-plan ou à une erreur de configuration. La présence de
|
|
messages d'erreur de type proxy dans le journal des erreurs d'Apache
|
|
pourra révéler des problèmes de stabilité au niveau des serveurs
|
|
d'arrière-plan.</p>
|
|
<p>Pour contrôler votre configuration, regardez tout d'abord si
|
|
l'abonnement est à base de cookie ou de codage d'URL. L'étape
|
|
suivante consiste à enregistrer certaines données dans le journal
|
|
des accès en utilisant un <directive module="mod_log_config">format
|
|
de journalisation</directive> personnalisé. Les champs intéressants
|
|
sont les suivants :</p>
|
|
<dl>
|
|
<dt><code>%{MONCOOKIE}C</code></dt>
|
|
<dd>La valeur que contient le cookie de nom <code>MONCOOKIE</code>.
|
|
Le nom doit correspondre au nom défini par l'attribut
|
|
<var>stickysession</var>.</dd>
|
|
<dt><code>%{Set-Cookie}o</code></dt>
|
|
<dd>Ce champ contient tout cookie défini par le serveur
|
|
d'arrière-plan. Vous pouvez ainsi vérifier si le serveur
|
|
d'arrière-plan définit bien le cookie de session auquel vous vous
|
|
attendez, et à quelle valeur il est défini.</dd>
|
|
<dt><code>%{BALANCER_SESSION_STICKY}e</code></dt>
|
|
<dd>Le nom du cookie ou du paramètre de requête utilisé pour la
|
|
recherche de l'information de routage.</dd>
|
|
<dt><code>%{BALANCER_SESSION_ROUTE}e</code></dt>
|
|
<dd>L'information de routage extraite de la requête.</dd>
|
|
<dt><code>%{BALANCER_WORKER_ROUTE}e</code></dt>
|
|
<dd>La route du serveur choisi.</dd>
|
|
<dt><code>%{BALANCER_ROUTE_CHANGED}e</code></dt>
|
|
<dd>Contient la valeur <code>1</code> si la route extraite de la
|
|
requête est différente de la route du serveur ; autrement dit, le
|
|
traitement de la requête n'a pas pu être effectué dans le cadre
|
|
d'une répartition de charge par abonnement.</dd>
|
|
</dl>
|
|
<p>Les pertes de session sont souvent dues à des expirations de
|
|
session dont la valeur peut en général être configurée au niveau du
|
|
serveur d'arrière-plan.</p>
|
|
<p>Si le niveau de journalisation est défini à <code>debug</code> ou
|
|
plus, le répartiteur journalise aussi des informations détaillées à
|
|
propos de l'abonnement dans le journal des erreurs, ce qui facilite
|
|
la résolution des problèmes d'abonnement. Notez cependant que le
|
|
volume de journalisation pourra alors s'avérer trop important pour
|
|
un serveur en production sous forte charge.</p>
|
|
</section>
|
|
|
|
</modulesynopsis>
|