Prerequisites

Before you perform this procedure, ensure that you have created a CAPI VM template.

Bootstrap a kind cluster and CAPI controllers

DKP Konvoy deploys all cluster lifecycle services to a bootstrap cluster, which deploys a workload cluster. When the workload cluster is ready, move the cluster lifecycle services to the workload cluster, after which the workload cluster manages its own lifecycle.

  1. Copy the image tar file to the machine where you want to run the bootstrap cluster.

  2. Load the bootstrap Docker image. The image version should correspond to the version of Konvoy as returned by dkp version:

    docker load -i <path to mesosphere/konvoy-bootstrap image>
    CODE

  3. Create a bootstrap cluster with the command:

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

    The output resembles this example:

    ✓ Creating a bootstrap cluster
    ✓ Initializing new CAPI components
    CODE

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

    kubectl get pods -n capv-system
    CODE

    The output resembles the following:

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

  5. Refresh the credentials used by the vSphere provider at any time, using the command:

    dkp update bootstrap credentials vsphere
    CODE

Next, you can create a new vSphere Kubernetes cluster.