Skip to main content
Skip table of contents

Cloud Director Bootstrap the Cluster

To create Kubernetes clusters, DKP uses Cluster API (CAPI) controllers. These controllers run on a Kubernetes cluster. To get started, you need a bootstrap cluster. Bootstrapping is the process of creating a new Kubernetes cluster from scratch and involves setting up the control plane and worker nodes. It also determines which node has the correct information for synchronization with all other nodes.


Before you begin, you must:

  • Complete the steps in Prerequisites.

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

  • For tenants, you need to set their Organization name and Network name in order to create a cluster.

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:

    dkp create bootstrap
  3. The output looks similar to:

     ✓ Creating a bootstrap cluster
     ✓ Initializing new CAPI components
  4. DKP creates a bootstrap cluster using KIND as a library. DKP then deploys the following Cluster API providers on the cluster:

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

    kubectl get --all-namespaces deployments

    You will then receive the following output:

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

Next Step:

Cloud Director Create a New Cluster

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.