Skip to content

Commit

Permalink
Document the use of mixed protocol values for LoadBalancer Type of Se…
Browse files Browse the repository at this point in the history
…rvices
  • Loading branch information
Laszlo Janosi committed Nov 3, 2020
1 parent dbce914 commit 012dcd5
Showing 1 changed file with 17 additions and 4 deletions.
21 changes: 17 additions & 4 deletions content/en/docs/concepts/services-networking/service.md
Original file line number Diff line number Diff line change
Expand Up @@ -578,10 +578,6 @@ status:

Traffic from the external load balancer is directed at the backend Pods. The cloud provider decides how it is load balanced.

For LoadBalancer type of Services, when there is more than one port defined, all
ports must have the same protocol, and the protocol must be one which is supported
by the cloud provider.

Some cloud providers allow you to specify the `loadBalancerIP`. In those cases, the load-balancer is created
with the user-specified `loadBalancerIP`. If the `loadBalancerIP` field is not specified,
the loadBalancer is set up with an ephemeral IP address. If you specify a `loadBalancerIP`
Expand All @@ -599,6 +595,23 @@ Specify the assigned IP address as loadBalancerIP. Ensure that you have updated

{{< /note >}}

#### Load balancers with mixed protocol types

{{< feature-state for_k8s_version="v1.20" state="alpha" >}}

By default, for LoadBalancer type of Services, when there is more than one port defined, all
ports must have the same protocol, and the protocol must be one which is supported
by the cloud provider.

If the feature gate `MixedProtocolLBService` is enabled for the kube-apiserver it is allowed to use different protocols when there is more than one port defined.

{{< note >}}

The set of protocols that can be used for LoadBalancer type of Services is still defined by the cloud provider.

{{< /note >}}


#### Internal load balancer

In a mixed environment it is sometimes necessary to route traffic from Services inside the same
Expand Down

0 comments on commit 012dcd5

Please sign in to comment.