mirror of
https://github.com/edgelesssys/constellation.git
synced 2024-12-26 16:09:45 -05:00
61 lines
1.8 KiB
Markdown
61 lines
1.8 KiB
Markdown
|
# Terminate your cluster
|
||
|
|
|
||
|
|
:::info
|
||
|
|
This recording presents the essence of this page. It's recommended to read it in full for the motivation and all details.
|
||
|
|
:::
|
||
|
|
|
||
|
|
<asciinemaWidget src="/constellation/assets/terminate-cluster.cast" rows="20" cols="112" idleTimeLimit="3" preload="true" theme="edgeless" />
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
You can terminate your cluster using the CLI. For this, you need the Terraform state directory named [`constellation-terraform`](../reference/terraform.md) in the current directory.
|
||
|
|
|
||
|
|
:::danger
|
||
|
|
|
||
|
|
All ephemeral storage and state of your cluster will be lost. Make sure any data is safely stored in persistent storage. Constellation can recreate your cluster and the associated encryption keys, but won't backup your application data automatically.
|
||
|
|
|
||
|
|
:::
|
||
|
|
|
||
|
|
<tabs groupId="provider">
|
||
|
|
<tabItem value="cli" label="CLI">
|
||
|
|
Terminate the cluster by running:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
constellation terminate
|
||
|
|
```
|
||
|
|
|
||
|
|
Or without confirmation (e.g., for automation purposes):
|
||
|
|
|
||
|
|
```bash
|
||
|
|
constellation terminate --yes
|
||
|
|
```
|
||
|
|
|
||
|
|
This deletes all resources created by Constellation in your cloud environment.
|
||
|
|
All local files created by the `create` and `init` commands are deleted as well, except for `constellation-mastersecret.json` and the configuration file.
|
||
|
|
|
||
|
|
:::caution
|
||
|
|
|
||
|
|
Termination can fail if additional resources have been created that depend on the ones managed by Constellation. In this case, you need to delete these additional
|
||
|
|
resources manually. Just run the `terminate` command again afterward to continue the termination process of the cluster.
|
||
|
|
|
||
|
|
:::
|
||
|
|
|
||
|
|
</tabItem>
|
||
|
|
<tabItem value="terraform" label="Terraform">
|
||
|
|
Terminate the cluster by running:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
terraform destroy
|
||
|
|
```
|
||
|
|
|
||
|
|
Delete all files that are no longer needed:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
rm constellation-id.json constellation-admin.conf
|
||
|
|
```
|
||
|
|
|
||
|
|
Only the `constellation-mastersecret.json` and the configuration file remain.
|
||
|
|
|
||
|
|
</tabItem>
|
||
|
|
</tabs>
|