Skip to main content
Version: 2.17

Create your cluster

info

This recording presents the essence of this page. It's recommended to read it in full for the motivation and all details.

Loading asciinema cast...

Creating your cluster happens through multiple phases. The most significant ones are:

  1. Creating the necessary resources in your cloud environment
  2. Bootstrapping the Constellation cluster and setting up a connection
  3. Installing the necessary Kubernetes components

constellation apply handles all this in a single command. You can use the --skip-phases flag to skip specific phases of the process. For example, if you created the infrastructure manually, you can skip the cloud resource creation phase.

See the architecture section for details on the inner workings of this process.

tip

If you don't have a cloud subscription, you can also set up a local Constellation cluster using virtualization for testing.

Before you create the cluster, make sure to have a valid configuration file.

constellation apply

apply stores the state of your cluster's cloud resources in a constellation-terraform directory in your workspace.

Finally, configure kubectl for your cluster:

export KUBECONFIG="$PWD/constellation-admin.conf"

🏁 That's it. You've successfully created a Constellation cluster.

Troubleshooting

In case apply fails, the CLI collects logs from the bootstrapping instance and stores them inside constellation-cluster.log.