Manage Clusters

This guide provides an overview of how to manage Kubernetes clusters in your project.

List Clusters

CLI

Use the fluidctl kubernetes clusters list command to list all Kubernetes clusters in your project:

fluidctl kubernetes clusters list

API

To list all Kubernetes clusters via the API, send a GET request to the /kubernetes/clusters endpoint:

GET /kubernetes/clusters HTTP/1.1
Host: <your-cluster-url>
Authorization: Bearer <your-auth-token>

Create Cluster

CLI

Use the fluidctl kubernetes clusters create command to create a new Kubernetes cluster:

fluidctl kubernetes clusters create --name <cluster-name> --version <k8s-version>

• --name: The name of the cluster.
• --version: The Kubernetes version.

API

To create a Kubernetes cluster via the API, send a POST request to the /kubernetes/clusters endpoint:

POST /kubernetes/clusters HTTP/1.1
Host: <your-cluster-url>
Authorization: Bearer <your-auth-token>
Content-Type: application/json

{
  "name": "<cluster-name>",
  "version": "<k8s-version>"
}

Get Cluster Details

CLI

Use the fluidctl kubernetes clusters get command to get details for a specific cluster:

fluidctl kubernetes clusters get --id <cluster-id>

API

To get details for a specific cluster via the API, send a GET request to the /kubernetes/clusters/{id} endpoint:

GET /kubernetes/clusters/<cluster-id> HTTP/1.1
Host: <your-cluster-url>
Authorization: Bearer <your-auth-token>

Delete Cluster

CLI

Use the fluidctl kubernetes clusters delete command to delete a cluster:

fluidctl kubernetes clusters delete --id <cluster-id>

API

To delete a cluster via the API, send a DELETE request to the /kubernetes/clusters/{id} endpoint:

DELETE /kubernetes/clusters/<cluster-id> HTTP/1.1
Host: <your-cluster-url>
Authorization: Bearer <your-auth-token>

---

For node pool management, see Manage Node Pools.