Skip to main content
Version: 0.1

Cluster Management

Managing Clusters

Add a Cluster

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

Note: The Cluster creation process can take up to 20 minutes.

  1. Select Create Cluster to launch the configuration.
  2. Choose a cluster template:
    • Konstruct Template - Default Konstruct cluster configuration
    • Custom Template - Use your own Terraform modules
  3. Complete the options as desired:
    • Environment cluster will host (optional) - Selecting an existing environment to include all of the services and applications configured for that environment on your workload cluster.
    • Cluster name
    • Cloud account that will host this cluster
    • Cloud region
    • Instance size
    • Number of nodes - defaults to 2 (recommended minimum)
  4. If using a custom template, define the location and provide a Personal Access Token if private
  5. Once you have selected your preferred options select Create Cluster.

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.