mirror of
https://github.com/edgelesssys/constellation.git
synced 2024-12-23 14:39:40 -05:00
47 lines
1.4 KiB
Markdown
47 lines
1.4 KiB
Markdown
|
# 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](../architecture/orchestration.md) section for details on the inner workings of this process.
|
||
|
|
|
||
|
|
:::tip
|
||
|
|
If you don't have a cloud subscription, check out [MiniConstellation](../getting-started/first-steps-local.md), 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](./config.md).
|
||
|
|
|
||
|
|
### Create
|
||
|
|
|
||
|
|
Choose the initial size of your cluster.
|
||
|
|
The following command creates a cluster with one control-plane and two worker nodes:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
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`](../architecture/orchestration.md#cluster-creation-process) file in your workspace.
|
||
|
|
|
||
|
|
## The *init* step
|
||
|
|
|
||
|
|
The following command initializes and bootstraps your cluster:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
constellation init
|
||
|
|
```
|
||
|
|
|
||
|
|
Next, configure `kubectl` for your cluster:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
export KUBECONFIG="$PWD/constellation-admin.conf"
|
||
|
|
```
|
||
|
|
|
||
|
|
🏁 That's it. You've successfully created a Constellation cluster.
|