Skip to main content
Version: 0.3 (Next)

Cluster Management

Managing Clusters​

Auto-Generated Screenshot

This image is automatically generated from Cypress tests.

Clusters page

Konstruct uses a two-tier cluster architecture:

  1. Management cluster: Hosts the control plane that manages your infrastructure. Each organization needs one management cluster.
  2. Workload clusters: Run your applications and environments. You can create multiple workload clusters per organization.

To get started, first create a management cluster, then create workload clusters.

Add a Workload Cluster​

These steps walk through the process of adding a new workload cluster to your Konstruct setup.

Note: Cluster provisioning typically takes 15-20 minutes.

  1. Click Add workload cluster on the Clusters page
  2. Select the cluster type:
    • Physical - Full Kubernetes cluster with dedicated EC2 infrastructure
    • Virtual - Lightweight virtual cluster (faster, lower cost)
  3. Configure the cluster:
    • Cluster name - Unique name for the cluster
    • Cloud account - AWS account to provision the cluster in
    • Cloud region - AWS region for the cluster
    • AMI type - Amazon Machine Image type (e.g., AL2_x86_64)
    • Instance size - EC2 instance type (e.g., m5.xlarge)
    • Number of nodes - defaults to 2 (recommended minimum)
    • Environment (optional) - Environment this cluster will host
  4. Click Add cluster to start provisioning

For custom templates, see Custom Cluster Templates.

Delete a Cluster​

  1. Navigate to the Cluster management view in the Konstruct UI.
  2. Select the cluster you want to delete and click on the individual cluster to display the full details.
  3. From the context menu on the top right (three little dots), select Delete Cluster.

Deletion Process​

Once you select Delete Cluster the process is as follows:

  • Selecting Delete Cluster removes the corresponding content in your gitops repository. You can check that process in your gitops repository to verify that cluster details were deleted.
  • The removal of the cluster in gitops triggers Argo CD and removes any associated applications. You can check that process in Argo CD.
  • The final step, removing the infrastructure app removes the cluster from the cloud.
  • Once Argo CD shows a clusters app that is healthy and fully synced you can consider the deletion complete.