Skip to content

Node pools and nodes

A node pool is a group of workers that share one machine type. Add, scale, and remove pools on a cluster whose status is Ready. You can also replace one worker. Door keeps the pool's desired count.

Who can do this: a member can open the Nodes tab. A super_admin can add, scale, remove a pool, and replace a node.

The machine type of an existing pool cannot be changed. Add another pool instead. A cluster always keeps at least one pool. A second change on the same pool, while the first is still running, is refused. Different pools can change at the same time. The cluster stays Ready while workers are added or removed.

Managing workers in the console

Nodes tab: one pool and its workers, demo organization

Nodes tab in the demo organization (cluster cp-canary-in, one pool default with one c5.large worker). Your cluster, for example payments-prod with pool workers, shows your own pools and workers.

  1. Open https://door.cloud, then Clusters, and click a cluster whose status is Ready.
  2. Open the Nodes tab.
  3. Each pool is a card: name, replica count, machine type (for example dks.c5.xlarge), vCPU, memory, and disk. Change the replica count or autoscaling from the card. Replicas are 1–200, or 0 only when autoscaling is on and the count sits between the minimum and the maximum.
  4. The worker table lists every node: name, status, disk, CPU, memory, Kubernetes version, and age. Those names match kubectl get nodes once the node has joined.
  5. Click + Add node pool for another pool: name, machine type, count, and optional autoscaling.
  6. The row action on a worker replaces that node. Door brings a new one up so the pool keeps its count. Use it to recycle a bad node, not to scale down.
  7. Removing a pool is allowed only while another pool remains.

Refresh the tab to see the new count. Pool labels you set are stored with the pool. They are not applied as Kubernetes node labels.

Adding or scaling a pool with Maya

Open Maya with the organization selected and the cluster Ready.

Add a node pool named batch on payments-prod, tier dks.c5.large, two nodes.

Scale the workers pool on payments-prod to 4.

Approve the confirmation card when it appears. The confirmation card and progress messages look like the ones on the Maya page. Maya cannot change an existing pool's machine type, and it cannot remove a pool or replace a single node. Do those on the Nodes tab.

Next

Request fields and status codes are in the API reference.