Skip to content

Commit 88bed4b

Browse files
Merge pull request #201987 from miwithro/patch-149
Update use-azure-dedicated-hosts.md
2 parents e9852d6 + bc5f0da commit 88bed4b

File tree

1 file changed

+13
-9
lines changed

1 file changed

+13
-9
lines changed

articles/aks/use-azure-dedicated-hosts.md

Lines changed: 13 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -61,17 +61,17 @@ az provider register --namespace Microsoft.ContainerService
6161
The following limitations apply when you integrate Azure Dedicated Host with Azure Kubernetes Service:
6262

6363
* An existing agent pool can't be converted from non-ADH to ADH or ADH to non-ADH.
64-
* It is not supported to update agent pool from host group A to host group B.
64+
* It isn't supported to update agent pool from host group A to host group B.
6565
* Using ADH across subscriptions.
6666

6767
## Add a Dedicated Host Group to an AKS cluster
6868

69-
A host group is a resource that represents a collection of dedicated hosts. You create a host group in a region and an availability zone, and add hosts to it. When planning for high availability, there are additional options. You can use one or both of the following options with your dedicated hosts:
69+
A host group is a resource that represents a collection of dedicated hosts. You create a host group in a region and an availability zone, and add hosts to it. When planning for high availability, there are more options. You can use one or both of the following options with your dedicated hosts:
7070

71-
* Span across multiple availability zones. In this case, you are required to have a host group in each of the zones you wish to use.
71+
* Span across multiple availability zones. In this case, you're required to have a host group in each of the zones you wish to use.
7272
* Span across multiple fault domains, which are mapped to physical racks.
7373

74-
In either case, you need to provide the fault domain count for your host group. If you do not want to span fault domains in your group, use a fault domain count of 1.
74+
In either case, you need to provide the fault domain count for your host group. If you don't want to span fault domains in your group, use a fault domain count of 1.
7575

7676
You can also decide to use both availability zones and fault domains.
7777

@@ -81,15 +81,19 @@ Not all host SKUs are available in all regions, and availability zones. You can
8181
az vm list-skus -l eastus -r hostGroups/hosts -o table
8282
```
8383

84+
> [!NOTE]
85+
> First, when using host group, the nodepool fault domain count is always the same as the host group fault domain count. In order to use cluster auto-scaling to work with ADH and AKS, please make sure your host group fault domain count and capacity is enough.
86+
> Secondly, only change fault domain count from the default of 1 to any other number if you know what they are doing as a misconfiguration could lead to a unscalable configuration.
87+
8488
## Create a Host Group
8589

86-
Now create a dedicated host in the host group. In addition to a name for the host, you are required to provide the SKU for the host. Host SKU captures the supported VM series as well as the hardware generation for your dedicated host.
90+
Now create a dedicated host in the host group. In addition to a name for the host, you're required to provide the SKU for the host. Host SKU captures the supported VM series and the hardware generation for your dedicated host.
8791

8892
For more information about the host SKUs and pricing, see [Azure Dedicated Host pricing](https://azure.microsoft.com/pricing/details/virtual-machines/dedicated-host/).
8993

90-
Use az vm host create to create a host. If you set a fault domain count for your host group, you will be asked to specify the fault domain for your host.
94+
Use az vm host create to create a host. If you set a fault domain count for your host group, you'll be asked to specify the fault domain for your host.
9195

92-
In this example, we will use [az vm host group create][az-vm-host-group-create] to create a host group using both availability zones and fault domains.
96+
In this example, we'll use [az vm host group create][az-vm-host-group-create] to create a host group using both availability zones and fault domains.
9397

9498
```azurecli-interactive
9599
az vm host group create \
@@ -102,9 +106,9 @@ az vm host group create \
102106

103107
## Create a Dedicated Host
104108

105-
Now create a dedicated host in the host group. In addition to a name for the host, you are required to provide the SKU for the host. Host SKU captures the supported VM series as well as the hardware generation for your dedicated host.
109+
Now create a dedicated host in the host group. In addition to a name for the host, you're required to provide the SKU for the host. Host SKU captures the supported VM series and the hardware generation for your dedicated host.
106110

107-
If you set a fault domain count for your host group, you will need to specify the fault domain for your host.
111+
If you set a fault domain count for your host group, you'll need to specify the fault domain for your host.
108112

109113
```azurecli-interactive
110114
az vm host create \

0 commit comments

Comments
 (0)