Add traffic distribution annotation (#3328)

* Add traffic distribution annotation Added in istio/istio#53435 * update docs
istio · Oct 18, 2024 · 585d68d · 585d68d
1 parent 1e82bd4
commit 585d68d
Show file tree

Hide file tree

Showing 3 changed files with 83 additions and 0 deletions.
diff --git a/annotation/annotations.gen.go b/annotation/annotations.gen.go
diff --git a/annotation/annotations.pb.html b/annotation/annotations.pb.html
diff --git a/annotation/annotations.yaml b/annotation/annotations.yaml
@@ -550,3 +550,23 @@ annotations:
     hidden: true
     resources:
       - Gateway
+
+  - name: networking.istio.io/traffic-distribution
+    featureStatus: Alpha
+    description: |
+      Controls how traffic is distributed across the set of available endpoints.
+      
+      At this time, this annotation only impacts routing done by Ztunnel.
+      
+      Accepted values:
+      * `PreferClose`: endpoints will be categorized by how "close" they are, consider network, region, zone, and subzone.
+        Traffic will be prioritized to the closest healthy endpoints.
+        For example, if I have a Service with `PreferClose` set, with endpoints in zones `us-west,us-west,us-east`. When 
+        sending traffic from a client in zone `us-west`, all traffic will go to the two `us-west` backends.
+        If one those backends become unhealthy, all traffic will go to the remaining endpoint in `us-west`.
+        If that backend becomes unhealthy, traffic will sent to `us-east`.
+    deprecated: false
+    hidden: false
+    resources:
+      - Service
+      - ServiceEntry