Loading docs/manual/mod/mod_proxy.xml.fr +2 −2 Changes for docs/manual/mod/mod_proxy.xml.fr: 2 added lines, 2 removed lines. Original line number Diff line number Diff line <?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: 1828926 --> <!-- English Revision: 1832294 --> <!-- French translation : Lucien GENTIS --> <!-- Reviewed by : Vincent Deffontaines --> Loading Loading @@ -1383,7 +1383,7 @@ ProxyPass "/mirror/foo/i" "!" répartiteur de charge. La route est une valeur ajoutée à l'identifiant de session. </td></tr> <tr><td>status</td> <tr><td><a name="status_table">status</a></td> <td>-</td> <td>Valeur constituée d'une simple lettre et définissant l'état initial de ce serveur cible. Loading docs/manual/mod/mod_proxy_hcheck.xml.fr +99 −98 Changes for docs/manual/mod/mod_proxy_hcheck.xml.fr: 99 added lines, 98 removed lines. Original line number Diff line number Diff line <?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: 1817908 --> <!-- English Revision: 1832294 --> <!-- French translation : Lucien GENTIS --> <!-- $LastChangedRevision: 2017062501 $ --> <!-- Loading @@ -26,87 +25,89 @@ <modulesynopsis metafile="mod_proxy_hcheck.xml.meta"> <name>mod_proxy_hcheck</name> <description>Check up dynamique des membres du groupe de répartition de charge (équipiers) pour <module>mod_proxy</module></description> <description>Check up dynamique des membres du groupe de répartition de charge (équipiers) pour <module>mod_proxy</module></description> <status>Extension</status> <sourcefile>mod_proxy_hcheck.c</sourcefile> <identifier>proxy_hcheck_module</identifier> <compatibility>Disponible à partir de la version 2.4.21 du serveur HTTP Apache</compatibility> <compatibility>Disponible à partir de la version 2.4.21 du serveur HTTP Apache</compatibility> <summary> <p>Ce module permet d'effectuer un check up dynamique des membres du groupe de répartition de charge (équipiers). Ce check up peut être activé pour un ou plusieurs équipiers et il est indépendant des requêtes de mandataire de répartition de charge (équipiers). Ce check up peut être activé pour un ou plusieurs équipiers et il est indépendant des requêtes de mandataire inverse proprement dites.</p> <p>Pour fonctionner, ce module <em>nécessite</em> le chargement préalable de <p>Pour fonctionner, ce module <em>nécessite</em> le chargement préalable de <module>mod_watchdog</module>.</p> <note><title>Paramètres</title> <p>Le mécanisme de check up est activé via l'utilisation de paramètres supplémentaires de BalancerMember configurés de manière standard via la directive <directive module="mod_proxy">ProxyPass</directive> :</p> <note><title>Paramètres</title> <p>Le mécanisme de check up est activé via l'utilisation de paramètres supplémentaires de la directive <directive module="mod_proxy">BalancerMember</directive> configurés de manière standard via la directive <directive module="mod_proxy">ProxyPass</directive> :</p> <p>Ce module définit un nouveau drapeau d'état pour BalancerMember : "<code>C</code>". Lorsque l'équipier est mis hors service suite à un disfonctionnement déterminé par le module de check up, ce drapeau est activé et peut être lu (et modifié) via le <code>balancer-manager</code>.</p> <p>Ce module définit un nouveau drapeau d'état <a href="mod_proxy.html#status_table">status</a> pour BalancerMember : "<code>C</code>". Lorsque l'équipier est mis hors service suite à un disfonctionnement déterminé par le module de check up, ce drapeau est activé et peut être lu (et modifié) via le <code>balancer-manager</code>.</p> <table> <tr><th>Paramètre</th> <th>Défaut</th> <tr><th>Paramètre</th> <th>Défaut</th> <th>Description</th></tr> <tr><td>hcmethod</td> <td>None</td> <td>Aucun check up dynamique n'est effectué. Les choix possibles sont : <td>Aucun check up dynamique n'est effectué. Les choix possibles sont : <table> <tr><th>Method</th><th>Description</th><th>Note</th></tr> <tr><td>None</td><td>Aucun check up dynamique effectué</td><td></td></tr> <tr><td>TCP</td><td>Vérifie qu'un socket vers le serveur d'arrière-plan peut être créé ; par exemple "es-tu en état de fonctionner"</td><td></td></tr> <tr><td>OPTIONS</td><td>Envoie une requête <code>HTTP OPTIONS</code> au serveur d'arrière-plan</td><td>*</td></tr> <tr><td>HEAD</td><td>Envoie une requête <code>HTTP HEAD</code> au serveur d'arrière-plan</td><td>*</td></tr> <tr><td>GET</td><td>Envoie une requête <code>HTTP GET</code> au serveur d'arrière-plan</td><td>*</td></tr> <tr><td>None</td><td>Aucun check up dynamique effectué</td><td></td></tr> <tr><td>TCP</td><td>Vérifie qu'un socket vers le serveur d'arrière-plan peut être créé ; par exemple "es-tu en état de fonctionner"</td><td></td></tr> <tr><td>OPTIONS</td><td>Envoie une requête <code>HTTP OPTIONS</code> au serveur d'arrière-plan</td><td>*</td></tr> <tr><td>HEAD</td><td>Envoie une requête <code>HTTP HEAD</code> au serveur d'arrière-plan</td><td>*</td></tr> <tr><td>GET</td><td>Envoie une requête <code>HTTP GET</code> au serveur d'arrière-plan</td><td>*</td></tr> <!-- <tr><td>CPING</td><td><strong>AJP only</strong> Do <code>CPING/CPONG</code> check</td><td></td></tr> <tr><td>PROVIDER</td><td>Name of <code>provider</code> to be used to check health</td><td></td></tr> --> <tr><td colspan="3"></td></tr> <tr><td colspan="3">*: si hcexpr n'est pas utilisé, un retour HTTP 2xx ou 3xx sera interprété comme un passage avec succès du check utilisé, un retour HTTP 2xx ou 3xx sera interprété comme un passage avec succès du check up.</td></tr> </table> </td></tr> <tr><td>hcpasses</td> <td>1</td> <td>Nombre de check up à passer avec succès avant de remettre en service l'équipier</td></tr> <td>Nombre de check up à passer avec succès avant de remettre en service l'équipier</td></tr> <tr><td>hcfails</td> <td>1</td> <td>Nombre de check up échoués avant mettre hors service l'équipier</td></tr> <td>Nombre de check up échoués avant mettre hors service l'équipier</td></tr> <tr><td>hcinterval</td> <td>30</td> <td>Intervalle entre deux check up en secondes (par défaut effectué <td>Intervalle entre deux check up en secondes (par défaut effectué toutes les 30 secondes). Utilise la syntaxe <a href="directive-dict.html#Syntax">time-interval</a>.</td></tr> <tr><td>hcuri</td> <td> </td> <td>URI supplémentaire à ajouter à l'URL de l'équipier pour le check up.</td></tr> <td>URI supplémentaire à ajouter à l'URL de l'équipier pour le check up.</td></tr> <tr><td>hctemplate</td> <td> </td> <td>Nom du modèle créé via <directive>ProxyHCTemplate</directive> à utiliser pour définir les paramètres de check up de cet équipier</td></tr> <td>Nom du modèle créé via <directive module="mod_proxy_hcheck">ProxyHCTemplate</directive> à utiliser pour définir les paramètres de check up de cet équipier</td></tr> <tr><td>hcexpr</td> <td> </td> <td>Nom de l'expression créée via <directive>ProxyHCExpr</directive> utilisée pour analyser les en-têtes de la réponse du check up.<br/> <em>Si ce paramètre est absent, un état HTTP de 2xx à 3xx est interprété comme un check up réussi.</em></td></tr> <td>Nom de l'expression créée via <directive module="mod_proxy_hcheck">ProxyHCExpr</directive> utilisée pour analyser les en-têtes de la réponse du check up.<br/> <em>Si ce paramètre est absent, un état HTTP de 2xx à 3xx est interprété comme un check up réussi.</em></td></tr> </table> </note> Loading @@ -116,8 +117,8 @@ <section id="examples"> <title>Exemples d'utilisation</title> <p>L'exemple suivant montre comment configurer le check up pour différents serveurs d'arrière-plan :</p> <p>L'exemple suivant montre comment configurer le check up pour différents serveurs d'arrière-plan :</p> <!-- This section should probably be extended with more, useful examples --> <highlight language="config"> Loading @@ -136,44 +137,44 @@ ProxyPass "/" "balancer://foo" ProxyPassReverse "/" "balancer://foo" </highlight> <p>Dans ce scénario, on teste l'équipier <code>http://www.example.com/</code> en lui envoyant une requête <code>GET /status.php</code> et en regardant si la réponse contient la chaîne <em>Under maintenance</em>. Si c'est le cas, le check up est considéré comme ayant échoué et l'équipier est mis hors service. Ce check up dynamique est effectué toutes les 30 secondes, ce qui correspond à la valeur par défaut.</p> <p>On teste l'équipier <code>http://www2.example.com/</code> en lui envoyant simplement une requête <code>HEAD</code> toutes les 10 secondes et en vérifiant que la réponse HTTP est bien un code d'état de 2xx, 3xx ou 4xx. On teste l'équipier <code>http://www3.example.com/</code> en vérifiant simplement toutes les 5 secondes que le socket vers ce serveur est bien opérationnel. Si ce serveur est marqué "hors service", il lui faudra 2 check up réussis pour être réactivé et participer à nouveau à la répartition de charge. Si à ce moment-là il échoue à 3 check up successifs, il sera à nouveau mis hors service. Enfin, l'équipier <code>http://www4.example.com/</code> ne fait l'objet d'aucun check <p>Dans ce scénario, on teste l'équipier <code>http://www.example.com/</code> en lui envoyant une requête <code>GET /status.php</code> et en regardant si la réponse contient la chaîne <em>Under maintenance</em>. Si c'est le cas, le check up est considéré comme ayant échoué et l'équipier est mis hors service. Ce check up dynamique est effectué toutes les 30 secondes, ce qui correspond à la valeur par défaut.</p> <p>On teste l'équipier <code>http://www2.example.com/</code> en lui envoyant simplement une requête <code>HEAD</code> toutes les 10 secondes et en vérifiant que la réponse HTTP est bien un code d'état de 2xx, 3xx ou 4xx. On teste l'équipier <code>http://www3.example.com/</code> en vérifiant simplement toutes les 5 secondes que le socket vers ce serveur est bien opérationnel. Si ce serveur est marqué "hors service", il lui faudra 2 check up réussis pour être réactivé et participer à nouveau à la répartition de charge. Si à ce moment-là il échoue à 3 check up successifs, il sera à nouveau mis hors service. Enfin, l'équipier <code>http://www4.example.com/</code> ne fait l'objet d'aucun check up.</p> </section> <directivesynopsis> <name>ProxyHCExpr</name> <description>Crée et nomme une expression conditionnelle à utiliser pour déterminer la santé d'un serveur d'arrière-plan en fonction de sa valeur.</description> <syntax>ProxyHCExpr name {ap_expr expression}</syntax> <description>Crée et nomme une expression conditionnelle à utiliser pour déterminer la santé d'un serveur d'arrière-plan en fonction de sa valeur</description> <syntax>ProxyHCExpr <em>name</em> {<em>ap_expr expression</em>}</syntax> <contextlist><context>server config</context><context>virtual host</context> </contextlist> <override>FileInfo</override> <usage> <p>La directive <directive>ProxyHCExpr</directive> permet de créer et nommer une expression conditionnelle dont la valeur calculée en fonction des en-têtes de la réponse du serveur d'arrière-plan permettra d'évaluer la santé de ce dernier. Cette expression nommée peut alors être assignée aux serveurs d'arrière-plan via le paramètre <code>hcexpr</code>.</p> <example><title>ProxyHCExpr: interprète les réponses 2xx/3xx/4xx comme des check up réussis</title> <p>La directive <directive>ProxyHCExpr</directive> permet de créer et nommer une expression conditionnelle dont la valeur calculée en fonction des en-têtes de la réponse du serveur d'arrière-plan permettra d'évaluer la santé de ce dernier. Cette expression nommée peut alors être assignée aux serveurs d'arrière-plan via le paramètre <code>hcexpr</code>.</p> <example><title>ProxyHCExpr: interprète les réponses 2xx/3xx/4xx comme des check up réussis</title> <highlight language="config"> ProxyHCExpr ok234 {%{REQUEST_STATUS} =~ /^[234]/} ProxyPass "/apps" "balancer://foo" Loading @@ -186,19 +187,19 @@ ProxyPass "/apps" "balancer://foo" <note> L'<a href="../expr.html">expression</a> peut utiliser des accolades ("{}") comme délimiteurs en plus des guillemets normaux. comme délimiteurs en plus des guillemets normaux. </note> <p>Si l'on utilise une méthode de check up (par exemple <code>GET</code>) qui génère un corps de réponse, ce corps peut lui-même être ausculté via <code>ap_expr</code> en utilisant la fonction associée aux expressions <code>hc()</code> spécifique à ce module.</p> <p>Si l'on utilise une méthode de check up (par exemple <code>GET</code>) qui génère un corps de réponse, ce corps peut lui-même être ausculté via <code>ap_expr</code> en utilisant la fonction associée aux expressions <code>hc()</code> spécifique à ce module.</p> <p>Dans l'exemple suivant, on envoie une requête <code>GET</code> au serveur d'arrière-plan, et si le corps de la réponse contient la chaîne <em>Under maintenance</em>, ce serveur d'arrière-plan est mis hors service.</p> <p>Dans l'exemple suivant, on envoie une requête <code>GET</code> au serveur d'arrière-plan, et si le corps de la réponse contient la chaîne <em>Under maintenance</em>, ce serveur d'arrière-plan est mis hors service.</p> <example><title>ProxyHCExpr: auscultation du corps de la réponse</title> <example><title>ProxyHCExpr: auscultation du corps de la réponse</title> <highlight language="config"> ProxyHCExpr in_maint {hc('body') !~ /Under maintenance/} ProxyPass "/apps" "balancer://foo" Loading @@ -209,25 +210,25 @@ ProxyPass "/apps" "balancer://foo" </highlight> </example> <p><em>NOTE:</em> Comme le corps de la réponse peut être assez grand, il est recommandé de privilégier un check up basé sur les codes d'état.</p> <p><em>NOTE:</em> Comme le corps de la réponse peut être assez grand, il est recommandé de privilégier un check up basé sur les codes d'état.</p> </usage> </directivesynopsis> <directivesynopsis> <name>ProxyHCTemplate</name> <description>Crée et nomme un modèle permettant de définir différents paramètres de check up</description> <syntax>ProxyHCTemplate name parameter=setting <...></syntax> <description>Crée et nomme un modèle permettant de définir différents paramètres de check up</description> <syntax>ProxyHCTemplate <em>name</em> <em>parameter</em>=<em>setting</em> [...]</syntax> <contextlist><context>server config</context><context>virtual host</context> </contextlist> <override>FileInfo</override> <usage> <p>La directive <directive>ProxyHCTemplate</directive> permet de créer et nommer un modèle de paramètres de check up qui peut alors être assigné aux équipiers via le paramètre <code>hctemplate</code></p> <p>La directive <directive>ProxyHCTemplate</directive> permet de créer et nommer un modèle de paramètres de check up qui peut alors être assigné aux équipiers via le paramètre <code>hctemplate</code>.</p> <example><title>ProxyHCTemplate</title> <highlight language="config"> Loading @@ -245,21 +246,21 @@ ProxyPass "/apps" "balancer://foo" <directivesynopsis> <name>ProxyHCTPsize</name> <description>Définit la taille totale, pour l'ensemble du serveur, du jeu de threads utilisé pour le check up des équipiers.</description> <syntax>ProxyHCTPsize <size></syntax> <description>Définit la taille totale, pour l'ensemble du serveur, du jeu de threads utilisé pour le check up des équipiers</description> <syntax>ProxyHCTPsize <em>size</em></syntax> <contextlist><context>server config</context> </contextlist> <usage> <p>Si Apache httpd et APR ont été compilés avec le support des threads, le module de check up peut confier ce travail à un jeu de threads associé au processus Watchdog, ce qui permet l'exécution des check up en parallèle. La directive <directive>ProxyHCTPsize</directive> permet de déterminer la <p>Si Apache httpd et APR ont été compilés avec le support des threads, le module de check up peut confier ce travail à un jeu de threads associé au processus Watchdog, ce qui permet l'exécution des check up en parallèle. La directive <directive>ProxyHCTPsize</directive> permet de déterminer la taille de ce jeu de threads. Une valeur de <code>0</code> signifie qu'aucun jeu de threads ne sera utilisé, et le check up des différents équipiers sera alors effectué séquentiellement. La taille par défaut du jeu de threads est jeu de threads ne sera utilisé, et le check up des différents équipiers sera alors effectué séquentiellement. La taille par défaut du jeu de threads est de 16.</p> <example><title>ProxyHCTPsize</title> Loading Loading
docs/manual/mod/mod_proxy.xml.fr +2 −2 Changes for docs/manual/mod/mod_proxy.xml.fr: 2 added lines, 2 removed lines. Original line number Diff line number Diff line <?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: 1828926 --> <!-- English Revision: 1832294 --> <!-- French translation : Lucien GENTIS --> <!-- Reviewed by : Vincent Deffontaines --> Loading Loading @@ -1383,7 +1383,7 @@ ProxyPass "/mirror/foo/i" "!" répartiteur de charge. La route est une valeur ajoutée à l'identifiant de session. </td></tr> <tr><td>status</td> <tr><td><a name="status_table">status</a></td> <td>-</td> <td>Valeur constituée d'une simple lettre et définissant l'état initial de ce serveur cible. Loading
docs/manual/mod/mod_proxy_hcheck.xml.fr +99 −98 Changes for docs/manual/mod/mod_proxy_hcheck.xml.fr: 99 added lines, 98 removed lines. Original line number Diff line number Diff line <?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: 1817908 --> <!-- English Revision: 1832294 --> <!-- French translation : Lucien GENTIS --> <!-- $LastChangedRevision: 2017062501 $ --> <!-- Loading @@ -26,87 +25,89 @@ <modulesynopsis metafile="mod_proxy_hcheck.xml.meta"> <name>mod_proxy_hcheck</name> <description>Check up dynamique des membres du groupe de répartition de charge (équipiers) pour <module>mod_proxy</module></description> <description>Check up dynamique des membres du groupe de répartition de charge (équipiers) pour <module>mod_proxy</module></description> <status>Extension</status> <sourcefile>mod_proxy_hcheck.c</sourcefile> <identifier>proxy_hcheck_module</identifier> <compatibility>Disponible à partir de la version 2.4.21 du serveur HTTP Apache</compatibility> <compatibility>Disponible à partir de la version 2.4.21 du serveur HTTP Apache</compatibility> <summary> <p>Ce module permet d'effectuer un check up dynamique des membres du groupe de répartition de charge (équipiers). Ce check up peut être activé pour un ou plusieurs équipiers et il est indépendant des requêtes de mandataire de répartition de charge (équipiers). Ce check up peut être activé pour un ou plusieurs équipiers et il est indépendant des requêtes de mandataire inverse proprement dites.</p> <p>Pour fonctionner, ce module <em>nécessite</em> le chargement préalable de <p>Pour fonctionner, ce module <em>nécessite</em> le chargement préalable de <module>mod_watchdog</module>.</p> <note><title>Paramètres</title> <p>Le mécanisme de check up est activé via l'utilisation de paramètres supplémentaires de BalancerMember configurés de manière standard via la directive <directive module="mod_proxy">ProxyPass</directive> :</p> <note><title>Paramètres</title> <p>Le mécanisme de check up est activé via l'utilisation de paramètres supplémentaires de la directive <directive module="mod_proxy">BalancerMember</directive> configurés de manière standard via la directive <directive module="mod_proxy">ProxyPass</directive> :</p> <p>Ce module définit un nouveau drapeau d'état pour BalancerMember : "<code>C</code>". Lorsque l'équipier est mis hors service suite à un disfonctionnement déterminé par le module de check up, ce drapeau est activé et peut être lu (et modifié) via le <code>balancer-manager</code>.</p> <p>Ce module définit un nouveau drapeau d'état <a href="mod_proxy.html#status_table">status</a> pour BalancerMember : "<code>C</code>". Lorsque l'équipier est mis hors service suite à un disfonctionnement déterminé par le module de check up, ce drapeau est activé et peut être lu (et modifié) via le <code>balancer-manager</code>.</p> <table> <tr><th>Paramètre</th> <th>Défaut</th> <tr><th>Paramètre</th> <th>Défaut</th> <th>Description</th></tr> <tr><td>hcmethod</td> <td>None</td> <td>Aucun check up dynamique n'est effectué. Les choix possibles sont : <td>Aucun check up dynamique n'est effectué. Les choix possibles sont : <table> <tr><th>Method</th><th>Description</th><th>Note</th></tr> <tr><td>None</td><td>Aucun check up dynamique effectué</td><td></td></tr> <tr><td>TCP</td><td>Vérifie qu'un socket vers le serveur d'arrière-plan peut être créé ; par exemple "es-tu en état de fonctionner"</td><td></td></tr> <tr><td>OPTIONS</td><td>Envoie une requête <code>HTTP OPTIONS</code> au serveur d'arrière-plan</td><td>*</td></tr> <tr><td>HEAD</td><td>Envoie une requête <code>HTTP HEAD</code> au serveur d'arrière-plan</td><td>*</td></tr> <tr><td>GET</td><td>Envoie une requête <code>HTTP GET</code> au serveur d'arrière-plan</td><td>*</td></tr> <tr><td>None</td><td>Aucun check up dynamique effectué</td><td></td></tr> <tr><td>TCP</td><td>Vérifie qu'un socket vers le serveur d'arrière-plan peut être créé ; par exemple "es-tu en état de fonctionner"</td><td></td></tr> <tr><td>OPTIONS</td><td>Envoie une requête <code>HTTP OPTIONS</code> au serveur d'arrière-plan</td><td>*</td></tr> <tr><td>HEAD</td><td>Envoie une requête <code>HTTP HEAD</code> au serveur d'arrière-plan</td><td>*</td></tr> <tr><td>GET</td><td>Envoie une requête <code>HTTP GET</code> au serveur d'arrière-plan</td><td>*</td></tr> <!-- <tr><td>CPING</td><td><strong>AJP only</strong> Do <code>CPING/CPONG</code> check</td><td></td></tr> <tr><td>PROVIDER</td><td>Name of <code>provider</code> to be used to check health</td><td></td></tr> --> <tr><td colspan="3"></td></tr> <tr><td colspan="3">*: si hcexpr n'est pas utilisé, un retour HTTP 2xx ou 3xx sera interprété comme un passage avec succès du check utilisé, un retour HTTP 2xx ou 3xx sera interprété comme un passage avec succès du check up.</td></tr> </table> </td></tr> <tr><td>hcpasses</td> <td>1</td> <td>Nombre de check up à passer avec succès avant de remettre en service l'équipier</td></tr> <td>Nombre de check up à passer avec succès avant de remettre en service l'équipier</td></tr> <tr><td>hcfails</td> <td>1</td> <td>Nombre de check up échoués avant mettre hors service l'équipier</td></tr> <td>Nombre de check up échoués avant mettre hors service l'équipier</td></tr> <tr><td>hcinterval</td> <td>30</td> <td>Intervalle entre deux check up en secondes (par défaut effectué <td>Intervalle entre deux check up en secondes (par défaut effectué toutes les 30 secondes). Utilise la syntaxe <a href="directive-dict.html#Syntax">time-interval</a>.</td></tr> <tr><td>hcuri</td> <td> </td> <td>URI supplémentaire à ajouter à l'URL de l'équipier pour le check up.</td></tr> <td>URI supplémentaire à ajouter à l'URL de l'équipier pour le check up.</td></tr> <tr><td>hctemplate</td> <td> </td> <td>Nom du modèle créé via <directive>ProxyHCTemplate</directive> à utiliser pour définir les paramètres de check up de cet équipier</td></tr> <td>Nom du modèle créé via <directive module="mod_proxy_hcheck">ProxyHCTemplate</directive> à utiliser pour définir les paramètres de check up de cet équipier</td></tr> <tr><td>hcexpr</td> <td> </td> <td>Nom de l'expression créée via <directive>ProxyHCExpr</directive> utilisée pour analyser les en-têtes de la réponse du check up.<br/> <em>Si ce paramètre est absent, un état HTTP de 2xx à 3xx est interprété comme un check up réussi.</em></td></tr> <td>Nom de l'expression créée via <directive module="mod_proxy_hcheck">ProxyHCExpr</directive> utilisée pour analyser les en-têtes de la réponse du check up.<br/> <em>Si ce paramètre est absent, un état HTTP de 2xx à 3xx est interprété comme un check up réussi.</em></td></tr> </table> </note> Loading @@ -116,8 +117,8 @@ <section id="examples"> <title>Exemples d'utilisation</title> <p>L'exemple suivant montre comment configurer le check up pour différents serveurs d'arrière-plan :</p> <p>L'exemple suivant montre comment configurer le check up pour différents serveurs d'arrière-plan :</p> <!-- This section should probably be extended with more, useful examples --> <highlight language="config"> Loading @@ -136,44 +137,44 @@ ProxyPass "/" "balancer://foo" ProxyPassReverse "/" "balancer://foo" </highlight> <p>Dans ce scénario, on teste l'équipier <code>http://www.example.com/</code> en lui envoyant une requête <code>GET /status.php</code> et en regardant si la réponse contient la chaîne <em>Under maintenance</em>. Si c'est le cas, le check up est considéré comme ayant échoué et l'équipier est mis hors service. Ce check up dynamique est effectué toutes les 30 secondes, ce qui correspond à la valeur par défaut.</p> <p>On teste l'équipier <code>http://www2.example.com/</code> en lui envoyant simplement une requête <code>HEAD</code> toutes les 10 secondes et en vérifiant que la réponse HTTP est bien un code d'état de 2xx, 3xx ou 4xx. On teste l'équipier <code>http://www3.example.com/</code> en vérifiant simplement toutes les 5 secondes que le socket vers ce serveur est bien opérationnel. Si ce serveur est marqué "hors service", il lui faudra 2 check up réussis pour être réactivé et participer à nouveau à la répartition de charge. Si à ce moment-là il échoue à 3 check up successifs, il sera à nouveau mis hors service. Enfin, l'équipier <code>http://www4.example.com/</code> ne fait l'objet d'aucun check <p>Dans ce scénario, on teste l'équipier <code>http://www.example.com/</code> en lui envoyant une requête <code>GET /status.php</code> et en regardant si la réponse contient la chaîne <em>Under maintenance</em>. Si c'est le cas, le check up est considéré comme ayant échoué et l'équipier est mis hors service. Ce check up dynamique est effectué toutes les 30 secondes, ce qui correspond à la valeur par défaut.</p> <p>On teste l'équipier <code>http://www2.example.com/</code> en lui envoyant simplement une requête <code>HEAD</code> toutes les 10 secondes et en vérifiant que la réponse HTTP est bien un code d'état de 2xx, 3xx ou 4xx. On teste l'équipier <code>http://www3.example.com/</code> en vérifiant simplement toutes les 5 secondes que le socket vers ce serveur est bien opérationnel. Si ce serveur est marqué "hors service", il lui faudra 2 check up réussis pour être réactivé et participer à nouveau à la répartition de charge. Si à ce moment-là il échoue à 3 check up successifs, il sera à nouveau mis hors service. Enfin, l'équipier <code>http://www4.example.com/</code> ne fait l'objet d'aucun check up.</p> </section> <directivesynopsis> <name>ProxyHCExpr</name> <description>Crée et nomme une expression conditionnelle à utiliser pour déterminer la santé d'un serveur d'arrière-plan en fonction de sa valeur.</description> <syntax>ProxyHCExpr name {ap_expr expression}</syntax> <description>Crée et nomme une expression conditionnelle à utiliser pour déterminer la santé d'un serveur d'arrière-plan en fonction de sa valeur</description> <syntax>ProxyHCExpr <em>name</em> {<em>ap_expr expression</em>}</syntax> <contextlist><context>server config</context><context>virtual host</context> </contextlist> <override>FileInfo</override> <usage> <p>La directive <directive>ProxyHCExpr</directive> permet de créer et nommer une expression conditionnelle dont la valeur calculée en fonction des en-têtes de la réponse du serveur d'arrière-plan permettra d'évaluer la santé de ce dernier. Cette expression nommée peut alors être assignée aux serveurs d'arrière-plan via le paramètre <code>hcexpr</code>.</p> <example><title>ProxyHCExpr: interprète les réponses 2xx/3xx/4xx comme des check up réussis</title> <p>La directive <directive>ProxyHCExpr</directive> permet de créer et nommer une expression conditionnelle dont la valeur calculée en fonction des en-têtes de la réponse du serveur d'arrière-plan permettra d'évaluer la santé de ce dernier. Cette expression nommée peut alors être assignée aux serveurs d'arrière-plan via le paramètre <code>hcexpr</code>.</p> <example><title>ProxyHCExpr: interprète les réponses 2xx/3xx/4xx comme des check up réussis</title> <highlight language="config"> ProxyHCExpr ok234 {%{REQUEST_STATUS} =~ /^[234]/} ProxyPass "/apps" "balancer://foo" Loading @@ -186,19 +187,19 @@ ProxyPass "/apps" "balancer://foo" <note> L'<a href="../expr.html">expression</a> peut utiliser des accolades ("{}") comme délimiteurs en plus des guillemets normaux. comme délimiteurs en plus des guillemets normaux. </note> <p>Si l'on utilise une méthode de check up (par exemple <code>GET</code>) qui génère un corps de réponse, ce corps peut lui-même être ausculté via <code>ap_expr</code> en utilisant la fonction associée aux expressions <code>hc()</code> spécifique à ce module.</p> <p>Si l'on utilise une méthode de check up (par exemple <code>GET</code>) qui génère un corps de réponse, ce corps peut lui-même être ausculté via <code>ap_expr</code> en utilisant la fonction associée aux expressions <code>hc()</code> spécifique à ce module.</p> <p>Dans l'exemple suivant, on envoie une requête <code>GET</code> au serveur d'arrière-plan, et si le corps de la réponse contient la chaîne <em>Under maintenance</em>, ce serveur d'arrière-plan est mis hors service.</p> <p>Dans l'exemple suivant, on envoie une requête <code>GET</code> au serveur d'arrière-plan, et si le corps de la réponse contient la chaîne <em>Under maintenance</em>, ce serveur d'arrière-plan est mis hors service.</p> <example><title>ProxyHCExpr: auscultation du corps de la réponse</title> <example><title>ProxyHCExpr: auscultation du corps de la réponse</title> <highlight language="config"> ProxyHCExpr in_maint {hc('body') !~ /Under maintenance/} ProxyPass "/apps" "balancer://foo" Loading @@ -209,25 +210,25 @@ ProxyPass "/apps" "balancer://foo" </highlight> </example> <p><em>NOTE:</em> Comme le corps de la réponse peut être assez grand, il est recommandé de privilégier un check up basé sur les codes d'état.</p> <p><em>NOTE:</em> Comme le corps de la réponse peut être assez grand, il est recommandé de privilégier un check up basé sur les codes d'état.</p> </usage> </directivesynopsis> <directivesynopsis> <name>ProxyHCTemplate</name> <description>Crée et nomme un modèle permettant de définir différents paramètres de check up</description> <syntax>ProxyHCTemplate name parameter=setting <...></syntax> <description>Crée et nomme un modèle permettant de définir différents paramètres de check up</description> <syntax>ProxyHCTemplate <em>name</em> <em>parameter</em>=<em>setting</em> [...]</syntax> <contextlist><context>server config</context><context>virtual host</context> </contextlist> <override>FileInfo</override> <usage> <p>La directive <directive>ProxyHCTemplate</directive> permet de créer et nommer un modèle de paramètres de check up qui peut alors être assigné aux équipiers via le paramètre <code>hctemplate</code></p> <p>La directive <directive>ProxyHCTemplate</directive> permet de créer et nommer un modèle de paramètres de check up qui peut alors être assigné aux équipiers via le paramètre <code>hctemplate</code>.</p> <example><title>ProxyHCTemplate</title> <highlight language="config"> Loading @@ -245,21 +246,21 @@ ProxyPass "/apps" "balancer://foo" <directivesynopsis> <name>ProxyHCTPsize</name> <description>Définit la taille totale, pour l'ensemble du serveur, du jeu de threads utilisé pour le check up des équipiers.</description> <syntax>ProxyHCTPsize <size></syntax> <description>Définit la taille totale, pour l'ensemble du serveur, du jeu de threads utilisé pour le check up des équipiers</description> <syntax>ProxyHCTPsize <em>size</em></syntax> <contextlist><context>server config</context> </contextlist> <usage> <p>Si Apache httpd et APR ont été compilés avec le support des threads, le module de check up peut confier ce travail à un jeu de threads associé au processus Watchdog, ce qui permet l'exécution des check up en parallèle. La directive <directive>ProxyHCTPsize</directive> permet de déterminer la <p>Si Apache httpd et APR ont été compilés avec le support des threads, le module de check up peut confier ce travail à un jeu de threads associé au processus Watchdog, ce qui permet l'exécution des check up en parallèle. La directive <directive>ProxyHCTPsize</directive> permet de déterminer la taille de ce jeu de threads. Une valeur de <code>0</code> signifie qu'aucun jeu de threads ne sera utilisé, et le check up des différents équipiers sera alors effectué séquentiellement. La taille par défaut du jeu de threads est jeu de threads ne sera utilisé, et le check up des différents équipiers sera alors effectué séquentiellement. La taille par défaut du jeu de threads est de 16.</p> <example><title>ProxyHCTPsize</title> Loading
