Skip to content

Run machines in a worker pool

A worker pool is vCPU, memory and disk set aside once and shared by the machines in it. On Deployport Compute a machine is a worker in a pool by default, so this is the ordinary way a Compute machine is created.

The pool draws on the account’s funds by the minute while it exists, whether its machines run or not. Its machines draw nothing more.

In Machinery, open Worker Pools and choose Create. Give it a title and pick a tier.

A worker pool never changes platform afterwards, so name the platform when you create it.

New Machine has a Kind row and a Worker pool row. A worker shows no Place, Region, Zone or Size row, because the pool decides all four.

A machine that needs vCPU and memory of its own is a server, created with --kind server, and a machine with a screen is a desktop. Neither joins a pool.

One pool is where a create that names none lands:

Terminal window
deployport machinery worker-pools set-is-default <worker-pool-id> --value true

A pool shows the most machines it may contain beside how many it contains now. A 2-vcpu-8gb pool allows up to 50 machines. Only an operator changes that count.

Machines past what the pool’s memory allows slow down while their memory is reclaimed and paged to disk, and in the last case one of them is stopped.

Terminal window
deployport machinery worker-pools change-tier <worker-pool-id> <tier>
deployport machinery worker-pools destroy <worker-pool-id>

A tier change leaves its machines running. Machines already in it keep the vCPU, memory and disk they were given, and machines created after the change get the new tier’s. Destroying a pool gives its vCPU, memory and disk back, so it refuses while machines are in it.

Terminal window
deployport machinery worker-pools list

One row per pool, newest first. MACHINES is how many machines it contains beside the most it may contain, RUNNING is how many of them run now, and DISK is what its machines have written, their snapshots included, beside the tier’s disk. deployport machinery worker-pools get <worker-pool-id> prints one pool with its swap state and its tier.