Skip to content

Commit eb4237d

Browse files
Merge pull request #252653 from chasewilson/chase/staticIp-PipNameAnnotation
Adds info about `service.beta.kubernetes.io/azure-pip-name` to ensure…
2 parents 80dde30 + e044f9b commit eb4237d

File tree

1 file changed

+6
-1
lines changed

1 file changed

+6
-1
lines changed

articles/aks/static-ip.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ author: asudbring
66
ms.author: allensu
77
ms.subservice: aks-networking
88
ms.topic: how-to
9-
ms.date: 02/27/2023
9+
ms.date: 09/22/2023
1010

1111
#Customer intent: As a cluster operator or developer, I want to create and manage static IP address resources in Azure that I can use beyond the lifecycle of an individual Kubernetes service deployed in an AKS cluster.
1212
---
@@ -91,6 +91,7 @@ This article shows you how to create a static public IP address and assign it to
9191
annotations:
9292
service.beta.kubernetes.io/azure-load-balancer-resource-group: <node resource group>
9393
service.beta.kubernetes.io/azure-load-balancer-ipv4: <public IP address>
94+
service.beta.kubernetes.io/azure-pip-name: <public IP Name>
9495
name: azure-load-balancer
9596
spec:
9697
type: LoadBalancer
@@ -100,6 +101,9 @@ This article shows you how to create a static public IP address and assign it to
100101
app: azure-load-balancer
101102
```
102103
104+
> [!NOTE]
105+
> Adding the `service.beta.kubernetes.io/azure-pip-name` annotation ensures the most efficient LoadBalancer creation and is highly recommended to avoid potential throttling.
106+
103107
3. Set a public-facing DNS label to the service using the `service.beta.kubernetes.io/azure-dns-label-name` service annotation. This publishes a fully qualified domain name (FQDN) for your service using Azure's public DNS servers and top-level domain. The annotation value must be unique within the Azure location, so we recommend you use a sufficiently qualified label. Azure automatically appends a default suffix in the location you selected, such as `<location>.cloudapp.azure.com`, to the name you provide, creating the FQDN.
104108
105109
> [!NOTE]
@@ -112,6 +116,7 @@ This article shows you how to create a static public IP address and assign it to
112116
annotations:
113117
service.beta.kubernetes.io/azure-load-balancer-resource-group: <node resource group>
114118
service.beta.kubernetes.io/azure-load-balancer-ipv4: <public IP address>
119+
service.beta.kubernetes.io/azure-pip-name: <public IP Name>
115120
service.beta.kubernetes.io/azure-dns-label-name: <unique-service-label>
116121
name: azure-load-balancer
117122
spec:

0 commit comments

Comments
 (0)