Get startedSign in

Add A Cluster

How To Add An Existing Cluster to Your Plural Instance

Adding a new cluster to Plural is very simple, it's simply a matter of installing our agent onto any end cluster, and usually follows two paths:

  1. Leverage our CLI which wraps a full install including registering with your Plural api and helm installing the agent on the cluster
  2. Use our terraform provider to wrap this whole process as Infrastructure as Code

Both are functional and fully supported, and execute equivalent code under the hood. If you set up your install with plural up we've already wrapped a ton of fully functional GitOps workflows for you, and those usually are more featureful workflows than doing this manually. If you want to read more about them, feel free to look at the guide here: Create a Workload Cluster.

Info:

We strongly recommend leveraging a IaC based pattern, since it'll allow you to export terraform state into Plural for re-use and maximizes reproducibility

Onboard a cluster with our CLI

To add a new cluster simply run with a valid kubeconfig set up locally:

plural cd clusters bootstrap --name {your-cluster-name} --tag {tag}={value} --tag {tag2}={value2}

To see all CLI options, feel free to use:

plural cd clusters bootstrap --help

If you need to reinstall our agent for any reason, just use:

Edit on Github