Skip to content

Commit b28d7c2

Browse files
authored
Update troubleshoot-dns-load-balancing.md
1 parent eaf1e9f commit b28d7c2

1 file changed

Lines changed: 24 additions & 18 deletions

File tree

support/azure/kubernetes-fleet/networking/troubleshoot-dns-load-balancing.md

Lines changed: 24 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -14,9 +14,9 @@ This article provides troubleshooting information for Azure Kubernetes Fleet Man
1414
## Use Fleet Manager hub cluster to troubleshoot
1515

1616
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.
1818
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.
2020

2121
```azurecli-interactive
2222
az extension add --name fleet
@@ -42,7 +42,7 @@ This issue may occur if one of the following conditions is met:
4242
* The resource group isn't the same Azure Subscription as the Fleet Manager resource.
4343
* The Fleet Manager hub cluster identity doesn't have permission to create and manage Azure Traffic Manager profiles in the specified resource group.
4444

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.
4646

4747
```yml
4848
status:
@@ -81,7 +81,7 @@ To resolve this issue, follow these steps:
8181

8282
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`.
8383

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.
8585

8686
```yml
8787
status:
@@ -105,7 +105,7 @@ To resolve this issue, use `nslookup` or a similar tool to check if the full DNS
105105

106106
This issue may occur if more than 200 Traffic Manager Profiles or Endpoints within a single Azure Subscription.
107107

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.
109109

110110
```yml
111111
status:
@@ -125,7 +125,7 @@ Consider to delete unused profiles or requesting an increase in the limit. For m
125125

126126
This issue may occur if the Azure Traffic Manager service returns an error when creating the profile.
127127

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.
129129

130130
```yml
131131
status:
@@ -144,7 +144,7 @@ If the error persists, check the Azure Traffic Manager service health.
144144

145145
## Scenario 2: TrafficManagerBackend can't be created
146146

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.
148148

149149
To determine the appropriate resolution, check the status of the `TrafficManagerBackend` object on the Fleet Manager hub cluster for the error message.
150150

@@ -159,7 +159,7 @@ This issue may occur if one of the following conditions is met:
159159
- The `TrafficManagerBackend` was created in a different namespace than the `TrafficManagerProfile`.
160160
- The `TrafficManagerProfile` object exists, but the associated Azure Traffic Manager resource couldn't be found.
161161

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.
163163

164164
```yml
165165
status:
@@ -188,9 +188,11 @@ status:
188188

189189
### Solution
190190

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.
194196

195197
### Error 2: Invalid Service or ServiceExport
196198

@@ -201,7 +203,7 @@ This issue may occur if one of the following conditions is met:
201203
- The `Service` isn't defined as a `LoadBalancer` type.
202204
- The `Service` isn't exposed via an Azure public IP address or doesn't have a DNS name assigned.
203205

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:
205207

206208
```yml
207209
status:
@@ -231,8 +233,10 @@ conditions:
231233

232234
### Solution
233235

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.
236240

237241
### Error 3: Azure Traffic Manager profile is not found
238242

@@ -241,7 +245,7 @@ This issue may occur if one of the following conditions is met:
241245
- The `TrafficManagerProfile` was object exists, but the associated Azure Traffic Manager resource couldn't be found.
242246
- 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.
243247

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:
245249

246250
```yml
247251
status:
@@ -256,14 +260,16 @@ conditions:
256260

257261
### Solution
258262

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).
261267

262268
### Error 4: Azure Traffic Manager profile limits reached
263269

264270
This issue may occur if more than 200 Azure Traffic Manager Endpoints would be created within a single Azure Subscription.
265271

266-
The following is the example of the TrafficManagerBackend status that shows the error:
272+
The following is the example of the `TrafficManagerBackend` status that shows the error:
267273

268274
```yml
269275
status:

0 commit comments

Comments
 (0)