Skip to content

Commit b175095

Browse files
committed
Deprecation Note addedi for loadbalancerIP
1 parent 8aab3e9 commit b175095

File tree

1 file changed

+10
-16
lines changed
  • content/en/docs/concepts/services-networking

1 file changed

+10
-16
lines changed

content/en/docs/concepts/services-networking/service.md

Lines changed: 10 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -645,12 +645,6 @@ status:
645645
Traffic from the external load balancer is directed at the backend Pods.
646646
The cloud provider decides how it is load balanced.
647647

648-
Some cloud providers allow you to specify the `loadBalancerIP`. In those cases, the load-balancer is created
649-
with the user-specified `loadBalancerIP`. If the `loadBalancerIP` field is not specified,
650-
the loadBalancer is set up with an ephemeral IP address. If you specify a `loadBalancerIP`
651-
but your cloud provider does not support the feature, the `loadbalancerIP` field that you
652-
set is ignored.
653-
654648
To implement a Service of `type: LoadBalancer`, Kubernetes typically starts off
655649
by making the changes that are equivalent to you requesting a Service of
656650
`type: NodePort`. The cloud-controller-manager component then configures the external load balancer to
@@ -663,16 +657,16 @@ cloud provider implementation supports this.
663657

664658
{{< note >}}
665659

666-
On **Azure**, if you want to use a user-specified public type `loadBalancerIP`, you first need
667-
to create a static type public IP address resource. This public IP address resource should
668-
be in the same resource group of the other automatically created resources of the cluster.
669-
For example, `MC_myResourceGroup_myAKSCluster_eastus`.
670-
671-
Specify the assigned IP address as loadBalancerIP. Ensure that you have updated the
672-
`securityGroupName` in the cloud provider configuration file.
673-
For information about troubleshooting `CreatingLoadBalancerFailed` permission issues see,
674-
[Use a static IP address with the Azure Kubernetes Service (AKS) load balancer](https://docs.microsoft.com/en-us/azure/aks/static-ip)
675-
or [CreatingLoadBalancerFailed on AKS cluster with advanced networking](https://github.com/Azure/AKS/issues/357).
660+
The`.spec.loadBalancerIP` field for a Service was deprecated in Kubernetes v1.24.
661+
662+
This field was under-specified and its meaning varies across implementations. It also cannot support dual-stack networking. This field may be removed in a future API version.
663+
664+
If you're integrating with a provider that supports specifying the load balancer IP address(es)
665+
for a Service via a (provider specific) annotation, you should switch to doing that.
666+
667+
If you are writing code for a load balancer integration with Kubernetes, avoid using this field.
668+
You can integrate with [Gateway](https://gateway-api.sigs.k8s.io/) rather than Service, or you
669+
can define your own (provider specific) annotations on the Service that specify the equivalent detail.
676670

677671
{{< /note >}}
678672

0 commit comments

Comments
 (0)