DOC/MEDIUM: add http-connection-mode and deprecate http-server-close and http-keep-alive

Author: fabianonunes

documentation/annotations.md

@@ -38,6 +38,7 @@ This is autogenerated from [doc.yaml](doc.yaml). Description can be found in [ge
 | [src-ip-header](#src-ip-header) | string | "null" |  |:large_blue_circle:|:large_blue_circle:|:white_circle:|
 | [forwarded-for](#x-forwarded-for) | [bool](#bool) | "true" |  |:large_blue_circle:|:large_blue_circle:|:large_blue_circle:|
 | [hard-stop-after](#hard-stop-after) | [time](#time) | "1h" |  |:large_blue_circle:|:white_circle:|:white_circle:|
+| [http-connection-mode](#http-options) | string | "http-keep-alive" |  |:large_blue_circle:|:white_circle:|:white_circle:|
 | [http-keep-alive](#http-options) | [bool](#bool) | "true" |  |:large_blue_circle:|:white_circle:|:white_circle:|
 | [http-server-close](#http-options) | [bool](#bool) | "false" |  |:large_blue_circle:|:white_circle:|:white_circle:|
 | [ingress.class](#ingress-class) | string |  |  |:white_circle:|:large_blue_circle:|:white_circle:|
@@ -682,8 +683,27 @@ hard-stop-after: 30s
 
 #### Http Options
 
+##### `http-connection-mode`
+
+  Sets HAProxy connection mode
+
+  Available on:  `configmap`
+
+Possible values:
+
+- http-keep-alive `default` - Enables HTTP Keep-Alive both from the client to HAProxy and from HAProxy to the backend.
+- http-server-close - Disables HTTP Keep-Alive between HAProxy and the backend, while allowing it to stay enabled from the client to HAProxy.
+- httpclose - HAProxy will close connections with the server and the client as soon as the request and the response are received
+
+Example:
+
+```yaml
+http-connection-mode: "http-server-close"
+```
+
 ##### `http-keep-alive`
 
+  **Deprecated**, use `http-connection-mode` instead.
   Enables HTTP Keep-Alive both from the client to HAProxy and from HAProxy to the backend.
 
   Available on:  `configmap`
@@ -701,6 +721,7 @@ http-keep-alive: "true"
 
 ##### `http-server-close`
 
+  **Deprecated**, use `http-connection-mode` instead.
   Disables HTTP Keep-Alive between HAProxy and the backend, while allowing it to stay enabled from the client to HAProxy.
 
   Available on:  `configmap`

documentation/doc.yaml

@@ -929,12 +929,31 @@ annotations:
       - configmap
     version_min: "1.4"
     example: ["hard-stop-after: 30s"]
+  - title: http-connection-mode
+    type: string
+    group: http-options
+    dependencies: ""
+    default: http-keep-alive
+    description:
+      - Sets HAProxy connection mode
+    values:
+      - http-keep-alive `default` - Enables HTTP Keep-Alive both from the client to HAProxy and
+        from HAProxy to the backend.
+      - http-server-close - Disables HTTP Keep-Alive between HAProxy and the backend,
+        while allowing it to stay enabled from the client to HAProxy.
+      - httpclose - HAProxy will close connections with the server and the client as
+        soon as the request and the response are received
+    applies_to:
+      - configmap
+    version_min: "1.8"
+    example: ['http-connection-mode: "http-server-close"']
   - title: http-keep-alive
     type: bool
     group: http-options
     dependencies: ""
     default: "true"
     description:
+      - '**Deprecated**, use `http-connection-mode` instead.'
       - Enables HTTP Keep-Alive both from the client to HAProxy and from HAProxy to the
         backend.
     tip: []
@@ -951,6 +970,7 @@ annotations:
     dependencies: ""
     default: "false"
     description:
+      - '**Deprecated**, use `http-connection-mode` instead.'
       - Disables HTTP Keep-Alive between HAProxy and the backend, while allowing it to
         stay enabled from the client to HAProxy.
     tip: []