constellation/docs/versioned_docs/version-2.4/workflows/create.md
2023-01-11 16:26:07 +01:00

1.4 KiB

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. Before you create the cluster, make sure to have a valid configuration file.

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.