|
2 | 2 | <html lang="en"> |
3 | 3 | <head> |
4 | 4 | <meta charset="utf-8" /> |
5 | | - <title>HAProxy version 3.4-dev4-1 - Management Guide</title> |
| 5 | + <title>HAProxy version 3.4-dev4-19 - Management Guide</title> |
6 | 6 | <link href="https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/3.3.7/css/bootstrap.min.css" rel="stylesheet" /> |
7 | 7 | <link href="https://raw.githubusercontent.com/thomaspark/bootswatch/v3.3.7/cerulean/bootstrap.min.css" rel="stylesheet" /> |
8 | 8 | <link href="../css/page.css?0.4.2-15" rel="stylesheet" /> |
|
273 | 273 |
|
274 | 274 | <a class="list-group-item" href="#add acl">add acl</a> |
275 | 275 |
|
| 276 | + <a class="list-group-item" href="#add backend">add backend</a> |
| 277 | + |
276 | 278 | <a class="list-group-item" href="#add map">add map</a> |
277 | 279 |
|
278 | 280 | <a class="list-group-item" href="#add server">add server</a> |
|
688 | 690 | You can use <strong>left</strong> and <strong>right</strong> arrow keys to navigate between chapters.<br> |
689 | 691 | </p> |
690 | 692 | <p class="text-right"> |
691 | | - <small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2026/02/04</b></small> |
| 693 | + <small>Converted with <a href="https://github.com/cbonte/haproxy-dconv">haproxy-dconv</a> v<b>0.4.2-15</b> on <b>2026/02/06</b></small> |
692 | 694 | </p> |
693 | 695 | </div> |
694 | 696 | <!-- /.sidebar --> |
|
699 | 701 | <div class="text-center"> |
700 | 702 | <h1><a href="http://www.haproxy.org/" title="HAProxy"><img src="../img/HAProxyCommunityEdition_60px.png?0.4.2-15" /></a></h1> |
701 | 703 | <h2>Management Guide</h2> |
702 | | - <p><strong>version 3.4-dev4-1</strong></p> |
| 704 | + <p><strong>version 3.4-dev4-19</strong></p> |
703 | 705 | <p> |
704 | 706 | <br> |
705 | 707 |
|
@@ -2571,6 +2573,28 @@ <h2 id="chapter-9.3" data-target="9.3"><small><a class="small" href="#9.3">9.3.< |
2571 | 2573 | "show acl @<ver>" command, and cleared using a "clear acl @<ver>" command. |
2572 | 2574 | This command cannot be used if the reference <acl> is a name also used with |
2573 | 2575 | a map. In this case, the "<a href="#add%20map">add map</a>" command must be used instead. |
| 2576 | +</pre><a class="anchor" name="add"></a><a class="anchor" name="9-add"></a><a class="anchor" name="9.3-add"></a><a class="anchor" name="add (Statistics and monitoring)"></a><a class="anchor" name="add (Unix Socket commands)"></a><a class="anchor" name="add backend"></a><a class="anchor" name="9-add backend"></a><a class="anchor" name="9.3-add backend"></a><a class="anchor" name="add backend (Statistics and monitoring)"></a><a class="anchor" name="add backend (Unix Socket commands)"></a><div class="keyword"><b><a class="anchor" name="add backend"></a><a href="#9.3-add%20backend">add backend</a></b> <span style="color: #080"><name></span> from <span style="color: #080"><defproxy></span> <span style="color: #008">[mode <span style="color: #080"><mode></span>]</span> <span style="color: #008">[guid <span style="color: #080"><guid></span>]</span> <span style="color: #008">[ EXPERIMENTAL ]</span></div><pre class="text">Instantiate a new backend proxy with the name <name>. |
| 2577 | + |
| 2578 | +Only TCP or HTTP proxies can be created. All of the settings are inherited |
| 2579 | +from <defproxy> default proxy instance. By default, it is mandatory to |
| 2580 | +specify the backend mode via the argument of the same name, unless <defproxy> |
| 2581 | +already defines it explicitely. It is also possible to use an optional GUID |
| 2582 | +argument if wanted. |
| 2583 | + |
| 2584 | +Servers can be added via the command "<a href="#add%20server">add server</a>". The backend is initialized |
| 2585 | +in the unpublished state. Once considered ready for traffic, use "publish |
| 2586 | +backend" to expose the newly created instance. |
| 2587 | + |
| 2588 | +All named default proxies can be used, given that they validate the same |
| 2589 | +inheritance rules applied during configuration parsing. There is some |
| 2590 | +exceptions though, for example when the mode is neither TCP nor HTTP. Another |
| 2591 | +exception is that it is not yet possible to use a default proxies which |
| 2592 | +reference custom HTTP errors, for example via the errorfiles or http-rules |
| 2593 | +keywords. |
| 2594 | + |
| 2595 | +This command is restricted and can only be issued on sockets configured for |
| 2596 | +level "admin". Moreover, this feature is still considered in development so it |
| 2597 | +also requires experimental mode (see "experimental-mode on"). |
2574 | 2598 | </pre><a class="anchor" name="add"></a><a class="anchor" name="9-add"></a><a class="anchor" name="9.3-add"></a><a class="anchor" name="add (Statistics and monitoring)"></a><a class="anchor" name="add (Unix Socket commands)"></a><a class="anchor" name="add map"></a><a class="anchor" name="9-add map"></a><a class="anchor" name="9.3-add map"></a><a class="anchor" name="add map (Statistics and monitoring)"></a><a class="anchor" name="add map (Unix Socket commands)"></a><div class="keyword"><b><a class="anchor" name="add map"></a><a href="#9.3-add%20map">add map</a></b> <span style="color: #008">[@<span style="color: #080"><ver></span>]</span> <span style="color: #080"><map></span> <span style="color: #080"><key></span> <span style="color: #080"><value></span></div><a class="anchor" name="add"></a><a class="anchor" name="9-add"></a><a class="anchor" name="9.3-add"></a><a class="anchor" name="add (Statistics and monitoring)"></a><a class="anchor" name="add (Unix Socket commands)"></a><a class="anchor" name="add map"></a><a class="anchor" name="9-add map"></a><a class="anchor" name="9.3-add map"></a><a class="anchor" name="add map (Statistics and monitoring)"></a><a class="anchor" name="add map (Unix Socket commands)"></a><div class="keyword"><b><a class="anchor" name="add map"></a><a href="#9.3-add%20map">add map</a></b> <span style="color: #008">[@<span style="color: #080"><ver></span>]</span> <span style="color: #080"><map></span> <span style="color: #080"><payload></span></div><pre class="text">Add an entry into the map <map> to associate the value <value> to the key |
2575 | 2599 | <key>. This command does not verify if the entry already exists. It is |
2576 | 2600 | mainly used to fill a map after a "<a href="#clear">clear</a>" or "<a href="#prepare">prepare</a>" operation. Entries |
@@ -5785,7 +5809,7 @@ <h2 id="chapter-13.1" data-target="13.1"><small><a class="small" href="#13.1">13 |
5785 | 5809 | <br> |
5786 | 5810 | <hr> |
5787 | 5811 | <div class="text-right"> |
5788 | | - HAProxy 3.4-dev4-1 – Management Guide<br> |
| 5812 | + HAProxy 3.4-dev4-19 – Management Guide<br> |
5789 | 5813 | <small>, </small> |
5790 | 5814 | </div> |
5791 | 5815 | </div> |
|
0 commit comments