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
If your environment uses HTTP/HTTPS proxies, you must either set environment variables or 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 Configuring an HTTP/HTTPS Proxy.Create a bootstrap cluster:
CODEdkp 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 Configuring an HTTP/HTTPS 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:
Ensure that the CAPV controllers are present with the command:
CODEkubectl get pods -n capv-system
The output resembles the following:
CODENAME READY STATUS RESTARTS AGE capv-controller-manager-785c5978f-nnfns 1/1 Running 0 13h
Konvoy waits until the controller-manager and webhook deployments of these providers are ready. List these deployments using this command:
CODEkubectl get --all-namespaces deployments -l=clusterctl.cluster.x-k8s.i
The output resembles the following:
CODENAMESPACE 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