diff --git a/docs/enterprise/installing-kurl-airgap.mdx b/docs/enterprise/installing-kurl-airgap.mdx index 3735679ad2..edf579e37d 100644 --- a/docs/enterprise/installing-kurl-airgap.mdx +++ b/docs/enterprise/installing-kurl-airgap.mdx @@ -1,5 +1,4 @@ import KurlAbout from "../partials/install/_kurl-about.mdx" -import HaLoadBalancerAbout from "../partials/install/_ha-load-balancer-about.mdx" import IntroEmbedded from "../partials/install/_intro-embedded.mdx" import IntroAirGap from "../partials/install/_intro-air-gap.mdx" import PrereqsEmbeddedCluster from "../partials/install/_prereqs-embedded-cluster.mdx" @@ -18,12 +17,6 @@ import ExtractKurlBundle from "../partials/install/_extract-kurl-bundle.mdx" -## About High Availability Mode - -Air gap installations can use high availability (HA) mode with the kURL installer. - - - ## Prerequisites Complete the following prerequisites: diff --git a/docs/enterprise/installing-kurl.mdx b/docs/enterprise/installing-kurl.mdx index 360df7228a..d7bd2dec20 100644 --- a/docs/enterprise/installing-kurl.mdx +++ b/docs/enterprise/installing-kurl.mdx @@ -1,5 +1,4 @@ import KurlAbout from "../partials/install/_kurl-about.mdx" -import HaLoadBalancerAbout from "../partials/install/_ha-load-balancer-about.mdx" import IntroEmbedded from "../partials/install/_intro-embedded.mdx" import PrereqsEmbeddedCluster from "../partials/install/_prereqs-embedded-cluster.mdx" import HaLoadBalancerPrereq from "../partials/install/_ha-load-balancer-prereq.mdx" @@ -14,12 +13,6 @@ import AppNameUI from "../partials/install/_placeholder-app-name-UI.mdx" -## About High Availability Mode - -Online installations can use high availability (HA) mode with the kURL installer. - - - ## Prerequisites Complete the following prerequisites: diff --git a/docs/partials/install/_embedded-ha-step.mdx b/docs/partials/install/_embedded-ha-step.mdx index 2f124a4fab..477c9184b1 100644 --- a/docs/partials/install/_embedded-ha-step.mdx +++ b/docs/partials/install/_embedded-ha-step.mdx @@ -1,4 +1,4 @@ -(High Availability Only) If you did not preconfigure a load balancer, you are prompted during the installation. Do one of the following: +(HA Installation Only) If you are installing in HA mode and did not already preconfigure a load balancer, you are prompted during the installation. Do one of the following: - If you are using the internal load balancer, leave the prompt blank and proceed with the installation. diff --git a/docs/partials/install/_ha-load-balancer-prereq.mdx b/docs/partials/install/_ha-load-balancer-prereq.mdx index 2381ccadd2..0c87fdec1b 100644 --- a/docs/partials/install/_ha-load-balancer-prereq.mdx +++ b/docs/partials/install/_ha-load-balancer-prereq.mdx @@ -1,6 +1,12 @@ -- If you are installing in high availability mode: - - (Optional) If you are going to use the internal load balancer, you can preconfigure it by passing `| sudo bash -s ha ekco-enable-internal-load-balancer`. - - For an external load balancer, ensure that your load balancer is: - - A TCP forwarding external load balancer. - - Configured to distribute traffic to all healthy control plane nodes in its target list. - - (Optional) Preconfigured by passing the `load-balancer-address=HOST:PORT` flag. \ No newline at end of file +- If you are installing in high availability (HA) mode, a load balancer is required. You can use the kURL internal load balancer if the [Embedded kURL Cluster Operator (EKCO) Add-On](https://kurl.sh/docs/add-ons/ekco) is included in the kURL Installer spec. Or, you can bring your own external load balancer. An external load balancer might be preferred when clients outside the cluster need access to the cluster's Kubernetes API. + + To install in HA mode, complete the following prerequisites: + - (Optional) If you are going to use the internal EKCO load balancer, you can preconfigure it by passing `| sudo bash -s ha ekco-enable-internal-load-balancer` with the kURL install command. Otherwise, you are prompted for load balancer details during installation. For more information about the EKCO Add-on, see [EKCO Add-On](https://kurl.sh/docs/add-ons/ekco) in the open source kURL documentation. + - To use an external load balancer, ensure that the load balancer meets the following requirements: + - Must be a TCP forwarding load balancer + - Must be configured to distribute traffic to all healthy control plane nodes in its target list + - The health check must be a TCP check on port 6443 + + For more information about how to create a load balancer for kube-apirserver, see [Create load balancer for kube-apiserver](https://kubernetes.io/docs/setup/production-environment/tools/kubeadm/high-availability/#create-load-balancer-for-kube-apiserver) in the Kubernetes documentation. + + You can optionally preconfigure the external loader by passing the `load-balancer-address=HOST:PORT` flag with the kURL install command. Otherwise, you are prompted to provide the load balancer address during installation. \ No newline at end of file