Skip to content

Commit 951aa55

Browse files
committed
refine aks quickstart and trouble shooting doc
1 parent d589c93 commit 951aa55

File tree

2 files changed

+25
-27
lines changed

2 files changed

+25
-27
lines changed

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

Lines changed: 23 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -185,6 +185,28 @@ If there's an error during the extension installation, and the error message in
185185

186186
### Common errors and mitigations
187187

188+
#### Extension creation errors
189+
190+
**Error Message:**
191+
`Unable to get a response from the agent in time`.
192+
193+
**Mitigation:**
194+
Refer to [extension creation errors](/troubleshoot/azure/azure-kubernetes/extensions/cluster-extension-deployment-errors#extension-creation-errors)
195+
196+
197+
#### Helm errors
198+
199+
**Error Message:**
200+
- `Timed out waiting for resource readiness`
201+
- `Unable to download the Helm chart from the repo URL`
202+
- `Helm chart rendering failed with given values`
203+
- `Resource already exists in your cluster`
204+
- `Operation is already in progress for Helm`
205+
206+
**Mitigation:**
207+
Refer to [Helm errors](/troubleshoot/azure/azure-kubernetes/extensions/cluster-extension-deployment-errors#helm-errors)
208+
209+
188210
#### Conflict
189211

190212
**Error Message:**
@@ -202,18 +224,6 @@ This error usually occurs when attempting to create a service connection while t
202224
- Ensure your cluster is in a "Succeeded" state and retry the creation.
203225

204226

205-
#### Timeout
206-
207-
**Error Message:**
208-
- `Long running operation failed with status 'Failed'. Unable to get a response from the Agent in time`.
209-
- `Timed out waiting for the resource to come to a ready/completed state`
210-
211-
**Reason:**
212-
This error often happens when the Kubernetes job used to create or update the Service Connector cluster extension fails to be scheduled due to resource limitations or other issues.
213-
214-
**Mitigation:**
215-
Refer to [Check Kubernetes cluster logs](#check-kubernetes-cluster-logs) to identify and resolve the detailed reasons. A common issue is that no nodes are available due to preemption. In this case, consider adding more nodes or enabling auto-scaling for your nodes.
216-
217227
#### Unauthorized resource access
218228

219229
**Error Message:**
@@ -225,6 +235,7 @@ Service Connector requires permissions to operate the Azure resources you want t
225235
**Mitigation:**
226236
Check the permissions on the Azure resources specified in the error message. Obtain the required permissions and retry the creation.
227237

238+
228239
#### Missing subscription registration
229240
**Error Message:**
230241
`The subscription is not registered to use namespace 'Microsoft.KubernetesConfiguration'`
@@ -239,21 +250,6 @@ Register the `Microsoft.KubernetesConfiguration` resource provider by running th
239250
az provider register -n Microsoft.KubernetesConfiguration
240251
```
241252

242-
#### Other issues
243-
244-
If the above mitigations don't resolve your issue, try resetting the service connector cluster extension by removing it and then retrying the creation. This method is expected to resolve most issues related to the Service Connector cluster extension.
245-
246-
Use the following CLI commands to reset the extension:
247-
248-
```azurecli
249-
az extension add --name k8s-extension
250-
251-
az k8s-extension delete \
252-
--resource-group <MyClusterResourceGroup> \
253-
--cluster-name <MyCluster> \
254-
--cluster-type managedClusters \
255-
--name sc-extension
256-
```
257253

258254
## Next steps
259255

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

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -60,6 +60,8 @@ Sign in to the Azure portal at [https://portal.azure.com/](https://portal.azure.
6060
---
6161

6262
1. Select **Next: Networking** to configure the network access to your target service and select **Configure firewall rules to enable access to your target service**.
63+
> [!NOTE]
64+
> Service Connector for AKS now supports only the firewall option. Private link and service endpoint options are not supported.
6365
1. Select **Next: Review + Create** to review the provided information. Then select **Create** to create the service connection. This operation may take a minute to complete.
6466

6567
## View service connections in AKS cluster

0 commit comments

Comments
 (0)