Skip to content

Commit 7acd9b3

Browse files
authored
Merge pull request #31599 from TBBle/patch-1
Tidy docs for ServiceLoadBalancerClass and ServiceLBNodePortControl features
2 parents f0cb43f + db2b66e commit 7acd9b3

File tree

1 file changed

+12
-5
lines changed
  • content/en/docs/concepts/services-networking

1 file changed

+12
-5
lines changed

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

Lines changed: 12 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -684,21 +684,28 @@ The set of protocols that can be used for LoadBalancer type of Services is still
684684

685685
#### Disabling load balancer NodePort allocation {#load-balancer-nodeport-allocation}
686686

687-
{{< feature-state for_k8s_version="v1.20" state="alpha" >}}
687+
{{< feature-state for_k8s_version="v1.22" state="beta" >}}
688688

689-
Starting in v1.20, you can optionally disable node port allocation for a Service Type=LoadBalancer by setting
689+
You can optionally disable node port allocation for a Service of `type=LoadBalancer`, by setting
690690
the field `spec.allocateLoadBalancerNodePorts` to `false`. This should only be used for load balancer implementations
691691
that route traffic directly to pods as opposed to using node ports. By default, `spec.allocateLoadBalancerNodePorts`
692692
is `true` and type LoadBalancer Services will continue to allocate node ports. If `spec.allocateLoadBalancerNodePorts`
693-
is set to `false` on an existing Service with allocated node ports, those node ports will NOT be de-allocated automatically.
693+
is set to `false` on an existing Service with allocated node ports, those node ports will **not** be de-allocated automatically.
694694
You must explicitly remove the `nodePorts` entry in every Service port to de-allocate those node ports.
695-
You must enable the `ServiceLBNodePortControl` feature gate to use this field.
695+
Your cluster must have the `ServiceLBNodePortControl`
696+
[feature gate](/docs/reference/command-line-tools-reference/feature-gates/)
697+
enabled to use this field.
698+
For Kubernetes v{{< skew currentVersion >}}, this feature gate is enabled by default,
699+
and you can use the `spec.allocateLoadBalancerNodePorts` field. For clusters running
700+
other versions of Kubernetes, check the documentation for that release.
696701

697702
#### Specifying class of load balancer implementation {#load-balancer-class}
698703

699704
{{< feature-state for_k8s_version="v1.22" state="beta" >}}
700705

701-
`spec.loadBalancerClass` enables you to use a load balancer implementation other than the cloud provider default. This feature is available from v1.21, you must enable the `ServiceLoadBalancerClass` feature gate to use this field in v1.21, and the feature gate is enabled by default from v1.22 onwards.
706+
`spec.loadBalancerClass` enables you to use a load balancer implementation other than the cloud provider default.
707+
Your cluster must have the `ServiceLoadBalancerClass` [feature gate](/docs/reference/command-line-tools-reference/feature-gates/) enabled to use this field. For Kubernetes v{{< skew currentVersion >}}, this feature gate is enabled by default. For clusters running
708+
other versions of Kubernetes, check the documentation for that release.
702709
By default, `spec.loadBalancerClass` is `nil` and a `LoadBalancer` type of Service uses
703710
the cloud provider's default load balancer implementation if the cluster is configured with
704711
a cloud provider using the `--cloud-provider` component flag.

0 commit comments

Comments
 (0)