Skip to content

Commit 1778c5b

Browse files
committed
Docs updates for Istio add-on from docs bash.
Signed-off-by: nshankar <[email protected]>
1 parent 1ddd418 commit 1778c5b

File tree

3 files changed

+26
-2
lines changed

3 files changed

+26
-2
lines changed

articles/aks/istio-about.md

Lines changed: 17 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -44,22 +44,37 @@ This service mesh add-on uses and builds on top of open-source Istio. The add-on
4444

4545
## Limitations
4646

47-
Istio-based service mesh add-on for AKS has the following limitations:
47+
Istio-based service mesh add-on for AKS currently has the following limitations:
4848
* The add-on doesn't work on AKS clusters that are using [Open Service Mesh addon for AKS][open-service-mesh-about].
4949
* The add-on doesn't work on AKS clusters that have Istio installed on them already outside the add-on installation.
5050
* The add-on doesn't support adding pods associated with virtual nodes to be added under the mesh.
51+
* The add-on doesn't support egress gateways for outbound traffic control.
52+
* The add-on doesn't support the sidecar-less Ambient dataplane mode.
53+
* The add-on doesn't support multi-cluster, multi-mesh, multi-cloud, or hybrid deployments.
54+
* The add-on restricts mesh-wide configuration options for the [Istio meshconfig][istio-meshconfig].
55+
* The add-on doesn't support static IP address, port, or other customizations for the [Istio add-on ingress gateways][istio-ingress].
5156
* Istio doesn't support Windows Server containers.
52-
* Customization of mesh based on the following custom resources is blocked for now - `EnvoyFilter, ProxyConfig, WorkloadEntry, WorkloadGroup, Telemetry, IstioOperator, WasmPlugin`
57+
* Customization of mesh based on the following custom resources is blocked for now - `ProxyConfig, WorkloadEntry, WorkloadGroup, Telemetry, IstioOperator, WasmPlugin`. For `EnvoyFilter`, the add-on only supports customization of Lua script filters (`type.googleapis.com/envoy.extensions.filters.http.lua.v3.Lua`) - other `EnvoyFilter` types are blocked.
58+
5359
* Gateway API for Istio ingress gateway or managing mesh traffic (GAMMA) are currently not yet supported with Istio addon.
5460

5561
## Next steps
5662

63+
### Feedback and Feature Requests
64+
65+
Feedback and feature requests for the Istio-based service mesh add-on should be raised as a new issue in the [AKS github repository][aks-gh-issues]. Please open a new issue with and add the `mesh` label.
66+
5767
* [Deploy Istio-based service mesh add-on][istio-deploy-addon]
68+
* [Troubleshoot Istio-based service mesh add-on][istio-troubleshooting]
5869

5970
[istio-overview]: https://istio.io/latest/
6071
[managed-prometheus-overview]: ../azure-monitor/essentials/prometheus-metrics-overview.md
6172
[managed-grafana-overview]: ../managed-grafana/overview.md
6273
[azure-cni-cilium]: azure-cni-powered-by-cilium.md
6374
[open-service-mesh-about]: open-service-mesh-about.md
75+
[istio-meshconfig]: ./istio-meshconfig.md
76+
[istio-ingress]: ./istio-deploy-ingress.md
77+
[istio-troubleshooting]: /troubleshoot/azure/azure-kubernetes/extensions/istio-add-on-general-troubleshooting.md
78+
[aks-gh-issues]: https://github.com/Azure/AKS/issues
6479

6580
[istio-deploy-addon]: istio-deploy-addon.md

articles/aks/istio-deploy-addon.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -240,6 +240,10 @@ az group delete --name ${RESOURCE_GROUP} --yes --no-wait
240240

241241
## Next steps
242242

243+
### Feedback and Feature Requests
244+
245+
Feedback and feature requests for the Istio-based service mesh add-on should be raised as a new issue in the [AKS github repository][aks-gh-issues]. Please open a new issue with and add the `mesh` label.
246+
243247
* [Deploy external or internal ingresses for Istio service mesh add-on][istio-deploy-ingress]
244248
* [Scale istiod and ingress gateway HPA][istio-scaling-guide]
245249

@@ -259,3 +263,4 @@ az group delete --name ${RESOURCE_GROUP} --yes --no-wait
259263
[az-aks-mesh-get-revisions]: /cli/azure/aks/mesh#az-aks-mesh-get-revisions(aks-preview)
260264
[bicep-aks-resource-definition]: /azure/templates/microsoft.containerservice/managedclusters
261265
[istio-scaling-guide]: istio-scale.md#scaling
266+
[aks-gh-issues]: https://github.com/Azure/AKS/issues

articles/aks/istio-deploy-ingress.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -242,9 +242,13 @@ az group delete --name ${RESOURCE_GROUP} --yes --no-wait
242242

243243
## Next steps
244244

245+
> [!NOTE]
246+
> In case of any issues encountered with deploying the Istio ingress gateway or configuring ingress traffic routing, refer to [article on troubleshooting Istio add-on ingress gateways][istio-ingress-tsg]
247+
245248
* [Secure ingress gateway for Istio service mesh add-on][istio-secure-gateway]
246249
* [Scale ingress gateway HPA][istio-scaling-guide]
247250

248251
[istio-deploy-addon]: istio-deploy-addon.md
249252
[istio-secure-gateway]: istio-secure-gateway.md
250253
[istio-scaling-guide]: istio-scale.md#scaling
254+
[istio-ingress-tsg]: /troubleshoot/azure/azure-kubernetes/extensions/istio-add-on-ingress-gateway

0 commit comments

Comments
 (0)