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.

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

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 configuration to a file named constellation-state.json in your current directory.

The init step

The following command initializes and bootstraps your cluster:

constellation init

To enable autoscaling in your cluster, add the --autoscale flag:

constellation init --autoscale

Next, configure kubectl for your cluster:

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

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