You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/aks/cluster-configuration.md
+7-45Lines changed: 7 additions & 45 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -62,63 +62,25 @@ Additionally, not all VM images support Gen2 VMs. On AKS, Gen2 VMs use [AKS Ubun
62
62
63
63
Gen2 VMs are supported on Linux. Gen2 VMs on Windows are supported for WS2022 only.
64
64
65
-
### Generation 2 virtual machines on Windows (preview)
65
+
### Generation 2 virtual machines on Windows
66
66
67
-
[!INCLUDE [preview features callout](includes/preview/preview-callout.md)]
67
+
#### Limitations
68
68
69
69
* Generation 2 VMs are supported on Windows for WS2022 only.
70
70
* Generation 2 VMs are default for Windows clusters greater than or equal to Kubernetes 1.25.
71
-
* If your Kubernetes version is greater than 1.25, you only need to set the `vm_size` to get the generation 2 node pool. You can still use WS2019 generation 1 if you define that in the `os_sku`.
72
-
* If your Kubernetes version is less than 1.25, you can set the `os_sku` to WS2022 and set the `vm_size` to generation 2 to get the generation 2 node pool.
73
-
74
-
#### Install the aks-preview Azure CLI extension
75
-
76
-
* Install or update the aks-preview Azure CLI extension using the [`az extension add`][az-extension-add] or the [`az extension update`][az-extension-update] command.
77
-
78
-
```azurecli
79
-
# Install the aks-preview extension
80
-
az extension add --name aks-preview
81
-
82
-
# Update to the latest version of the aks-preview extension
83
-
az extension update --name aks-preview
84
-
```
85
-
86
-
#### Register the AKSWindows2022Gen2Preview feature flag
87
-
88
-
1. Register the AKSWindows2022Gen2Preview feature flag using the [`az feature register`][az-feature-register] command.
89
-
90
-
```azurecli-interactive
91
-
az feature register --namespace "Microsoft.ContainerService" --name "AKSWindows2022Gen2Preview"
92
-
```
93
-
94
-
It takes a few minutes for the status to show *Registered*.
95
-
96
-
2. Verify the registration using the [`az feature show`][az-feature-show] command.
97
-
98
-
```azurecli-interactive
99
-
az feature show --namespace "Microsoft.ContainerService" --name "AKSWindows2022Gen2Preview"
100
-
```
101
-
102
-
3. When the status reflects *Registered*, refresh the registration of the `Microsoft.ContainerService` resource provider using the [`az provider register`][az-provider-register] command.
103
-
104
-
```azurecli-interactive
105
-
az provider register --namespace "Microsoft.ContainerService"
106
-
```
71
+
* If you select a vm size which supports both Gen 1 and Gen 2, the default for windows node pools will be Gen 1. To specify Gen 2, use custom header `UseWindowsGen2VM=true`.
107
72
108
73
#### Add a Windows node pool with a generation 2 VM
109
74
110
75
* Add a node pool with generation 2 VMs on Windows using the [`az aks nodepool add`][az-aks-nodepool-add] command.
111
76
112
77
```azurecli
113
-
# Sample command
114
-
az aks nodepool add --resource-group myResourceGroup --cluster-name myAKSCluster --name gen2np
115
-
--kubernetes-version 1.23.5 --node-vm-size Standard_D32_v4 --os-type Windows --os-sku Windows2022
116
-
117
-
# Default command
118
-
az aks nodepool add --resource-group myResourceGroup --cluster-name myAKSCluster --name gen2np --os-type Windows --kubernetes-version 1.23.5
78
+
az aks nodepool add --resource-group myResourceGroup --cluster-name myAKSCluster --name gen2np --node-vm-size Standard_D32_v4 --os-type Windows --aks-custom-headers UseWindowsGen2VM=true
119
79
```
120
80
121
-
* Determine whether you're on generation 1 or generation 2 using the [`az aks nodepool show`][az-aks-nodepool-show] command, and check that the `nodeImageVersion` contains `gen2`.
81
+
The above example will create a WS2022 node pool with a Gen 2 VM. If you're using a vm size which only supports Gen 2, you do not need to add the custom header. If you're using a kubernetes version where Windows Server 2022 is not default, you need to specify `--os-sku`.
82
+
83
+
* Check whether you're using generation 1 or generation 2 using the [`az aks nodepool show`][az-aks-nodepool-show] command, and check that the `nodeImageVersion` contains `gen2`.
Copy file name to clipboardExpand all lines: articles/aks/custom-node-configuration.md
+3-40Lines changed: 3 additions & 40 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,47 +14,10 @@ Customizing your node configuration allows you to adjust operating system (OS) s
14
14
15
15
## Create an AKS cluster with a customized node configuration
16
16
17
-
[!INCLUDE [preview features callout](./includes/preview/preview-callout.md)]
18
-
19
-
### Prerequisites for Windows kubelet custom configuration (preview)
20
-
21
-
Before you begin, make sure you have an Azure account with an active subscription. If you don't have one, [create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F). You also need to register the feature flag using the following steps:
22
-
23
-
24
-
1. Install the aks-preview extension using the [`az extension add`][az-extension-add] command.
25
-
26
-
```azurecli
27
-
az extension add --name aks-preview
28
-
```
29
-
30
-
2. Update to the latest version of the extension using the [`az extension update`][az-extension-update] command.
31
-
32
-
```azurecli
33
-
az extension update --name aks-preview
34
-
```
35
-
36
-
3. Register the `WindowsCustomKubeletConfigPreview` feature flag using the [`az feature register`][az-feature-register] command.
37
-
38
-
```azurecli-interactive
39
-
az feature register --namespace "Microsoft.ContainerService" --name "WindowsCustomKubeletConfigPreview"
40
-
```
41
-
42
-
It takes a few minutes for the status to show *Registered*.
43
-
44
-
4. Verify the registration status using the [`az feature show`][az-feature-show] command.
45
-
46
-
```azurecli-interactive
47
-
az feature show --namespace "Microsoft.ContainerService" --name "WindowsCustomKubeletConfigPreview"
48
-
```
49
-
50
-
5. When the status reflects *Registered*, refresh the registration of the *Microsoft.ContainerService* resource provider using the [`az provider register`][az-provider-register] command.
51
-
52
-
```azurecli-interactive
53
-
az provider register --namespace Microsoft.ContainerService
54
-
```
55
-
56
17
### Create config files
57
18
19
+
OS and kubelet configuration changes require you to create a new configuration file with the parameters and your desired settings. If a value for a parameter is not specified, then the value will be set to the default.
20
+
58
21
#### Kubelet configuration
59
22
60
23
### [Linux node pools](#tab/linux-node-pools)
@@ -197,7 +160,7 @@ Kubelet custom configuration is supported for Linux and Windows node pools. Supp
197
160
|`containerLogMaxFiles`| ≥ 2 | 5 | The maximum number of container log files that can be present for a container. |
198
161
|`podMaxPids`| -1 to kernel PID limit | -1 (∞)| The maximum amount of process IDs that can be running in a Pod |
199
162
200
-
#### Windows Kubelet custom configuration (preview)
0 commit comments