Skip to main content

Manage Clusters

Learn how to create and manage Kubernetes clusters for use with Codiac.

A cluster is an orchestrated collection of virtual machines on which Codiac deploys customer software. Clusters also include network infrastructure to enable connections between services and the internet.

Create Cluster​

  1. Use codiac cluster create to create your cluster from the command line:
codiac cluster create
  1. Follow the prompts to:
  • Enter your Codiac username.
  • Enter your Codiac password.
  • Select your tenant.
  • Select your cloud provider: Amazon Web Services (AWS) or Azure.
  • Select the parameters you want to set for your cluster, including the name, region, node type, etc.
  1. Verify all the parameters are correct, then enter Y to start the cluster creation process.

List Clusters​

  1. Use codiac cluster list to list your existing Codiac clusters:
codiac cluster list

  1. Follow the prompts to select your target enterprise.

  2. This command outputs a list of your cluster(s), the cloud service provider where they are hosted, and their region.

$ codiac cluster list
? Select a target enterprise: test
Retrieving... found 4
test-cluster-01  azure (southcentralus)
test-cluster-02 azure (southcentralus)
test-cluster-03  aws (us-west-1)
test-cluster-04  azure (southcentralus)

Delete Cluster​

Codiac has two options for ending a cluster:

  • destroy: Deletes the physical cluster, not the Codiac cluster definition record.
  • forget: Deletes the Codiac cluster definition record, not the physical cluster.

Destroy​

The codiac cluster destroy command deletes the physical cluster from your cloud service provider (AWS or Azure). This command does not delete the Codiac cluster definition record.

tip

To undo the effects of this command, use codiac cluster recreate to provision a new physical cluster from an existing Codiac cluster definition record.

  1. Use codiac cluster destroy to delete the physical cluster:
codiac cluster destroy

  1. Follow the prompts to select the cluster you wish to destroy.

  2. The cluster is deleted from your cloud service provider (AWS or Azure). The Codiac cluster definition remains intact.

Forget​

The codiac cluster forget command deletes the Codiac cluster definition record. This command does not delete the physical cluster from your cloud service provider (AWS or Azure).

Before you use this command to forget a cluster, you must delete all cabinets and environments associated with that cluster.

  1. Use 'codiac cluster forget' to forget the cluster details:
codiac cluster forget

  1. Follow the prompts to select the cluster for which you want to delete the Codiac cluster definition record.

  2. The Codiac cluster definition record is deleted. The physical cluster at your cloud service provider (AWS or Amazon) remains intact.

danger

This command does not affect the Kubernetes cluster. Your cloud service provider will continue to bill you until you destroy the cluster.