vSphere Bootstrap

Prepare to deploy Kubernetes clusters

To create Kubernetes clusters, Konvoy uses Cluster API (CAPI) controllers which run on a Kubernetes cluster. To get started creating your vSphere cluster, you need a bootstrap cluster. By default, Konvoy creates a bootstrap cluster for you in a Docker container using the Kubernetes-in-Docker (KIND) tool.

Prerequisites

Before you begin, you must:

• Ensure the dkp binary can be found in your $PATH.

• Complete the steps in Create a CAPI VM template

Bootstrap cluster lifecycle services

1. If an HTTP proxy is required for the bootstrap cluster, set the local http_proxy, https_proxy, and no_proxy environment variables. They are copied into the bootstrap cluster.

2. Create a bootstrap cluster:

   CODE

   dkp create bootstrap --kubeconfig $HOME/.kube/config

   If your environment uses HTTP/HTTPS proxies, you must include the flags --http-proxy, --https-proxy, and --no-proxy and their related values in this command for it to be successful. More information is available in Configure HTTP Proxy.
   

   The output resembles this example:

   CODE

   ✓ Creating a bootstrap cluster
   ✓ Initializing new CAPI components

   Konvoy creates a bootstrap cluster using KIND as a library. Konvoy then deploys the following Cluster API providers on the cluster:

   • Core Provider

   • vSphere Infrastructure Provider

   • Kubeadm Bootstrap Provider

   • Kubeadm ControlPlane Provider

3. Ensure that the CAPV controllers are present with the command:

   CODE

    kubectl get pods -n capv-system

   The output resembles the following:

   CODE

   NAME                                      READY   STATUS    RESTARTS   AGE
   capv-controller-manager-785c5978f-nnfns   1/1     Running   0          13h

4. Konvoy waits until the controller-manager and webhook deployments of these providers are ready. List these deployments using this command:

   CODE

   kubectl get --all-namespaces deployments -l=clusterctl.cluster.x-k8s.i

   CODE

   NAMESPACE                           NAME                                            READY   UP-TO-DATE   AVAILABLE   AGE
   capa-system                         capa-controller-manager                         1/1     1            1           22m
   capi-kubeadm-bootstrap-system       capi-kubeadm-bootstrap-controller-manager       1/1     1            1           22m
   capi-kubeadm-control-plane-system   capi-kubeadm-control-plane-controller-manager   1/1     1            1           22m
   capi-system                         capi-controller-manager                         1/1     1            1           22m
   cappp-system                        cappp-controller-manager                        1/1     1            1           22m
   capv-system                         capv-controller-manager                         1/1     1            1           22m
   capz-system                         capz-controller-manager                         1/1     1            1           22m
   cert-manager                        cert-manager                                    1/1     1            1           22m
   cert-manager                        cert-manager-cainjector                         1/1     1            1           22m
   cert-manager                        cert-manager-webhook                            1/1     1            1           22m

Next Step:

When the bootstrap cluster is running, you are ready to Create a new vSphere cluster.