Skip to content

Commit 5f87b81

Browse files
committed
More edits to the doc to clarify FQDN/DNS label information:
1 parent 77adf0f commit 5f87b81

File tree

1 file changed

+12
-7
lines changed

1 file changed

+12
-7
lines changed

articles/aks/ingress-tls.md

Lines changed: 12 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -225,7 +225,10 @@ If you're using a custom domain, you need to add an *A* record to your DNS zone.
225225
226226
### Configure an FQDN for your ingress controller
227227
228-
Optionally, you can configure an FQDN for the ingress controller IP address instead of a custom domain by setting a DNS label. Your FQDN should follow this form: `<CUSTOM LABEL>.<AZURE REGION NAME>.cloudapp.azure.com`. Your DNS label must be unique within its Azure location.
228+
Optionally, you can configure an FQDN for the ingress controller IP address instead of a custom domain by setting a DNS label. Your FQDN should follow this form: `<CUSTOM DNS LABEL>.<AZURE REGION NAME>.cloudapp.azure.com`.
229+
230+
> [!IMPORTANT]
231+
> Your DNS label must be unique within its Azure location.
229232
230233
You can configure your FQDN using one of the following methods:
231234
@@ -236,20 +239,22 @@ For more information, see [Public IP address DNS name labels](../virtual-network
236239
237240
#### Set the DNS label using Azure CLI or Azure PowerShell
238241
242+
Make sure to replace `<DNS_LABEL>` with your unique DNS label.
243+
239244
### [Azure CLI](#tab/azure-cli)
240245
241246
```azurecli
242247
# Public IP address of your ingress controller
243248
IP="MY_EXTERNAL_IP"
244249
245250
# Name to associate with public IP address
246-
DNSNAME="demo-aks-ingress"
251+
DNSLABEL="<DNS_LABEL>"
247252
248253
# Get the resource-id of the public IP
249254
PUBLICIPID=$(az network public-ip list --query "[?ipAddress!=null]|[?contains(ipAddress, '$IP')].[id]" --output tsv)
250255
251256
# Update public IP address with DNS name
252-
az network public-ip update --ids $PUBLICIPID --dns-name $DNSNAME
257+
az network public-ip update --ids $PUBLICIPID --dns-name $DNSLABEL
253258
254259
# Display the FQDN
255260
az network public-ip show --ids $PUBLICIPID --query "[dnsSettings.fqdn]" --output tsv
@@ -265,7 +270,7 @@ $AksIpAddress = "MY_EXTERNAL_IP"
265270
$PublicIp = Get-AzPublicIpAddress | Where-Object {$_.IpAddress -eq $AksIpAddress}
266271
267272
# Update public IP address with DNS name
268-
$PublicIp.DnsSettings = @{"DomainNameLabel" = "demo-aks-ingress"}
273+
$PublicIp.DnsSettings = @{"DomainNameLabel" = "<DNS_LABEL>"}
269274
$UpdatedPublicIp = Set-AzPublicIpAddress -PublicIpAddress $publicIp
270275
271276
# Display the FQDN
@@ -278,17 +283,17 @@ Write-Output $UpdatedPublicIp.DnsSettings.Fqdn
278283

279284
You can pass an annotation setting to your Helm chart configuration using the `--set controller.service.annotations."service\.beta\.kubernetes\.io/azure-dns-label-name"` parameter. This parameter can be set when the ingress controller is first deployed, or it can be configured later.
280285

281-
The following example shows how to update this setting after the controller has been deployed.
286+
The following example shows how to update this setting after the controller has been deployed. Make sure to replace `<DNS_LABEL>` with your unique DNS label.
282287

283288
### [Azure CLI](#tab/azure-cli)
284289

285290
```bash
286-
DNS_LABEL="<DNS_LABEL>"
291+
DNSLABEL="<DNS_LABEL>"
287292
NAMESPACE="ingress-basic"
288293

289294
helm upgrade ingress-nginx ingress-nginx/ingress-nginx \
290295
--namespace $NAMESPACE \
291-
--set controller.service.annotations."service\.beta\.kubernetes\.io/azure-dns-label-name"=$DNS_LABEL
296+
--set controller.service.annotations."service\.beta\.kubernetes\.io/azure-dns-label-name"=$DNSLABEL
292297
```
293298

294299
### [Azure PowerShell](#tab/azure-powershell)

0 commit comments

Comments
 (0)