Skip to content

openshift/enable-internal-lb

Enable OpenShift-managed internal load balancer (keepalived) for the cluster

Controls whether the OpenShift-managed internal load balancer is configured for the cluster. When enabled, the install-config.yaml will include an explicit loadBalancer.type: OpenShiftManagedDefault declaration, directing OpenShift to deploy and manage keepalived for API and Ingress VIP failover.

Default Behavior (disabled)

When false (the default), no loadBalancer section is added to the platform configuration. This is appropriate when an external load balancer (e.g. F5, HAProxy, cloud NLB) is already handling the API and Ingress VIPs defined by openshift/api-vip and openshift/ingress-vip.

When to Enable

Set to true for bare-metal or on-premises deployments where no external load balancer is available and you want OpenShift to manage VIP failover automatically via keepalived across the control plane nodes.

Requirements (when enabled)

  • openshift/api-vip must be set to a free IP in the machine network
  • openshift/ingress-vip must be set to a free IP in the machine network
  • Both VIPs must be reachable from all cluster nodes
  • Multi-node cluster (keepalived is not used for SNO deployments)

Objects that Reference openshift/enable-internal-lb

Objects used by openshift/enable-internal-lb

Not used in current content packs