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 : 1774023 -->
   5 <!-- French translation : Lucien GENTIS -->
   6 <!-- $LastChangedRevision: 2017010701 $ -->
   7
   8 <!--
   9  Licensed to the Apache Software Foundation (ASF) under one or more
  10  contributor license agreements.  See the NOTICE file distributed with
  11  this work for additional information regarding copyright ownership.
  12  The ASF licenses this file to You under the Apache License, Version 2.0
  13  (the "License"); you may not use this file except in compliance with
  14  the License.  You may obtain a copy of the License at
  15
  16      http://www.apache.org/licenses/LICENSE-2.0
  17
  18  Unless required by applicable law or agreed to in writing, software
  19  distributed under the License is distributed on an "AS IS" BASIS,
  20  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  21  See the License for the specific language governing permissions and
  22  limitations under the License.
  23 -->
  24
  25 <modulesynopsis metafile="mod_proxy_express.xml.meta">
  26
  27 <name>mod_proxy_express</name>
  28 <description>Extension à <module>mod_proxy</module> pour le mandatement
  29 dynamique inverse de masse</description>
  30 <status>Extension</status>
  31 <sourcefile>mod_proxy_express.c</sourcefile>
  32 <identifier>proxy_express_module</identifier>
  33
  34 <summary>
  35     <p>Ce module crée dynamiquement en masse des mandataires inverses en
  36     faisant correspondre l'en-tête Host: 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
  59     dynamiques de <module>mod_proxy_balancer</module>. Par contre, il
  60     peut constituer une alternative légère et rapide à
  61     <module>mod_rewrite</module> lorsque ce dernier utilise la directive
  62     <directive>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
  86 <directivesynopsis>
  87 <name>ProxyExpressEnable</name>
  88 <description>Active la fonctionnalité du module.</description>
  89 <syntax>ProxyExpressEnable [on|off]</syntax>
  90 <default>off</default>
  91 <contextlist><context>server config</context><context>virtual host</context>
  92   </contextlist>
  93 <compatibility>Disponible à partir de la version 2.3.13 d'Apache</compatibility>
  94
  95 <usage>
  96   <p>La directive <directive>ProxyExpressEnable</directive> permet
  97   d'activer/désactiver le module.</p>
  98 </usage>
  99 </directivesynopsis>
 100
 101 <directivesynopsis>
 102 <name>ProxyExpressDBMFile</name>
 103 <description>Chemin du fichier DBM.</description>
 104 <syntax>ProxyExpressDBMFile &lt;chemin&gt;</syntax>
 105 <default>None</default>
 106 <contextlist><context>server config</context><context>virtual host</context>
 107   </contextlist>
 108 <compatibility>Disponible à partir de la version 2.3.13 d'Apache</compatibility>
 109
 110 <usage>
 111   <p>La directive <directive>ProxyExpressDBMFile</directive> permet de
 112   définir le chemin du fichier DBM de correspondance Express. Ce fichier
 113   permet de faire correspondre le nom de serveur extrait de l'en-tête
 114   Host: de la requête entrante avec une URL d'arrière-plan.</p>
 115
 116     <note><title>Note</title>
 117       <p>Ce fichier est élaboré à partir d'un fichier texte à l'aide de
 118       l'utilitaire <code><a
 119       href="../programs/httxt2dbm.html">httxt2dbm</a></code>.</p>
 120
 121       <example><title>Fichier de correspondances ProxyExpress</title>
 122         ##<br />
 123         ##express-map.txt:<br />
 124         ##<br />
 125         <br />
 126         www1.example.com    http://192.168.211.2:8080<br />
 127         www2.example.com   http://192.168.211.12:8088<br />
 128         www3.example.com   http://192.168.212.10<br />
 129       </example>
 130
 131       <example><title>Création du fichier DBM</title>
 132         httxt2dbm -i express-map.txt -o emap<br />
 133         </example>
 134
 135       <example><title>Configuration</title>
 136         ProxyExpressEnable on<br />
 137         ProxyExpressDBMFile emap<br />
 138         </example>
 139     </note>
 140 </usage>
 141 </directivesynopsis>
 142
 143 <directivesynopsis>
 144 <name>ProxyExpressDBMType</name>
 145 <description>Type de fichier DBM.</description>
 146 <syntax>ProxyExpressDBMFile &lt;type&gt;</syntax>
 147 <default>"default"</default>
 148 <contextlist><context>server config</context><context>virtual host</context>
 149   </contextlist>
 150 <compatibility>Disponible à partir de la version 2.3.13 d'Apache</compatibility>
 151
 152 <usage>
 153   <p>La directive <directive>ProxyExpressDBMType</directive> permet de
 154   définir le type de fichier DBM requis par le module. La valeur par
 155   défaut correspond au type DBM par défaut du fichier créé par
 156   l'utilitaire <code><a
 157   href="../programs/httxt2dbm.html">httxt2dbm</a></code>.</p>
 158   <p>Les valeurs possibles sont (mais toutes ne seront pas disponibles à
 159   l'exécution) :</p>
 160 <table border="1" style="zebra">
 161     <columnspec><column width=".3"/><column width=".7"/></columnspec>
 162
 163     <tr><th>Value</th><th>Description</th></tr>
 164     <tr><td><code>db</code></td><td>Fichiers Berkeley DB</td></tr>
 165     <tr><td><code>gdbm</code></td><td>Fichiers GDBM</td></tr>
 166     <tr><td><code>ndbm</code></td><td>Fichiers NDBM</td></tr>
 167     <tr><td><code>sdbm</code></td><td>Fichiers SDBM (toujours disponible)</td></tr>
 168     <tr><td><code>default</code></td><td>type DBM par défaut</td></tr>
 169     </table>
 170
 171 </usage>
 172 </directivesynopsis>
 173
 174 </modulesynopsis>