Create your cluster

Creating your cluster requires two steps:

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

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

tip

If you don't have a cloud subscription, check out MiniConstellation, which lets you set up a local Constellation cluster using virtualization.

The create step

This step creates the necessary resources for your cluster in your cloud environment.

Configuration

Generate a configuration file for your cloud service provider (CSP):

Azure

constellation config generate azure

GCP

constellation config generate gcp

AWS

constellation config generate aws

This creates the file constellation-conf.yaml in the current directory. Fill in your CSP-specific information before you continue.

Next, download the trusted measurements for your configured image.

constellation config fetch-measurements

For details, see the verification section.

Create

Choose the initial size of your cluster. The following command creates a cluster with one control-plane and two worker nodes:

constellation create --control-plane-nodes 1 --worker-nodes 2

For details on the flags, consult the command help via constellation create -h.

create stores your cluster's state into a terraform.tfstate file in your workspace.

The init step

The following command initializes and bootstraps your cluster:

constellation init

Next, configure kubectl for your cluster:

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

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