Skip to content

Commit 6e2d935

Browse files
Merge pull request #280069 from houk-ms/hongkun/aks-doc
[Service Connector] Update aks trouble shooting doc
2 parents f489b9c + 0835eae commit 6e2d935

File tree

2 files changed

+19
-6
lines changed

2 files changed

+19
-6
lines changed

articles/service-connector/how-to-use-service-connector-in-aks.md

Lines changed: 13 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -191,10 +191,16 @@ If there's an error during the extension installation, and the error message in
191191
`Operation returned an invalid status code: Conflict`.
192192

193193
**Reason:**
194-
This error usually occurs when attempting to create a service connection while the AKS (Azure Kubernetes Service) cluster is in an updating state. The service connection update conflicts with the ongoing update.
194+
This error usually occurs when attempting to create a service connection while the AKS (Azure Kubernetes Service) cluster is in an updating state. The service connection update conflicts with the ongoing update. It could also happen when your subscription is not resgitered for the `Microsoft.KubernetesConfiguration` resource provider.
195195

196196
**Mitigation:**
197-
Ensure your cluster is in a "Succeeded" state before retrying the creation. It resolves most errors related to conflicts.
197+
- Run the following command to make sure your subscription is registered for `Microsoft.KubernetesConfiguration` resource provider.
198+
199+
```azurecli
200+
az provider register -n Microsoft.KubernetesConfiguration
201+
```
202+
- Ensure your cluster is in a "Succeeded" state and retry the creation.
203+
198204

199205
#### Timeout
200206

@@ -227,7 +233,11 @@ Check the permissions on the Azure resources specified in the error message. Obt
227233
Service Connector requires the subscription to be registered for `Microsoft.KubernetesConfiguration`, which is the resource provider for [Azure Arc-enabled Kubernetes cluster extensions](../azure-arc/kubernetes/extensions.md).
228234

229235
**Mitigation:**
230-
To resolve errors related to resource provider registration, follow this [tutorial](../azure-resource-manager/troubleshooting/error-register-resource-provider.md).
236+
Register the `Microsoft.KubernetesConfiguration` resource provider by running the following command. For more information on resource provider registration errors, please refer to this [tutorial](../azure-resource-manager/troubleshooting/error-register-resource-provider.md).
237+
238+
```azurecli
239+
az provider register -n Microsoft.KubernetesConfiguration
240+
```
231241

232242
#### Other issues
233243

articles/service-connector/quickstart-cli-aks-connection.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -23,14 +23,17 @@ This quickstart shows you how to connect Azure Kubernetes Service (AKS) to other
2323

2424
## Initial set-up
2525

26-
1. If you're using Service Connector for the first time, start by running the command [az provider register](/cli/azure/provider#az-provider-register) to register the Service Connector resource provider.
26+
1. If you're using Service Connector for the first time, start by running the command [az provider register](/cli/azure/provider#az-provider-register) to register the Service Connector and Kubernetes Configuration resource providers.
2727

2828
```azurecli
2929
az provider register -n Microsoft.ServiceLinker
3030
```
31+
```azurecli
32+
az provider register -n Microsoft.KubernetesConfiguration
33+
```
3134

3235
> [!TIP]
33-
> You can check if the resource provider has already been registered by running the command `az provider show -n "Microsoft.ServiceLinker" --query registrationState`. If the output is `Registered`, then Service Connector has already been registered.
36+
> You can check if these resource providers have already been registered by running the commands `az provider show -n "Microsoft.ServiceLinker" --query registrationState` and `az provider show -n "Microsoft.KubernetesConfiguration" --query registrationState`.
3437
3538
1. Optionally, use the Azure CLI command to get a list of supported target services for AKS cluster.
3639

@@ -103,4 +106,4 @@ Go to the following tutorials to start connecting AKS cluster to Azure services
103106
> [Tutorial: Connect to Azure Key Vault using CSI driver](./tutorial-python-aks-keyvault-csi-driver.md)
104107
105108
> [!div class="nextstepaction"]
106-
> [Tutorial: Connect to Azure Storage using workload identity](./tutorial-python-aks-storage-workload-identity.md)
109+
> [Tutorial: Connect to Azure Storage using workload identity](./tutorial-python-aks-storage-workload-identity.md)

0 commit comments

Comments
 (0)