Manage your Node Pools

What to know about Node Pools

• Node pools allow you to group one or more Crusoe Cloud instances of the same type and associate them to a specific cluster control plane, to function as worker nodes.
• When creating a node pool, you must specify the number of VMs you want to create via a count field. Once specified, the node pool will maintain this VM count where possible. For example, if you stop or terminate one of the VMs in your node pool, the node pool will provision new VMs up till the count specified.
• You may scale up or down your node pool by specifying a new count value. Note that setting a count value lower than the current number does not automatically delete VMs from your node pools. You must manually delete the instances you want removed.
• We currently do not allow editing the startup script or image associated with node pools. To install packages or software on node bring-up, we recommend using Daemonsets.

Creating a New Node Pool

CLI

Nodepools can be created by using the kubernetes nodepools create command. Nodepools must be created in the context of a specific cluster. Use the '--help' flag for an exhaustive list of options.

crusoe kubernetes nodepools create \
  --name my-first-nodepool \
  --cluster-id 6f8e2a1b-7b1d-4c8e-a9f2-8e3d6c1f2a0c \
  --type h100-80gb-sxm-ib.8x \
  --count 4 \
  --ib-partition-id 4c8e2a1b-7b1d-4c8e-a9f2-8e3d6c1f2a0c \

UI

In order to create a CMK cluster via the cloud console:

- Visit the Crusoe Cloud console
- Click the "Orchestration" tab in the left nav
- Select the cluster you want to edit
- Click the "Create Node Pool" button
- Fill out the required fields specifying the type of nodes you want to create and the count
- Click the "Create" button

Terraform

You can use the crusoe_kubernetes_node_pool resource to create a new node pools in the context of a specific cluster via Terraform.

terraform {
  required_providers {
    crusoe = {
      source  = "crusoecloud/crusoe"
    }
  }
}

locals {
  my_ssh_key = file("~/.ssh/id_ed25519.pub") # replace with path to your public SSH key if different
}

resource "crusoe_kubernetes_cluster" "my_first_cluster" {
  name = "tf-cluster"
  version = "1.30"
  location = "us-east1-a"
  subnet_id = "6f8e2a1b-7b1d-4c8e-a9f2-8e3d6c1f2a0c"
  add_ons = "nvidia_gpu_operator,nvidia_network_operator,crusoe_csi"
}

resource "crusoe_kubernetes_node_pool" "l40s_nodepool" {
  name = "tf-l40s-nodepool"
  cluster_id = crusoe_kubernetes_cluster.my_cluster.id
  instance_count = "4"
  type = "l40s-48gb.10x"
  ssh_key = local.my_ssh_key
  requested_node_labels = {
    # Optional: Kubernetes Node objects will be labeled with the following key:value pairs
    # "labelkey" = "labelvalue"
  }
}

Viewing Existing Node Pools

CLI

Use the kubernetes nodepools list command to list all existing node pools across clusters. You can also use the `kubernetes nodepools get' command to retrieve individual node pool details.

crusoe kubernetes nodepools get <name/id>

UI

To view your node pools via the Crusoe Cloud console:

- Visit the Crusoe Cloud console
- Click the "Orchestration" tab in the left nav
- Select the cluster you are interested in
- You will see a list of node pools in the 'Node Pools' section of the cluster details view.

Update your Node Pools

CLI

You may update the number of nodes in your nodepools by using the crusoe kubernetes nodepools update command.

crusoe kubernetes nodepools update <name/id> --count 3

UI

To update the number of VMs in your node pool using the cloud console:

- Visit the Crusoe Cloud console
- Click the "Orchestration" tab in the left nav
- Select the cluster you want to update
- Select the edit icon next to the node pool you want to update
- Specify the new number of nodes that you want to add
- Click the "Update" button

Terraform

Edit the instance_count field in your crusoe_kubernetes_node_pool resource to specify the new number of nodes that you want to add

resource "crusoe_kubernetes_node_pool" "l40s_nodepool" {
  name = "tf-l40s-nodepool"
  cluster_id = crusoe_kubernetes_cluster.my_cluster.id
  instance_count = "6" # add 2 more nodes
  type = "l40s-48gb.10x"
  ssh_key = local.my_ssh_key
}

Delete a Node Pool

CLI

You can delete nodepools by using the kubernetes nodepools delete command and specifying either the name of ID of the nodepool you want to delete.

crusoe kubernetes nodepools delete <name/id>

UI

In order to create a node pool via the cloud console:

- Visit the Crusoe Cloud console
- Click the "Orchestration" tab in the left nav
- Select the cluster you want to update
- Select the delete icon next to the node pool you want to delete

Terraform

Deleting nodepools may be accomplished by removing the desired crusoe_kubernetes_nodepool resource from your terraform configuration.

If you are having issues creating or deleting clusters, please contact support.