From 6ddc870ecaa20321e30e3c12b5207cc2770e7936 Mon Sep 17 00:00:00 2001 From: Helene Durand Date: Wed, 8 Nov 2023 10:22:56 +0100 Subject: [PATCH] DOC: document incompatibilty between route-acl annotation and multiple matches path in Ingress --- documentation/annotations.md | 5 +++++ documentation/doc.yaml | 4 ++++ 2 files changed, 9 insertions(+) diff --git a/documentation/annotations.md b/documentation/annotations.md index 6b30abfe..aa05abe1 100644 --- a/documentation/annotations.md +++ b/documentation/annotations.md @@ -1451,6 +1451,11 @@ haproxy.org/response-set-header: | :information_source: In order for the service to be handled by the Ingress Controller, it is still mandatory to put it in an ingress rule. Using only `route-acl` won't be enough. + :information_source: Note that this annotation is not compatible with an Ingress having multiple paths that will match a request. +Without this annotation, the precedence is given first to the longest matching path. +But with the annotation, the first use_backend rule in the config that matches the request will be used. + + Possible values: - A string describing an in-line [HAProxy ACL](https://www.haproxy.com/blog/introduction-to-haproxy-acls/). diff --git a/documentation/doc.yaml b/documentation/doc.yaml index bc0d8fdd..6eb52681 100644 --- a/documentation/doc.yaml +++ b/documentation/doc.yaml @@ -1383,6 +1383,10 @@ annotations: - Insert a custom route (use_backend rule) to route ingress traffic to the annotated service based on the provided ACL. tip: - In order for the service to be handled by the Ingress Controller, it is still mandatory to put it in an ingress rule. Using only `route-acl` won't be enough. + - | + Note that this annotation is not compatible with an Ingress having multiple paths that will match a request. + Without this annotation, the precedence is given first to the longest matching path. + But with the annotation, the first use_backend rule in the config that matches the request will be used. values: - A string describing an in-line [HAProxy ACL](https://www.haproxy.com/blog/introduction-to-haproxy-acls/). applies_to: