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
Use the [New-MgDirectoryAdministrativeUnit](/powershell/module/microsoft.graph.identity.directorymanagement/new-mgdirectoryadministrativeunit) command to create a new administrative unit.
Copy file name to clipboardExpand all lines: articles/aks/private-clusters.md
+15-15Lines changed: 15 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,7 +3,7 @@ title: Create a private Azure Kubernetes Service cluster
3
3
description: Learn how to create a private Azure Kubernetes Service (AKS) cluster
4
4
services: container-service
5
5
ms.topic: article
6
-
ms.date: 12/13/2022
6
+
ms.date: 01/25/2023
7
7
ms.custom: references_regions
8
8
---
9
9
@@ -23,8 +23,8 @@ Private cluster is available in public regions, Azure Government, and Azure Chin
23
23
24
24
## Prerequisites
25
25
26
-
* The Azure CLI version 2.28.0 and higher.
27
-
* The aks-preview extension 0.5.29 or higher.
26
+
* The Azure CLI version 2.28.0 and higher. Run `az --version` to find the version, and run `az upgrade` to upgrade the version. If you need to install or upgrade, see [Install Azure CLI][install-azure-cli].
27
+
* The `aks-preview` extension 0.5.29 or higher.
28
28
* If using Azure Resource Manager (ARM) or the Azure REST API, the AKS API version must be 2021-05-01 or higher.
29
29
* Azure Private Link service is supported on Standard Azure Load Balancer only. Basic Azure Load Balancer isn't supported.
30
30
* To use a custom DNS server, add the Azure public IP address 168.63.129.16 as the upstream DNS server in the custom DNS server. For more information about the Azure IP address, see [What is IP address 168.63.129.16?][virtual-networks-168.63.129.16]
@@ -96,33 +96,30 @@ az aks create -n <private-cluster-name> -g <private-cluster-resource-group> --lo
96
96
az aks update -n <private-cluster-name> -g <private-cluster-resource-group> --disable-public-fqdn
97
97
```
98
98
99
-
## Configure Private DNS Zone
99
+
## Configure private DNS zone
100
100
101
-
The following parameters can be used to configure Private DNS Zone.
101
+
The following parameters can be used to configure private DNS zone.
102
102
103
-
-**system**, which is also the default value. If the `--private-dns-zone` argument is omitted, AKS will create a Private DNS Zone in the Node Resource Group.
104
-
-**none**, defaults to public DNS which means AKS will not create a Private DNS Zone.
105
-
-**CUSTOM_PRIVATE_DNS_ZONE_RESOURCE_ID**, which requires you to create a Private DNS Zone in this format for Azure global cloud: `privatelink.<region>.azmk8s.io` or `<subzone>.privatelink.<region>.azmk8s.io`. You'll need the Resource ID of that Private DNS Zone going forward. Additionally, you need a user assigned identity or service principal with at least the `private dns zone contributor` and `network contributor` roles.
106
-
- If the Private DNS Zone is in a different subscription than the AKS cluster, you need to register the Azure provider **Microsoft.ContainerServices** in both subscriptions.
103
+
-**system** - This is the default value. If the `--private-dns-zone` argument is omitted, AKS creates a Private DNS zone in the node resource group.
104
+
-**none** - the default is public DNS. AKS won't create a private DNS zone.
105
+
-**CUSTOM_PRIVATE_DNS_ZONE_RESOURCE_ID**, requires you to create a private DNS zone only in the following format for Azure global cloud: `privatelink.<region>.azmk8s.io` or `<subzone>.privatelink.<region>.azmk8s.io`. You'll need the Resource ID of that private DNS zone going forward. Additionally, you need a user assigned identity or service principal with at least the [Private DNS Zone Contributor][private-dns-zone-contributor-role] and [Network Contributor][network-contributor-role] roles. When deploying using API server VNet integration, a private DNS zone additionally supports the naming format of `private.<region>.azmk8s.io` or `<subzone>.private.<region>.azmk8s.io`.
106
+
- If the private DNS zone is in a different subscription than the AKS cluster, you need to register the Azure provider **Microsoft.ContainerServices** in both subscriptions.
107
107
- "fqdn-subdomain" can be utilized with "CUSTOM_PRIVATE_DNS_ZONE_RESOURCE_ID" only to provide subdomain capabilities to `privatelink.<region>.azmk8s.io`
108
108
109
-
> [!NOTE]
110
-
> Deploying a private link-based AKS cluster only supports a Private DNS Zone using the following naming format `privatelink.<region>.azmk8s.io` or `<subzone>-privatelink.<region>.azmk8s.io`. When deploying using API server VNet integration, a Private DNS Zone additionally supports the naming format of `private.<region>.azmk8s.io` or `<subzone>-private.<region>.azmk8s.io`.
111
-
112
-
### Create a private AKS cluster with Private DNS Zone
109
+
### Create a private AKS cluster with private DNS zone
113
110
114
111
```azurecli-interactive
115
112
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]
116
113
```
117
114
118
-
### Create a private AKS cluster with Custom Private DNS Zone or Private DNS SubZone
115
+
### Create a private AKS cluster with custom private DNS zone or private DNS subzone
119
116
120
117
```azurecli-interactive
121
118
# Custom Private DNS Zone name should be in format "<subzone>.privatelink.<region>.azmk8s.io"
122
119
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 or custom private dns subzone ResourceId>
123
120
```
124
121
125
-
### Create a private AKS cluster with Custom Private DNS Zone and Custom Subdomain
122
+
### Create a private AKS cluster with custom private DNS zone and custom subdomain
126
123
127
124
```azurecli-interactive
128
125
# Custom Private DNS Zone name could be in formats "privatelink.<region>.azmk8s.io" or "<subzone>.privatelink.<region>.azmk8s.io"
@@ -276,3 +273,6 @@ For associated best practices, see [Best practices for network connectivity and
0 commit comments