Skip to content

Commit 73fd6f8

Browse files
committed
Update aks-naming-rules and 1804 nodepool create
1 parent 82238b7 commit 73fd6f8

File tree

2 files changed

+15
-1
lines changed

2 files changed

+15
-1
lines changed

articles/aks/cluster-configuration.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -44,6 +44,8 @@ When the status shows as registered, refresh the registration of the `Microsoft.
4444
az provider register --namespace Microsoft.ContainerService
4545
```
4646

47+
### New clusters
48+
4749
Configure the cluster to use Ubuntu 18.04 when the cluster is created. Use the `--aks-custom-headers` flag to set the Ubuntu 18.04 as the default OS.
4850

4951
```azure-cli
@@ -52,6 +54,17 @@ az aks create --name myAKSCluster --resource-group myResourceGroup --aks-custom-
5254

5355
If you want to create a regular Ubuntu 16.04 cluster, you can do so by omitting the custom `--aks-custom-headers` tag.
5456

57+
### Existing clusters
58+
59+
Configure a new nodepool to use Ubuntu 18.04. Use the `--aks-custom-headers` flag to set the Ubuntu 18.04 as the default OS for that nodepool.
60+
61+
```azure-cli
62+
az aks nodepool add --name ubuntu1804 --cluster-name myAKSCluster --resource-group myResourceGroup --aks-custom-headers CustomizedUbuntu=aks-ubuntu-1804
63+
```
64+
65+
If you want to create a regular Ubuntu 16.04 nodepools, you can do so by omitting the custom `--aks-custom-headers` tag.
66+
67+
5568
## Custom resource group name
5669

5770
When you deploy an Azure Kubernetes Service cluster in Azure, a second resource group gets created for the worker nodes. By default, AKS will name the node resource group `MC_resourcegroupname_clustername_location`, but you can also provide your own name.

articles/aks/troubleshooting.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -113,8 +113,9 @@ Follow the *Before you begin* steps in the appropriate doc to correctly create a
113113
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:
114114

115115
* Cluster names must be 1-63 characters. The only allowed characters are letters, numbers, dashes, and underscores. The first and last character must be a letter or a number.
116-
* The AKS *MC_* resource group name combines resource group name and resource name. The auto-generated syntax of `MC_resourceGroupName_resourceName_AzureRegion` must be no greater than 80 chars. If needed, reduce the length of your resource group name or AKS cluster name.
116+
* The AKS Node/*MC_* resource group name combines resource group name and resource name. The auto-generated syntax of `MC_resourceGroupName_resourceName_AzureRegion` must be no greater than 80 chars. If needed, reduce the length of your resource group name or AKS cluster name. You may also [customize your node resource group name](cluster-configuration.md#custom-resource-group-name)
117117
* The *dnsPrefix* must start and end with alphanumeric values and must be between 1-54 characters. Valid characters include alphanumeric values and hyphens (-). The *dnsPrefix* can't include special characters such as a period (.).
118+
* AKS Nodepool names must be all lowercase and be 1-11 characters for linux nodepools and 1-6 characters for windows nodepools. The name must start with a letter and the only allowed characters are letters and numbers.
118119

119120
## I'm receiving errors when trying to create, update, scale, delete or upgrade cluster, that operation is not allowed as another operation is in progress.
120121

0 commit comments

Comments
 (0)