From: Lucien Gentis Date: Sun, 27 May 2018 12:20:10 +0000 (+0000) Subject: XML updates. X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=13bf8982022ec84f49421451b56b0fde79e5e6c0;p=apache XML updates. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1832332 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/mod/mod_proxy.xml.fr b/docs/manual/mod/mod_proxy.xml.fr index 62ccfe0cd5..e8e24333d9 100644 --- a/docs/manual/mod/mod_proxy.xml.fr +++ b/docs/manual/mod/mod_proxy.xml.fr @@ -1,7 +1,7 @@ - + @@ -1383,7 +1383,7 @@ ProxyPass "/mirror/foo/i" "!" répartiteur de charge. La route est une valeur ajoutée à l'identifiant de session. - status + status - Valeur constituée d'une simple lettre et définissant l'état initial de ce serveur cible. diff --git a/docs/manual/mod/mod_proxy_hcheck.xml.fr b/docs/manual/mod/mod_proxy_hcheck.xml.fr index 27ebe78f68..7d5d677f88 100644 --- a/docs/manual/mod/mod_proxy_hcheck.xml.fr +++ b/docs/manual/mod/mod_proxy_hcheck.xml.fr @@ -1,9 +1,8 @@ - + - *: 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. hcpasses 1 - Nombre de check up à passer avec succès avant de remettre en service - l'équipier + Nombre de check up à passer avec succès avant de remettre en service + l'équipier hcfails 1 - Nombre de check up échoués avant mettre hors service l'équipier + Nombre de check up échoués avant mettre hors service l'équipier hcinterval 30 - Intervalle entre deux check up en secondes (par défaut effectué + Intervalle entre deux check up en secondes (par défaut effectué toutes les 30 secondes). Utilise la syntaxe time-interval. hcuri   - URI supplémentaire à ajouter à l'URL de l'équipier pour le check up. + URI supplémentaire à ajouter à l'URL de l'équipier pour le check up. hctemplate   - Nom du modèle créé via ProxyHCTemplate à - utiliser pour définir les paramètres de check up de cet équipier + Nom du modèle créé via ProxyHCTemplate à + utiliser pour définir les paramètres de check up de cet équipier hcexpr   - Nom de l'expression créée via ProxyHCExpr - utilisée pour analyser les en-têtes de la réponse du check up.
- Si ce paramètre est absent, un état HTTP de 2xx à 3xx est - interprété comme un check up réussi. + Nom de l'expression créée via ProxyHCExpr + utilisée pour analyser les en-têtes de la réponse du check up.
+ Si ce paramètre est absent, un état HTTP de 2xx à 3xx est + interprété comme un check up réussi. @@ -116,8 +117,8 @@
Exemples d'utilisation -

L'exemple suivant montre comment configurer le check up pour différents - serveurs d'arrière-plan :

+

L'exemple suivant montre comment configurer le check up pour différents + serveurs d'arrière-plan :

@@ -127,7 +128,7 @@ ProxyHCExpr in_maint {hc('body') !~ /Under maintenance/} <Proxy balancer://foo> BalancerMember http://www.example.com/ hcmethod=GET hcexpr=in_maint hcuri=/status.php - BalancerMember http://www2.example.com/ hcmethod=HEAD hcexpr=ok234 hcinterval=10 + BalancerMember http://www2.example.com/ hcmethod=HEAD hcexpr=ok234 hcinterval=10 BalancerMember http://www3.example.com/ hcmethod=TCP hcinterval=5 hcpasses=2 hcfails=3 BalancerMember http://www4.example.com/ </Proxy> @@ -136,44 +137,44 @@ ProxyPass "/" "balancer://foo" ProxyPassReverse "/" "balancer://foo" -

Dans ce scénario, on teste l'équipier http://www.example.com/ en lui -envoyant une requête GET /status.php et en regardant si la réponse -contient la chaîne Under maintenance. 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.

- -

On teste l'équipier http://www2.example.com/ en lui envoyant -simplement une requête HEAD 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 http://www3.example.com/ 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 http://www4.example.com/ ne fait l'objet d'aucun check +

Dans ce scénario, on teste l'équipier http://www.example.com/ en lui +envoyant une requête GET /status.php et en regardant si la réponse +contient la chaîne Under maintenance. 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.

+ +

On teste l'équipier http://www2.example.com/ en lui envoyant +simplement une requête HEAD 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 http://www3.example.com/ 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 http://www4.example.com/ ne fait l'objet d'aucun check up.

ProxyHCExpr -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. -ProxyHCExpr name {ap_expr expression} +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 +ProxyHCExpr name {ap_expr expression} server configvirtual host FileInfo -

La directive ProxyHCExpr 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 hcexpr.

- - ProxyHCExpr: interprète les réponses 2xx/3xx/4xx comme des - check up réussis +

La directive ProxyHCExpr 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 hcexpr.

+ + ProxyHCExpr: interprète les réponses 2xx/3xx/4xx comme des + check up réussis ProxyHCExpr ok234 {%{REQUEST_STATUS} =~ /^[234]/} ProxyPass "/apps" "balancer://foo" @@ -186,19 +187,19 @@ ProxyPass "/apps" "balancer://foo" L'expression peut utiliser des accolades ("{}") - comme délimiteurs en plus des guillemets normaux. + comme délimiteurs en plus des guillemets normaux. -

Si l'on utilise une méthode de check up (par exemple GET) - qui génère un corps de réponse, ce corps peut lui-même être ausculté via - ap_expr en utilisant la fonction associée aux expressions - hc() spécifique à ce module.

+

Si l'on utilise une méthode de check up (par exemple GET) + qui génère un corps de réponse, ce corps peut lui-même être ausculté via + ap_expr en utilisant la fonction associée aux expressions + hc() spécifique à ce module.

-

Dans l'exemple suivant, on envoie une requête GET au serveur - d'arrière-plan, et si le corps de la réponse contient la chaîne Under - maintenance, ce serveur d'arrière-plan est mis hors service.

+

Dans l'exemple suivant, on envoie une requête GET au serveur + d'arrière-plan, et si le corps de la réponse contient la chaîne Under + maintenance, ce serveur d'arrière-plan est mis hors service.

- ProxyHCExpr: auscultation du corps de la réponse + ProxyHCExpr: auscultation du corps de la réponse ProxyHCExpr in_maint {hc('body') !~ /Under maintenance/} ProxyPass "/apps" "balancer://foo" @@ -209,25 +210,25 @@ ProxyPass "/apps" "balancer://foo" -

NOTE: 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.

+

NOTE: 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.

 ProxyHCTemplate -Crée et nomme un modèle permettant de définir différents -paramètres de check up -ProxyHCTemplate name parameter=setting <...> +Crée et nomme un modèle permettant de définir différents +paramètres de check up +ProxyHCTemplate name parameter=setting [...] server configvirtual host FileInfo -

La directive ProxyHCTemplate 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 hctemplate

+

La directive ProxyHCTemplate 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 hctemplate.

ProxyHCTemplate @@ -245,21 +246,21 @@ ProxyPass "/apps" "balancer://foo" ProxyHCTPsize -Définit la taille totale, pour l'ensemble du -serveur, du jeu de threads utilisé pour le check up des -équipiers. -ProxyHCTPsize <size> +Définit la taille totale, pour l'ensemble du +serveur, du jeu de threads utilisé pour le check up des +équipiers +ProxyHCTPsize size server config -

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 ProxyHCTPsize permet de déterminer la +

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 ProxyHCTPsize permet de déterminer la taille de ce jeu de threads. Une valeur de 0 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.

ProxyHCTPsize