/
aks-common-issues-faq.yml
49 lines (38 loc) · 4.04 KB
/
aks-common-issues-faq.yml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
### YamlMime:FAQ
metadata:
title: Azure Kubernetes Service (AKS) common issues FAQ
description: Review a list of frequently asked questions (FAQ) about common issues when you're working with an Azure Kubernetes Service (AKS) cluster.
ms.topic: faq
ms.date: 11/14/2023
ms.reviewer: chiragpa, nickoman, v-leedennis
ms.service: azure-kubernetes-service
ms.custom: sap:Create, Upgrade, Scale and Delete operations (cluster or nodepool)
title: Azure Kubernetes Service (AKS) common issues FAQ
summary: This article answers frequently asked questions (FAQ) about common issues that can occur when you're working with an Azure Kubernetes Service (AKS) cluster.
sections:
- name: General
questions:
- question: |
In general, where do I find information about debugging Kubernetes problems?
answer: |
Try the [official guide to troubleshooting Kubernetes clusters](https://kubernetes.io/docs/tasks/debug/). There's also a [troubleshooting guide](https://github.com/feiskyer/kubernetes-handbook/blob/master/en/troubleshooting/index.md) that was published by a Microsoft engineer. This guide helps you troubleshoot pods, nodes, clusters, and other features.
- question: |
I'm trying to enable Kubernetes role-based access control (Kubernetes RBAC) on an existing cluster. How can I do that?
answer: |
Enabling Kubernetes role-based access control (Kubernetes RBAC) on existing clusters isn't supported at this time. This feature can be set only when you create new clusters. Kubernetes RBAC is enabled by default when you use the [Azure CLI](/cli/azure/install-azure-cli), the [Azure portal](https://portal.azure.com), or an API version later than `2020-03-01`.
- question: |
Can I move my cluster to a different subscription, or move my subscription with my cluster to a new tenant?
answer: |
If you've moved your AKS cluster to a different subscription or the cluster's subscription to a new tenant, the cluster won't function because of missing cluster identity permissions. AKS doesn't support moving clusters across subscriptions or tenants because of this constraint.
- question: |
What naming restrictions are enforced for AKS resources and parameters?
answer: |
Naming restrictions are implemented by both the Azure platform and AKS. If a resource name or parameter breaks one of these restrictions, an error is returned that asks you provide a different input. The following common naming guidelines apply:
- Cluster names must be 1-63 characters in length. The only allowed characters are letters, numbers, dashes, and underscore. The first and last character must be a letter or a number.
- The AKS node or *MC_* resource group name combines the resource group name and resource name. The autogenerated syntax of *MC_resourceGroupName_resourceName_AzureRegion* must be no greater than 80 characters in length. If necessary, reduce the length of your resource group name or AKS cluster name. You may also [customize your node's resource group name](/azure/aks/cluster-configuration#custom-resource-group-name).
- The Domain Name System (DNS) prefix must start and end with alphanumeric values and must be between 1-54 characters in length. Valid characters include alphanumeric values and hyphens ("-"). The DNS prefix can't include special characters, such as periods (".").
- AKS node pool names must be all lowercase. The names must be 1-12 characters in length for Linux node pools and 1-6 characters for Windows node pools. A name must start with a letter, and the only allowed characters are letters and numbers.
- The *admin-username*, which sets the administrator user name for Linux nodes, must start with a letter. This user name may only contain letters, numbers, hyphens, and underscores. It has a maximum length of 32 characters.
additionalContent: |
[!INCLUDE [Third-party disclaimer](../../../includes/third-party-disclaimer.md)]
[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)]