Skip to main content
Skip table of contents

Bootstrap GCP

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. By default, DKP creates a bootstrap cluster for you in a Docker container using the Kubernetes-in-Docker (KIND) tool.


Before you begin, you must:

  • Complete the steps in Prerequisites.

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

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 --with-gcp-bootstrap-credentials=true
  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
    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

Once completed, move onto creating a new GCP cluster.

JavaScript errors detected

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

If this problem persists, please contact our support.