Skip to content

Commit 9af1112

Browse files
Merge pull request #269220 from schaffererin/custom-kubelet-and-gen-2-ga-2
Custom kubelet and gen 2 VM GA - New PR
2 parents a02563a + f56e30c commit 9af1112

File tree

3 files changed

+11
-86
lines changed

3 files changed

+11
-86
lines changed

articles/aks/cluster-configuration.md

Lines changed: 7 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -62,63 +62,25 @@ Additionally, not all VM images support Gen2 VMs. On AKS, Gen2 VMs use [AKS Ubun
6262

6363
Gen2 VMs are supported on Linux. Gen2 VMs on Windows are supported for WS2022 only.
6464

65-
### Generation 2 virtual machines on Windows (preview)
65+
### Generation 2 virtual machines on Windows
6666

67-
[!INCLUDE [preview features callout](includes/preview/preview-callout.md)]
67+
#### Limitations
6868

6969
* Generation 2 VMs are supported on Windows for WS2022 only.
7070
* 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`.
10772

10873
#### Add a Windows node pool with a generation 2 VM
10974

11075
* Add a node pool with generation 2 VMs on Windows using the [`az aks nodepool add`][az-aks-nodepool-add] command.
11176

11277
```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
11979
```
12080
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`.
12284
12385
```azurecli
12486
az aks nodepool show

articles/aks/custom-node-configuration.md

Lines changed: 3 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -14,47 +14,10 @@ Customizing your node configuration allows you to adjust operating system (OS) s
1414

1515
## Create an AKS cluster with a customized node configuration
1616

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-
5617
### Create config files
5718

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+
5821
#### Kubelet configuration
5922

6023
### [Linux node pools](#tab/linux-node-pools)
@@ -197,7 +160,7 @@ Kubelet custom configuration is supported for Linux and Windows node pools. Supp
197160
| `containerLogMaxFiles` | ≥ 2 | 5 | The maximum number of container log files that can be present for a container. |
198161
| `podMaxPids` | -1 to kernel PID limit | -1 (∞)| The maximum amount of process IDs that can be running in a Pod |
199162

200-
#### Windows Kubelet custom configuration (preview)
163+
#### Windows Kubelet custom configuration
201164

202165
| Parameter | Allowed values/interval | Default | Description |
203166
| --------- | ----------------------- | ------- | ----------- |

articles/azure-monitor/containers/container-insights-data-collection-dcr.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -87,7 +87,7 @@ The **Collected data** option allows you to select the tables that are populated
8787

8888
> [!NOTE]
8989
> Minimum version required for Azure CLI is 2.51.0.
90-
- For AKS clusters, [aks-preview](../../aks/cluster-configuration.md#install-the-aks-preview-azure-cli-extension) version 0.5.147 or higher
90+
- For AKS clusters, [aks-preview](../../aks/cluster-configuration.md) version 0.5.147 or higher
9191
- For Arc enabled Kubernetes and AKS hybrid, [k8s-extension](../../azure-arc/kubernetes/extensions.md#prerequisites) version 1.4.3 or higher
9292

9393
## AKS cluster

0 commit comments

Comments
 (0)