Cluster Management

Managing Clusters

Hosted

Konstruct uses a two-tier cluster architecture when running on the Hosted Control Plane. Civo manages the control plane for you.

1. Management cluster (Civo) — Hosts Argo CD, Crossplane, and platform tooling. Provisioned in your Civo account.
2. Workload clusters — Run your applications. Provisioned in your cloud account and managed by your management cluster.

Self-Hosted

Konstruct uses a two-tier cluster architecture from your perspective, with your own control plane cluster sitting above it:

1. Management cluster — Hosts the control plane (Argo CD, Crossplane, platform tooling) that manages your workload clusters. Each organization needs one.
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 infrastructure
   • Virtual - Lightweight virtual cluster (faster, lower cost)
3. Configure the cluster:

Hosted (Civo)

• Cluster name - Unique name for the cluster
• Cloud account - Civo account to provision the cluster in
• Region - Civo region (e.g., NYC1, LON1, FRA1)
• Node size - Civo instance size (e.g., g4s.kube.large)
• Number of nodes - defaults to 2 (recommended minimum)
• Environment (optional) - Environment this cluster will host

Self-Hosted (AWS)

• Cluster name - Unique name for the cluster
• Cloud account - AWS account to provision the cluster in
• Cloud region - AWS region (e.g., us-west-2)
• 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

1. 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.