From e5176e033b8e8728adde6478552107c47c16176d Mon Sep 17 00:00:00 2001 From: yiannistri <8741709+yiannistri@users.noreply.github.com> Date: Wed, 8 Jan 2025 14:26:01 +0000 Subject: [PATCH] docs: Improve troubleshooting instructions --- .../register-existing-clusters.md | 6 ++++-- .../register-existing-clusters.md | 9 ++++++--- .../register-existing-clusters.md | 11 +++++++---- 3 files changed, 17 insertions(+), 9 deletions(-) diff --git a/docs/how-to-guides/new-user-guides/kubernetes-clusters-in-rancher-setup/register-existing-clusters.md b/docs/how-to-guides/new-user-guides/kubernetes-clusters-in-rancher-setup/register-existing-clusters.md index 99a909ccb08..b38111027d0 100644 --- a/docs/how-to-guides/new-user-guides/kubernetes-clusters-in-rancher-setup/register-existing-clusters.md +++ b/docs/how-to-guides/new-user-guides/kubernetes-clusters-in-rancher-setup/register-existing-clusters.md @@ -291,13 +291,15 @@ To annotate a registered cluster, ## Troubleshooting -This section lists some of the most common errors that may occur when importing a cluster, along with steps to troubleshoot them. +This section lists some of the most common errors that may occur when importing a cluster and provides steps to troubleshoot them. ### AKS -- The following error may occur if local accounts are disabled in your cluster. +- The following error may occur if local accounts are disabled in your cluster. ```sh Error: Getting static credential is not allowed because this cluster is set to disable local accounts. + ``` + To resolve this issue, enable local accounts before attempting to [import the cluster](#registering-a-cluster) again. ```sh diff --git a/versioned_docs/version-2.10/how-to-guides/new-user-guides/kubernetes-clusters-in-rancher-setup/register-existing-clusters.md b/versioned_docs/version-2.10/how-to-guides/new-user-guides/kubernetes-clusters-in-rancher-setup/register-existing-clusters.md index 758cab7fac3..bf066ba5601 100644 --- a/versioned_docs/version-2.10/how-to-guides/new-user-guides/kubernetes-clusters-in-rancher-setup/register-existing-clusters.md +++ b/versioned_docs/version-2.10/how-to-guides/new-user-guides/kubernetes-clusters-in-rancher-setup/register-existing-clusters.md @@ -295,10 +295,13 @@ This section lists some of the most common errors that may occur when importing ### AKS -#### Error: Getting static credential is not allowed because this cluster is set to disable local accounts. +- The following error may occur if local accounts are disabled in your cluster. + ```sh + Error: Getting static credential is not allowed because this cluster is set to disable local accounts. + ``` -* This may occur if your cluster has disabled local accounts. Enable local accounts before attempting to import the cluster again: + To resolve this issue, enable local accounts before attempting to [import the cluster](#registering-a-cluster) again. - ``` + ```sh az aks update --resource-group --name --enable-local-accounts ``` \ No newline at end of file diff --git a/versioned_docs/version-2.9/how-to-guides/new-user-guides/kubernetes-clusters-in-rancher-setup/register-existing-clusters.md b/versioned_docs/version-2.9/how-to-guides/new-user-guides/kubernetes-clusters-in-rancher-setup/register-existing-clusters.md index 758cab7fac3..f3cfcc06cba 100644 --- a/versioned_docs/version-2.9/how-to-guides/new-user-guides/kubernetes-clusters-in-rancher-setup/register-existing-clusters.md +++ b/versioned_docs/version-2.9/how-to-guides/new-user-guides/kubernetes-clusters-in-rancher-setup/register-existing-clusters.md @@ -291,14 +291,17 @@ To annotate a registered cluster, ## Troubleshooting -This section lists some of the most common errors that may occur when importing a cluster, along with steps to troubleshoot them. +This section lists some of the most common errors that may occur when importing a cluster and provides steps to troubleshoot them. ### AKS -#### Error: Getting static credential is not allowed because this cluster is set to disable local accounts. +- The following error may occur if local accounts are disabled in your cluster. + ```sh + Error: Getting static credential is not allowed because this cluster is set to disable local accounts. + ``` -* This may occur if your cluster has disabled local accounts. Enable local accounts before attempting to import the cluster again: + To resolve this issue, enable local accounts before attempting to [import the cluster](#registering-a-cluster) again. - ``` + ```sh az aks update --resource-group --name --enable-local-accounts ``` \ No newline at end of file