Skip to content

Commit d303d2f

Browse files
authored
Update istio-add-on-gateway-api.md
1 parent 2dc016b commit d303d2f

1 file changed

Lines changed: 7 additions & 7 deletions

File tree

support/azure/azure-kubernetes/extensions/istio-add-on-gateway-api.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -17,14 +17,14 @@ This article discusses how to troubleshoot ingress gateways that are configured
1717

1818
## Overview
1919

20-
Similar to the [classic Istio ingress gateways](./istio-add-on-ingress-gateway.md), Gateway API-based ingress gateways for the Istio add-on are Envoy-based reverse proxies. Users must have the [AKS Managed Gateway API CRDs](/azure/aks/managed-gateway-api) installed on their cluster before thay can use the Istio add-on for Gateway API-based ingress.
20+
Similar to the [classic Istio ingress gateways](./istio-add-on-ingress-gateway.md), Gateway API-based ingress gateways for the Istio add-on are Envoy-based reverse proxies. Users must have the [AKS Managed Gateway API CRDs](/azure/aks/managed-gateway-api) installed on their cluster before they can use the Istio add-on for Gateway API-based ingress.
2121

2222
## Before troubleshooting
2323

2424
Before you proceed, take the following actions:
2525

2626
- Install the [Managed Gateway API CRDs](/azure/aks/managed-gateway-api) on your cluster.
27-
- Make sure that you have the Istio add-on installed and are on ASM minor revision `asm-1-26` or a later revision. Follow the [installation guide](/azure/aks/istio-deploy-addon) to enable the Istio add-on and the [upgrade documentation](/azure/aks/istio-upgrade) to upgrade your mesh to `asm-1-26` if you are on an earlier revision.
27+
- Make sure that you have the Istio add-on installed and are on ASM minor revision `asm-1-26` or a later revision. Follow the [installation guide](/azure/aks/istio-deploy-addon) to enable the Istio add-on and the [upgrade documentation](/azure/aks/istio-upgrade) to upgrade your mesh to `asm-1-26` if you're on an earlier revision.
2828

2929
## Networking, firewall, and load balancer errors troubleshooting
3030

@@ -89,7 +89,7 @@ The `istiod` logs may have additional details about `Gateway` programming-relate
8989

9090
## Minor revision upgrades and revision label troubleshooting
9191

92-
By default during an [Istio add-on minor revision upgrade](/azure/aks/istio-upgrade), if two control planes are deployed on the cluster simultaneously, the higher revision takes ownership of the `Gateway` resources if the gateways are not labeled with a specific ASM revision:
92+
By default during an [Istio add-on minor revision upgrade](/azure/aks/istio-upgrade), if two control planes are deployed on the cluster simultaneously, the higher revision takes ownership of the `Gateway` resources if the gateways aren't labeled with a specific ASM revision:
9393

9494
```yaml
9595
apiVersion: gateway.networking.k8s.io/v1
@@ -102,7 +102,7 @@ spec:
102102
gatewayClassName: istio
103103
```
104104

105-
During the minor revision upgrade, verify that the pods and deployments for the gateway are automatically updated to have the new proxy minor image version that corresponds to the later control plane minor revision. If this condition is not true, try to restart the Deployment.
105+
During the minor revision upgrade, verify that the pods and deployments for the gateway are automatically updated to have the new proxy minor image version that corresponds to the later control plane minor revision. If this condition isn't true, try to restart the Deployment.
106106

107107
If your gateways are labeled explicitly with an ASM revision, relabel them accordingly before you finish or roll back the upgrade operation.
108108

@@ -125,12 +125,12 @@ Make sure that the customizations for both `GatewayClass`-level ConfigMaps and `
125125

126126
`GatewayClass`-level ConfigMap `istio-gateway-class-defaults` is automatically deployed in the `aks-istio-system` namespace by the Istio add-on when the Managed Gateway API installation is enabled on the cluster. Notice that it could take up to five minutes for the `istio-gateway-class-defaults` ConfigMap to be deployed after you install the Managed Gateway API CRDs.
127127

128-
If you are editing this ConfigMap, make sure that you keep the `gateway.istio.io/defaults-for-class` label set to `istio`. You can have only one `GatewayClass`-level ConfigMap deployed at a time.
128+
If you're editing this ConfigMap, make sure that you keep the `gateway.istio.io/defaults-for-class` label set to `istio`. You can have only one `GatewayClass`-level ConfigMap deployed at a time.
129129

130130
### Step 3: Verify gateway-level ConfigMap customizations
131131

132-
If both the `GatewayClass`-level ConfigMap and a `Gateway`-level ConfigMap are deployed, the `Gateway`-level ConfigMap customizations take precedence. Make sure that the desired resource customizations for the `Gateway are set in the `Gateway`-level ConfigMap. Also, verify that the `spec.infrastructure.parametersRef` field references the correct ConfigMap for that gateway.
132+
If both the `GatewayClass`-level ConfigMap and a `Gateway`-level ConfigMap are deployed, the `Gateway`-level ConfigMap customizations take precedence. Make sure that the desired resource customizations for the gateway are set in the `Gateway`-level ConfigMap. Also, verify that the `spec.infrastructure.parametersRef` field references the correct ConfigMap for that gateway.
133133

134-
### Step 4: Inspect gateway resource propogation errors
134+
### Step 4: Inspect gateway resource propagation errors
135135

136136
If the `Gateway` customizations don't propagate to their respective resources, verify that the ConfigMap spec is valid in terms of indentation, correct field names, spelling, and so on. You should also inspect the `istiod` logs to see whether any issues affect template rendering or resource creation for the gateways.

0 commit comments

Comments
 (0)