Git-Mirrors/constellation
1
0
Fork 0
mirror of https://github.com/edgelesssys/constellation.git synced 2024-12-13 18:04:20 -05:00
Code Issues Packages Projects Releases Wiki Activity
c7e8fe0bd6
constellation/docs/versioned_docs/version-2.0/workflows/create.md
Thomas Tendyck 811ccc80a3
docs: clarify permissions on install page (#184) 
* docs: clarify permissions on install page

* docs: remove default attribute from tabs

* docs: publish to 2.0
2022-09-21 16:58:04 +02:00

2.5 KiB
Raw Blame History

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.

Prerequisites

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.

Configuration

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.

Create

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

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

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