Create your cluster

Creating your cluster requires two steps:

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.

Before creating your cluster you need to decide on

the initial size of your cluster (the number of control-plane and worker nodes)
the machine type of your nodes (depending on the availability in your cloud environment)
whether to enable autoscaling for your cluster (automatically adding and removing nodes depending on resource demands)

You can find the currently supported machine types for your cloud environment in the installation guide.

Constellation can generate a configuration file for your cloud provider:

constellation config generate azure

constellation config generate gcp

This creates the file constellation-conf.yaml in the current directory. You must edit it before you can execute the next steps.

Next, download the latest trusted measurements for your configured image.

constellation config fetch-measurements

For more details, see the verification section.

The following command creates a cluster with one control-plane and two worker nodes:

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

For details on the flags and a list of supported instance types, consult the command help via constellation create -h.

create will store your cluster's configuration to a file named constellation-state.json in your current directory.

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 Constellation cluster:

export KUBECONFIG="$PWD/constellation-admin.conf"
kubectl get nodes -o wide

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