Skip to main content
Skip table of contents

AWS Air-gapped Bootstrap

Bootstrap a kind cluster and CAPI controllers

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. Assuming you have downloaded dkp-air-gapped-bundle_v2.6.0_linux_amd64.tar.gz , extract the tarball to a local directory:

    CODE
    tar -xzvf dkp-air-gapped-bundle_v2.6.0_linux_amd64.tar.gz && cd dkp-v2.6.0
  2. Set an environment variable with your registry address with this command:

    CODE
    export REGISTRY_ADDRESS=<registry-address>:<registry-port>
    export REGISTRY_USERNAME=<username>
    export REGISTRY_PASSWORD=<password>
  3. Seed the registry by running the following command to load the air-gapped image bundle into your private registry:

    CODE
    dkp push bundle --bundle ./container-images/konvoy-image-bundle-v2.6.0.tar --to-registry $REGISTRY_ADDRESS --to-registry-username $REGISTRY_USERNAME --to-registry-password $REGISTRY_PASSWORD
  4. Load the bootstrap container image on your bastion machine using Docker or Podman command:

    CODE
    docker load -i konvoy-bootstrap-image-v2.6.0.tar
    CODE
    podman load -i konvoy-bootstrap-image-v2.6.0.tar
  5. 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 Configuring an HTTP/HTTPS Proxy.

  6. (Optional) Refresh the credentials used by the AWS provider at any time, using the command:

    CODE
    dkp update bootstrap credentials aws

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

Next Step:

Create a New Air-gapped AWS Cluster

JavaScript errors detected

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

If this problem persists, please contact our support.