Skip to main content

Register Clusters

A Cluster resource represents a Kubernetes cluster managed by Testudo. It can be a source cluster, a target cluster, or both in different protection relationships.

Registration Methods​

The platform supports kubeconfig and token-plus-endpoint credential styles. The operator must be able to:

  • Access the Kubernetes API.
  • Create and read Velero resources.
  • List namespaces, workloads, PVCs, and StorageClasses.
  • Write resources needed during restore.

In the console, go to Resource Configuration / Cluster Configuration Management.

Cluster configuration management

Click Add Cluster, fill in the name, authentication method, labels, and kubeconfig, then validate the connection before saving.

Add cluster

Server APIs​

  • GET /apis/cluster.testudo.softcdata.com/v1/clusters
  • POST /apis/cluster.testudo.softcdata.com/v1/clusters
  • GET /apis/cluster.testudo.softcdata.com/v1/clusters/:name/validate
  • POST /apis/cluster.testudo.softcdata.com/v1/clusters/kubeconfig/validate
  • GET /apis/cluster.testudo.softcdata.com/v1/watch/clusters

Checks​

  • The cluster status is Ready.
  • Protected namespaces can be listed.
  • Restore classes can be discovered on the target cluster.
  • The event stream has no continuous authentication or network errors.