Skip to content

Commit b7b35c6

Browse files
Merge pull request #177682 from miwithro/patch-85
Update private-clusters.md
2 parents 9d5aa41 + f272add commit b7b35c6

File tree

1 file changed

+49
-2
lines changed

1 file changed

+49
-2
lines changed

articles/aks/private-clusters.md

Lines changed: 49 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -77,14 +77,61 @@ The following parameters can be leveraged to configure Private DNS Zone.
7777
```azurecli-interactive
7878
az aks create -n <private-cluster-name> -g <private-cluster-resource-group> --load-balancer-sku standard --enable-private-cluster --enable-managed-identity --assign-identity <ResourceId> --private-dns-zone [system|none]
7979
```
80+
### Create a private AKS cluster with a BYO Private DNS SubZone (Preview)
8081

81-
### Create a private AKS cluster with a Custom Private DNS Zone
82+
Prerequisites:
83+
84+
* Azure CLI >= 2.29.0 or Azure CLI with aks-preview extension 0.5.34 or later.
85+
86+
### Register the `EnablePrivateClusterSubZone` preview feature
87+
88+
[!INCLUDE [preview features callout](./includes/preview/preview-callout.md)]
89+
90+
To create an AKS cluster that can use the Secrets Store CSI Driver, you must enable the `EnablePrivateClusterSubZone` feature flag on your subscription.
91+
92+
Register the `EnablePrivateClusterSubZone` feature flag by using the [az feature register][az-feature-register] command, as shown in the following example:
93+
94+
```azurecli-interactive
95+
az feature register --namespace "Microsoft.ContainerService" --name "EnablePrivateClusterSubZone"
96+
```
97+
98+
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:
99+
100+
```azurecli-interactive
101+
az feature list -o table --query "[?contains(name, 'Microsoft.ContainerService/EnablePrivateClusterSubZone')].{Name:name,State:properties.state}"
102+
```
103+
104+
When ready, refresh the registration of the *Microsoft.ContainerService* resource provider by using the [az provider register][az-provider-register] command:
105+
106+
```azurecli-interactive
107+
az provider register --namespace Microsoft.ContainerService
108+
```
109+
110+
### Install the aks-preview CLI extension
111+
112+
You also need the *aks-preview* Azure CLI extension version 0.5.34 or later. Install the *aks-preview* Azure CLI extension by using the [az extension add][az-extension-add] command. If you already have the extension installed, update to the latest available version by using the [az extension update][az-extension-update] command.
113+
114+
```azurecli-interactive
115+
# Install the aks-preview extension
116+
az extension add --name aks-preview
117+
118+
# Update the extension to make sure you have the latest version installed
119+
az extension update --name aks-preview
120+
```
121+
122+
### Private AKS cluster with BYO Private DNS SubZone
123+
124+
```azurecli-interactive
125+
az aks create -n <private-cluster-name> -g <private-cluster-resource-group> --load-balancer-sku standard --enable-private-cluster --enable-managed-identity --assign-identity <ResourceId> --private-dns-zone <BYO private dns zone ResourceId>
126+
```
127+
128+
### Create a private AKS cluster with Custom Private DNS SubZone
82129

83130
```azurecli-interactive
84131
az aks create -n <private-cluster-name> -g <private-cluster-resource-group> --load-balancer-sku standard --enable-private-cluster --enable-managed-identity --assign-identity <ResourceId> --private-dns-zone <custom private dns zone ResourceId> --fqdn-subdomain <subdomain-name>
85132
```
86133

87-
## Create a private AKS cluster with a Public FQDN
134+
### Create a private AKS cluster with a Public FQDN
88135

89136
Prerequisites:
90137

0 commit comments

Comments
 (0)