You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: documentation/README.md
+3-17Lines changed: 3 additions & 17 deletions
Original file line number
Diff line number
Diff line change
@@ -630,15 +630,14 @@ backend-config-snippet: |
630
630
631
631
#### Cookie Persistence
632
632
633
-
- Configure sticky session via cookie-based persistence.
634
-
635
633
##### `cookie-persistence`
636
634
637
-
Enables persistent connections between a client and a pod by inserting a cookie into the client's browser that is used to remember which backend pod they connected to before.
635
+
Enables persistent connections (sticky sessions) between a client and a pod by inserting a cookie into the client's browser that is used to remember which backend pod they connected to before.
636
+
Dynamic cookies are used by default via a [dynamic-cookie-key](https://cbonte.github.io/haproxy-dconv/2.4/configuration.html#4.2-dynamic-cookie-key) in order to support sticky sessions across multiple Ingress Controller instances/replicas.
638
637
639
638
Available on: `configmap``ingress``service`
640
639
641
-
:information_source: This will insert the following cookie configuration in the corresponding backend `cookie <cookie-name> insert indirect nocache` with `<cookie-name>` the value of this annotation.
640
+
:information_source: This will insert the following cookie configuration in the corresponding backend `cookie <cookie-name> insert indirect nocache dynamic` with `<cookie-name>` the value of this annotation.
642
641
643
642
Possible values:
644
643
@@ -650,19 +649,6 @@ Example:
650
649
cookie-persistence: "mycookie"
651
650
```
652
651
653
-
Configuring the cookie can be done in two different ways:
654
-
- Using `cookie-persistence` annotation.
655
-
However, currently, this **does not work** when deploying more than one ingress controller pod. For such case (multiple IC pods) the following `dynamic` cookie configuration via `backend-config-snippet` annotation an be used.
656
-
- Using [`backend-config-snippet`](#config-snippet) annotation for more cookie options.
657
-
658
-
```yaml
659
-
backend-config-snippet: |
660
-
dynamic-cookie-key ahgh5kiM
661
-
cookie SRV insert indirect nocache dynamic
662
-
```
663
-
664
-
More information can be found in the official HAProxy [documentation](https://cbonte.github.io/haproxy-dconv/2.0/configuration.html#4-cookie)
665
-
666
652
<p align='right'><a href='#available-annotations'>:arrow_up_small: back to top</a></p>
Copy file name to clipboardExpand all lines: documentation/doc.yaml
+3-21Lines changed: 3 additions & 21 deletions
Original file line number
Diff line number
Diff line change
@@ -388,22 +388,6 @@ groups:
388
388
- Insert raw HAProxy configuration in specific HAProxy config sections.
389
389
- There is **no data validation** done by Ingress Controller. If input is incorrect, HAProxy will fail to apply new configuration.
390
390
- It is possible to use [pattern files](controller.md/#--configmap-patternfiles) inside config snippets.
391
-
cookie-persistence:
392
-
header: |-
393
-
- Configure sticky session via cookie-based persistence.
394
-
footer: |-
395
-
Configuring the cookie can be done in two different ways:
396
-
- Using `cookie-persistence` annotation.
397
-
However, currently, this **does not work** when deploying more than one ingress controller pod. For such case (multiple IC pods) the following `dynamic` cookie configuration via `backend-config-snippet` annotation an be used.
398
-
- Using [`backend-config-snippet`](#config-snippet) annotation for more cookie options.
399
-
400
-
```yaml
401
-
backend-config-snippet: |
402
-
dynamic-cookie-key ahgh5kiM
403
-
cookie SRV insert indirect nocache dynamic
404
-
```
405
-
406
-
More information can be found in the official HAProxy [documentation](https://cbonte.github.io/haproxy-dconv/2.0/configuration.html#4-cookie)
407
391
CORS:
408
392
header: |-
409
393
- *Cross-Origin Resource Sharing (CORS) is an HTTP-header based mechanism that allows a server to indicate any other origins (domain, scheme, or port) than its own from which a browser should permit loading of resources.* - [Mozilla Docs](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS)
@@ -814,15 +798,13 @@ annotations:
814
798
stick on req.cook(sessionid)
815
799
- title: cookie-persistence
816
800
type: string
817
-
group: cookie-persistence
818
-
dependencies: ""
819
-
default: ""
820
801
description:
821
-
- Enables persistent connections between a client and a pod by inserting a cookie
802
+
- Enables persistent connections (sticky sessions) between a client and a pod by inserting a cookie
822
803
into the client's browser that is used to remember which backend pod they connected
823
804
to before.
805
+
- Dynamic cookies are used by default via a [dynamic-cookie-key](https://cbonte.github.io/haproxy-dconv/2.4/configuration.html#4.2-dynamic-cookie-key) in order to support sticky sessions across multiple Ingress Controller instances/replicas.
824
806
tip:
825
-
- This will insert the following cookie configuration in the corresponding backend `cookie <cookie-name> insert indirect nocache` with `<cookie-name>` the value of this annotation.
807
+
- This will insert the following cookie configuration in the corresponding backend `cookie <cookie-name> insert indirect nocache dynamic` with `<cookie-name>` the value of this annotation.
0 commit comments