granicus.if.org Git - apache/blob - docs/manual/mod/mod_proxy_express.xml.fr

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
   3 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
   4 <!-- English Revision: 1852270 -->
   5 <!-- French translation : Lucien GENTIS -->
   6
   7 <!--
   8  Licensed to the Apache Software Foundation (ASF) under one or more
   9  contributor license agreements.  See the NOTICE file distributed with
  10  this work for additional information regarding copyright ownership.
  11  The ASF licenses this file to You under the Apache License, Version 2.0
  12  (the "License"); you may not use this file except in compliance with
  13  the License.  You may obtain a copy of the License at
  14
  15      http://www.apache.org/licenses/LICENSE-2.0
  16
  17  Unless required by applicable law or agreed to in writing, software
  18  distributed under the License is distributed on an "AS IS" BASIS,
  19  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  20  See the License for the specific language governing permissions and
  21  limitations under the License.
  22 -->
  23
  24 <modulesynopsis metafile="mod_proxy_express.xml.meta">
  25
  26 <name>mod_proxy_express</name>
  27 <description>Extension à <module>mod_proxy</module> pour le mandatement
  28 dynamique inverse de masse</description>
  29 <status>Extension</status>
  30 <sourcefile>mod_proxy_express.c</sourcefile>
  31 <identifier>proxy_express_module</identifier>
  32 <compatibility>Disponible à partir de la version 2.3.13 du serveur HTTP Apache</compatibility>
  33
  34 <summary>
  35     <p>Ce module crée dynamiquement en masse des mandataires inverses en
  36     faisant correspondre l'en-tête <code>Host:</code> de la requête HTTP à un nom de
  37     serveur et une URL d'arrière-plan stockés dans un fichier DBM. Il
  38     est ainsi plus aisé d'utiliser un grand nombre de
  39     mandataires inverses sans avoir à modifier la configuration. Il est
  40     loin de posséder autant de fonctionnalités que
  41     <module>mod_proxy_balancer</module> qui propose aussi la croissance
  42     dynamique, mais il est conçu pour gérer un nombre beaucoup plus important
  43     de serveurs d'arrière-plan. Il convient parfaitement pour créer un
  44     commutateur HTTP frontal et pour les architectures Microservices.</p>
  45
  46     <p>Pour pouvoir être utilisé, ce module nécessite le chargement de
  47     <module>mod_proxy</module>.</p>
  48
  49     <note type="warning"><title>Avertissement</title>
  50       <p>N'activez le mandatement que si vous avez <a
  51       href="mod_proxy.html#access">sécurisé votre serveur</a>. Les
  52       serveurs mandataires ouverts sont dangereux pour votre réseau, et
  53       dans une plus large mesure pour Internet.</p>
  54     </note>
  55
  56 <note><title>Limitations</title>
  57   <ul>
  58     <li>Ce module n'est pas conçu pour remplacer les fonctionnalités dynamiques
  59     de <module>mod_proxy_balancer</module>. Par contre, il peut constituer une
  60     alternative légère et rapide à <module>mod_rewrite</module> lorsque ce
  61     dernier utilise la directive <directive
  62     module="mod_rewrite">RewriteMap</directive> et le drapeau <code>[P]</code>
  63     pour le mandatement inverse à partir d'une table de correspondances.
  64     </li>
  65     <li>Il ne supporte pas les mises en correspondance basées sur les
  66     expressions rationnelles ou les modèles.
  67     </li>
  68     <li>Il émule :
  69       <highlight language="config">
  70 &lt;VirtualHost *:80&gt;
  71    ServerName front.end.server
  72    ProxyPass "/" "back.end.server:port"
  73    ProxyPassReverse "/" "back.end.server:port"
  74 &lt;/VirtualHost&gt;
  75       </highlight>
  76       En d'autres termes, l'URL dans son ensemble est ajoutée à l'URL
  77       d'arrière-plan correspondante, tout ceci dans le but de
  78       proposer un commutateur mandataire inverse simple mais rapide.
  79     </li>
  80   </ul>
  81 </note>
  82
  83 </summary>
  84 <seealso><module>mod_proxy</module></seealso>
  85 <seealso><directive module="mod_proxy">BalancerMember</directive></seealso>
  86 <seealso><directive module="mod_proxy">BalancerGrowth</directive></seealso>
  87 <seealso><directive module="mod_proxy">BalancerPersist</directive></seealso>
  88 <seealso><directive module="mod_proxy">BalancerInherit</directive></seealso>
  89
  90 <directivesynopsis>
  91 <name>ProxyExpressEnable</name>
  92 <description>Active la fonctionnalité du module.</description>
  93 <syntax>ProxyExpressEnable on|off</syntax>
  94 <default>ProxyExpressEnable off</default>
  95 <contextlist><context>server config</context><context>virtual host</context>
  96   </contextlist>
  97 <override>FileInfo</override>
  98
  99 <usage>
 100   <p>La directive <directive>ProxyExpressEnable</directive> permet
 101   d'activer/désactiver le module.</p>
 102 </usage>
 103 </directivesynopsis>
 104
 105 <directivesynopsis>
 106 <name>ProxyExpressDBMFile</name>
 107 <description>Chemin du fichier DBM.</description>
 108 <syntax>ProxyExpressDBMFile <var>pathname</var></syntax>
 109 <contextlist><context>server config</context><context>virtual host</context>
 110   </contextlist>
 111 <override>FileInfo</override>
 112
 113 <usage>
 114   <p>La directive <directive>ProxyExpressDBMFile</directive> permet de
 115   définir le chemin du fichier DBM de correspondance Express. Ce fichier
 116   permet de faire correspondre le nom de serveur extrait de l'en-tête
 117   <code>Host:</code> de la requête entrante avec une URL d'arrière-plan.</p>
 118
 119     <note><title>Note</title>
 120       <p>Ce fichier est élaboré à partir d'un fichier texte à l'aide de
 121       l'utilitaire <code><a
 122       href="../programs/httxt2dbm.html">httxt2dbm</a></code>.</p>
 123
 124       <example><title>Fichier de correspondances ProxyExpress</title>
 125         ##<br />
 126         ##express-map.txt:<br />
 127         ##<br />
 128         <br />
 129         www1.example.com   http://192.168.211.2:8080<br />
 130         www2.example.com   http://192.168.211.12:8088<br />
 131         www3.example.com   http://192.168.212.10<br />
 132       </example>
 133
 134       <example><title>Création du fichier DBM</title>
 135         httxt2dbm -i express-map.txt -o emap<br />
 136       </example>
 137
 138       <example><title>Configuration</title>
 139       <highlight language="config">
 140 ProxyExpressEnable on
 141 ProxyExpressDBMFile emap
 142       </highlight>
 143       </example>
 144     </note>
 145 </usage>
 146 </directivesynopsis>
 147
 148 <directivesynopsis>
 149 <name>ProxyExpressDBMType</name>
 150 <description>Type de fichier DBM.</description>
 151 <syntax>ProxyExpressDBMType <var>type</var></syntax>
 152 <default>ProxyExpressDBMType default</default>
 153 <contextlist><context>server config</context><context>virtual host</context>
 154   </contextlist>
 155 <override>FileInfo</override>
 156
 157 <usage>
 158   <p>La directive <directive>ProxyExpressDBMType</directive> permet de
 159   définir le type de fichier DBM requis par le module. La valeur par
 160   défaut correspond au type DBM par défaut du fichier créé par
 161   l'utilitaire <code><a
 162   href="../programs/httxt2dbm.html">httxt2dbm</a></code>.</p>
 163   <p>Les valeurs possibles sont (mais toutes ne seront pas disponibles à
 164   l'exécution) :</p>
 165 <table border="1" style="zebra">
 166     <columnspec><column width=".3"/><column width=".7"/></columnspec>
 167
 168     <tr><th>Value</th><th>Description</th></tr>
 169     <tr><td><code>db</code></td><td>Fichiers Berkeley DB</td></tr>
 170     <tr><td><code>gdbm</code></td><td>Fichiers GDBM</td></tr>
 171     <tr><td><code>ndbm</code></td><td>Fichiers NDBM</td></tr>
 172     <tr><td><code>sdbm</code></td><td>Fichiers SDBM (toujours disponible)</td></tr>
 173     <tr><td><code>default</code></td><td>type DBM par défaut</td></tr>
 174     </table>
 175
 176 </usage>
 177 </directivesynopsis>
 178
 179 </modulesynopsis>