|
1 | 1 | ---
|
2 |
| -title: Enable Group Managed Service Accounts (GMSA) for your Windows Server nodes on your Azure Kubernetes Service (AKS) cluster (Preview) |
| 2 | +title: Enable Group Managed Service Accounts (GMSA) for your Windows Server nodes on your Azure Kubernetes Service (AKS) cluster |
3 | 3 | description: Learn how to enable Group Managed Service Accounts (GMSA) for your Windows Server nodes on your Azure Kubernetes Service (AKS) cluster for securing your pods.
|
4 | 4 | services: container-service
|
5 | 5 | ms.topic: article
|
6 | 6 | ms.date: 11/01/2021
|
7 | 7 | ---
|
8 | 8 |
|
9 |
| -# Enable Group Managed Service Accounts (GMSA) for your Windows Server nodes on your Azure Kubernetes Service (AKS) cluster (Preview) |
| 9 | +# Enable Group Managed Service Accounts (GMSA) for your Windows Server nodes on your Azure Kubernetes Service (AKS) cluster |
10 | 10 |
|
11 | 11 | [Group Managed Service Accounts (GMSA)][gmsa-overview] is a managed domain account for multiple servers that provides automatic password management, simplified service principal name (SPN) management and the ability to delegate the management to other administrators. AKS provides the ability to enable GMSA on your Windows Server nodes, which allows containers running on Windows Server nodes to integrate with and be managed by GMSA.
|
12 | 12 |
|
13 |
| -Enabling GMSA with Windows Server nodes on AKS is in preview. |
14 |
| - |
15 |
| -[!INCLUDE [preview features callout](./includes/preview/preview-callout.md)] |
16 | 13 |
|
17 | 14 | ## Pre-requisites
|
18 | 15 |
|
19 | 16 | Enabling GMSA with Windows Server nodes on AKS requires:
|
20 | 17 |
|
21 | 18 | * Kubernetes 1.19 or greater.
|
22 |
| -* The `aks-preview` extension version 0.5.37 or greater. |
23 |
| -* The Docker container runtime, which is currently the default. |
| 19 | +* Azure CLI version 2.35.0 or greater |
24 | 20 | * [Managed identities][aks-managed-id] with your AKS cluster.
|
25 | 21 | * Permissions to create or update an Azure Key Vault.
|
26 | 22 | * Permissions to configure GMSA on Active Directory Domain Service or on-prem Active Directory.
|
27 | 23 | * The domain controller must have Active Directory Web Services enabled and must be reachable on port 9389 by the AKS cluster.
|
28 | 24 |
|
29 |
| -### Install the `aks-preview` Azure CLI |
30 |
| - |
31 |
| -You will need the *aks-preview* Azure CLI extension. Install the *aks-preview* Azure CLI extension by using the [az extension add][az-extension-add] command. Or install any available updates by using the [az extension update][az-extension-update] command. |
32 |
| - |
33 |
| -```azurecli-interactive |
34 |
| -# Install the aks-preview extension |
35 |
| -az extension add --name aks-preview |
36 |
| -
|
37 |
| -# Update the extension to make sure you have the latest version installed |
38 |
| -az extension update --name aks-preview |
39 |
| -``` |
40 |
| - |
41 |
| -### Register the `AKSWindowsGmsaPreview` preview feature |
42 |
| - |
43 |
| -To use the feature, you must also enable the `AKSWindowsGmsaPreview` feature flag on your subscription. |
44 |
| - |
45 |
| -Register the `AKSWindowsGmsaPreview` feature flag by using the [az feature register][az-feature-register] command, as shown in the following example: |
46 |
| - |
47 |
| -```azurecli-interactive |
48 |
| -az feature register --namespace "Microsoft.ContainerService" --name "AKSWindowsGmsaPreview" |
49 |
| -``` |
50 |
| - |
51 |
| -It takes a few minutes for the status to show *Registered*. Verify the registration status by using the [az feature list][az-feature-list] command: |
52 |
| - |
53 |
| -```azurecli-interactive |
54 |
| -az feature list -o table --query "[?contains(name, 'Microsoft.ContainerService/AKSWindowsGmsaPreview')].{Name:name,State:properties.state}" |
55 |
| -``` |
56 |
| - |
57 |
| -When ready, refresh the registration of the *Microsoft.ContainerService* resource provider by using the [az provider register][az-provider-register] command: |
58 |
| - |
59 |
| -```azurecli-interactive |
60 |
| -az provider register --namespace Microsoft.ContainerService |
61 |
| -``` |
62 |
| - |
63 | 25 | ## Configure GMSA on Active Directory domain controller
|
64 | 26 |
|
65 | 27 | To use GMSA with AKS, you need both GMSA and a standard domain user credential to access the GMSA credential configured on your domain controller. To configure GMSA on your domain controller, see [Getting Started with Group Managed Service Accounts][gmsa-getting-started]. For the standard domain user credential, you can use an existing user or create a new one, as long as it has access to the GMSA credential.
|
|
0 commit comments