This is an automated email from the ASF dual-hosted git repository.
navendu pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/apisix-ingress-controller.git
The following commit(s) were added to refs/heads/master by this push:
new a16b3dd5 doc: add svc-namespace description to the annotations (#1605)
a16b3dd5 is described below
commit a16b3dd5ee36c1c139f0dbcc3632cc846ef2c5b0
Author: Xin Rong <[email protected]>
AuthorDate: Mon Jan 30 12:18:00 2023 +0800
doc: add svc-namespace description to the annotations (#1605)
Co-authored-by: Navendu Pottekkat <[email protected]>
---
docs/en/latest/concepts/annotations.md | 29 +++++++++++++++++++++++++++++
1 file changed, 29 insertions(+)
diff --git a/docs/en/latest/concepts/annotations.md
b/docs/en/latest/concepts/annotations.md
index 1e9e1853..4f0bd93a 100644
--- a/docs/en/latest/concepts/annotations.md
+++ b/docs/en/latest/concepts/annotations.md
@@ -360,3 +360,32 @@ spec:
port:
number: 50053
```
+
+## Cross-namespace references
+
+This annotation can be used to route to services in a different namespace.
+
+In the example configuration below, the Ingress resource in the `default`
namespace references the httpbin service in the `test` namespace:
+
+```yaml
+apiVersion: networking.k8s.io/v1
+kind: Ingress
+metadata:
+ annotations:
+ k8s.apisix.apache.org/svc-namespace: test
+ name: ingress-v1-svc
+ namespace: default
+spec:
+ ingressClassName: apisix
+ rules:
+ - host: httpbin.org
+ http:
+ paths:
+ - path: /ip
+ pathType: Exact
+ backend:
+ service:
+ name: httpbin
+ port:
+ number: 80
+```
