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
Since AKS version 1.27 and above, enabling the KMS feature configures KMS V2. With KMS V2, you aren't limited to the 2,000 secrets support. For more information, you can refer to the[KMS V2 Improvements](https://kubernetes.io/blog/2023/05/16/kms-v2-moves-to-beta/).
352
+
Starting with AKS version 1.27, enabling the KMS feature configures KMS v2. With KMS v2, you aren't limited to the 2,000 secrets it supports. For more information, review[KMS V2 Improvements](https://kubernetes.io/blog/2023/05/16/kms-v2-moves-to-beta/).
353
353
354
354
### Migration to KMS v2
355
355
356
-
If your cluster version is less than 1.27 and you already enabled KMS, use the following steps to migrate to KMS V2:
356
+
If your cluster version is less than 1.27 and you already enabled KMS, use the following steps to migrate to KMS v2:
357
357
358
358
1. Disable KMS on the cluster.
359
359
2. Perform the storage migration.
360
360
3. Upgrade the cluster to version 1.27 or higher.
361
361
4. Re-enable KMS on the cluster.
362
-
5. Perform the storage migration
362
+
5. Perform the storage migration.
363
363
364
364
#### Disable KMS
365
365
366
-
Disable KMS on an existing cluster using the `az aks update` command with the `--disable-azure-keyvault-kms`flag.
366
+
To disable KMS on an existing cluster, use the `az aks update` command with the `--disable-azure-keyvault-kms`argument.
367
367
368
368
```azurecli-interactive
369
369
az aks update --name myAKSCluster --resource-group MyResourceGroup --disable-azure-keyvault-kms
370
370
```
371
371
372
372
#### Storage migration
373
373
374
-
Update all secrets using the `kubectl get secrets` command with the `--all-namespaces`flag.
374
+
To update all secrets, use the `kubectl get secrets` command with the `--all-namespaces`argument.
Upgrade the AKS cluster using the `az aks upgrade` command and specify your desired version as `1.27.x` or higher for `--kubernetes-version`.
382
+
To upgrade an AKS cluster, use the `az aks upgrade` command and specify the desired version as `1.27.x` or higher with the `--kubernetes-version` argument.
383
383
384
384
```azurecli-interactive
385
385
az aks upgrade --resource-group myResourceGroup --name myAKSCluster --kubernetes-version <AKS version>
386
386
```
387
387
388
-
Example:
388
+
For example:
389
389
390
390
```azurecli-interactive
391
391
az aks upgrade --resource-group myResourceGroup --name myAKSCluster --kubernetes-version 1.27.1
392
392
```
393
393
394
394
#### Re-enable KMS
395
395
396
-
You can reenable the KMS feature on the cluster to encrypt the secrets. After that, the AKS cluster uses KMS V2.
397
-
If you don’t want to do the KMS v2 migration, you can create a new 1.27+ cluster with KMS enabled.
396
+
You can reenable the KMS feature on the cluster to encrypt the secrets. Afterwards, the AKS cluster uses KMS v2.
397
+
If you don't want to do the KMS v2 migration, you can create a new version 1.27 and higher cluster with KMS enabled.
398
398
399
399
#### Storage migration
400
400
401
-
Re-encrypt all secrets under KMS V2 using the `kubectl get secrets` command with the `--all-namespaces`flag.
401
+
To re-encrypt all secrets under KMS v2, use the `kubectl get secrets` command with the `--all-namespaces`argument.
0 commit comments