You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: support/azure/kubernetes-fleet/networking/troubleshoot-dns-load-balancing.md
+24-18Lines changed: 24 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,9 +14,9 @@ This article provides troubleshooting information for Azure Kubernetes Fleet Man
14
14
## Use Fleet Manager hub cluster to troubleshoot
15
15
16
16
1. User should have access to the Azure subscription and resource group where the Azure Traffic Manager profile is created.
17
-
2.[Install or upgrade Azure CLI](/cli/azure/install-azure-cli) to version `2.72.0` or later.
17
+
2.[Install or upgrade Azure CLI](/cli/azure/install-azure-cli) to version 2.72.0 or later.
18
18
3. Make sure that the Kubernetes [kubectl](https://kubernetes.io/docs/reference/kubectl/overview/) command-line tool is installed. You can install kubectl by running the [az aks install-cli](/cli/azure/aks#az-aks-install-cli) command.
19
-
4. Install the **fleet** Azure CLI extension using the `az extension add`command, making sure your version is at least `1.5.2`.
19
+
4. Install the **fleet** Azure CLI extension using the `az extension add`command, making sure your version is at least 1.5.2.
20
20
21
21
```azurecli-interactive
22
22
az extension add --name fleet
@@ -42,7 +42,7 @@ This issue may occur if one of the following conditions is met:
42
42
* The resource group isn't the same Azure Subscription as the Fleet Manager resource.
43
43
* The Fleet Manager hub cluster identity doesn't have permission to create and manage Azure Traffic Manager profiles in the specified resource group.
44
44
45
-
You can check The `TrafficManagerProfile` status for details of the error. The following is the example of the TrafficManagerProfile status that shows the insufficient permissions issue.
45
+
You can check The `TrafficManagerProfile` status for details of the error. The following is the example of the `TrafficManagerProfile` status that shows the insufficient permissions issue.
46
46
47
47
```yml
48
48
status:
@@ -81,7 +81,7 @@ To resolve this issue, follow these steps:
81
81
82
82
This issue may occur if the DNS prefix generated is already in use by another Azure Traffic Manager profile. The DNS prefix consists of the namespace and the `metadata.name` field in the `TrafficManagerProfile` manifest. For example, if the namespace is `team-a` and the `metadata.name` is `webapp`, the DNS prefix would `team-a-webapp`.
83
83
84
-
The following is the example of the TrafficManagerProfile status that shows the Domain name is not available issue.
84
+
The following is the example of the `TrafficManagerProfile` status that shows the Domain name is not available issue.
85
85
86
86
```yml
87
87
status:
@@ -105,7 +105,7 @@ To resolve this issue, use `nslookup` or a similar tool to check if the full DNS
105
105
106
106
This issue may occur if more than 200 Traffic Manager Profiles or Endpoints within a single Azure Subscription.
107
107
108
-
The following is the example of the TrafficManagerProfile status that shows the Azure Traffic Manager profile limits reached issue.
108
+
The following is the example of the `TrafficManagerProfile` status that shows the Azure Traffic Manager profile limits reached issue.
109
109
110
110
```yml
111
111
status:
@@ -125,7 +125,7 @@ Consider to delete unused profiles or requesting an increase in the limit. For m
125
125
126
126
This issue may occur if the Azure Traffic Manager service returns an error when creating the profile.
127
127
128
-
The following is the example of the TrafficManagerProfile status that shows this error.
128
+
The following is the example of the `TrafficManagerProfile` status that shows this error.
129
129
130
130
```yml
131
131
status:
@@ -144,7 +144,7 @@ If the error persists, check the Azure Traffic Manager service health.
144
144
145
145
## Scenario 2: TrafficManagerBackend can't be created
146
146
147
-
This section provides common causes and recommended solutions for scenarios that the TrafficManagerBackend Kubernetes can't be created.
147
+
This section provides common causes and recommended solutions for scenarios that the `TrafficManagerBackend` Kubernetes can't be created.
148
148
149
149
To determine the appropriate resolution, check the status of the `TrafficManagerBackend` object on the Fleet Manager hub cluster for the error message.
150
150
@@ -159,7 +159,7 @@ This issue may occur if one of the following conditions is met:
159
159
- The `TrafficManagerBackend` was created in a different namespace than the `TrafficManagerProfile`.
160
160
- The `TrafficManagerProfile` object exists, but the associated Azure Traffic Manager resource couldn't be found.
161
161
162
-
The following are the examples of the TrafficManagerBackend status that shows this error.
162
+
The following are the examples of the `TrafficManagerBackend` status that show the error.
163
163
164
164
```yml
165
165
status:
@@ -188,9 +188,11 @@ status:
188
188
189
189
### Solution
190
190
191
-
* Make sure to create the `TrafficManagerBackend` in the same namespace as the `TrafficManagerProfile`.
192
-
* Ensure that the `Programmed` condition of `TrafficManagerProfile` is `Accepted`. If not, check the profile definition for validity and resubmit.
193
-
* Ensure the Azure Traffic Manager resource exists. To recreate the resource, delete the `TrafficManagerProfile` from the Fleet Manager hub cluster and reapply it.
191
+
To resolve this issue, follow these steps:
192
+
193
+
1. Make sure to create the `TrafficManagerBackend` in the same namespace as the `TrafficManagerProfile`.
194
+
2. Ensure that the `Programmed` condition of `TrafficManagerProfile` is `Accepted`. If not, check the profile definition for validity and resubmit.
195
+
3. Ensure the Azure Traffic Manager resource exists. To recreate the resource, delete the `TrafficManagerProfile` from the Fleet Manager hub cluster and reapply it.
194
196
195
197
### Error 2: Invalid Service or ServiceExport
196
198
@@ -201,7 +203,7 @@ This issue may occur if one of the following conditions is met:
201
203
- The `Service` isn't defined as a `LoadBalancer` type.
202
204
- The `Service` isn't exposed via an Azure public IP address or doesn't have a DNS name assigned.
203
205
204
-
The following are the examples of the TrafficManagerBackend status that shows the errors:
206
+
The following are the examples of the `TrafficManagerBackend` status that shows the errors:
205
207
206
208
```yml
207
209
status:
@@ -231,8 +233,10 @@ conditions:
231
233
232
234
### Solution
233
235
234
-
* Ensure at least one `Service` of a member cluster is exported in the same namespace of the `TrafficManagerBackend` by creating `ServiceExport`.
235
-
* Ensure that the exported `Service` is load balancer type and exposed via an Azure public IP address, which must have a DNS name assigned to be used in a Traffic Manager profile.
236
+
To resolve this issue, follow these steps:
237
+
238
+
1. Ensure at least one `Service` of a member cluster is exported in the same namespace of the `TrafficManagerBackend` by creating `ServiceExport`.
239
+
2. Ensure that the exported `Service` is load balancer type and exposed via an Azure public IP address, which must have a DNS name assigned to be used in a Traffic Manager profile.
236
240
237
241
### Error 3: Azure Traffic Manager profile is not found
238
242
@@ -241,7 +245,7 @@ This issue may occur if one of the following conditions is met:
241
245
- The `TrafficManagerProfile` was object exists, but the associated Azure Traffic Manager resource couldn't be found.
242
246
- The Fleet Manager hub cluster identity doesn't have permission to create and manage Azure Traffic Manager profiles or endpoints in the specified resource group.
243
247
244
-
The following is the example of the TrafficManagerBackend status that shows the error:
248
+
The following is the example of the `TrafficManagerBackend` status that shows the error:
245
249
246
250
```yml
247
251
status:
@@ -256,14 +260,16 @@ conditions:
256
260
257
261
### Solution
258
262
259
-
* Ensure the Azure Traffic Manager resource exists. To recreate the resource, delete the `TrafficManagerProfile` from the Fleet Manager hub cluster and reapply it.
260
-
* Check the Fleet Manager hub cluster identity has been granted the `Traffic Manager Contributor` role scoped to the resource group. For more information, see [Configure Fleet Manager permissions](/azure/kubernetes-fleet/howto-dns-load-balancing#configure-fleet-manager-permissions).
263
+
To resolve this issue, follow these steps:
264
+
265
+
1. Ensure the Azure Traffic Manager resource exists. To recreate the resource, delete the `TrafficManagerProfile` from the Fleet Manager hub cluster and reapply it.
266
+
2. Check the Fleet Manager hub cluster identity has been granted the `Traffic Manager Contributor` role scoped to the resource group. For more information, see [Configure Fleet Manager permissions](/azure/kubernetes-fleet/howto-dns-load-balancing#configure-fleet-manager-permissions).
0 commit comments