Node pool lifecycle

Updated at:

A node pool moves through a defined set of states as you create, operate, and delete it. Understanding these states helps you quickly assess whether a node pool is healthy, in progress, or requires action.

The following diagram shows all possible states and the transitions between them.

image

Node pool states

Node pool states fall into two categories: steady states that persist until you take action, and transient states that indicate an operation is in progress.

Steady states

Node pool statusDescriptionWhat to do
ActiveThe node pool is created and ready for use.No action required.
FailedThe node pool failed to be created.Check the error details and retry, or delete the node pool and create a new one.

Transient states

These states indicate that an operation is running. In most cases, wait for the operation to complete before taking further action.

Node pool statusDescriptionTriggered by
InitializingThe node pool is being initialized.Creating a new node pool
Scaling OutThe node pool is being scaled out or nodes are being added to the node pool.Scaling out the node pool
UpdatingThe configurations of the node pool are being updated.Modifying node pool configuration
Removing NodesNodes are being removed from the node pool.Removing nodes from the node pool
UpgradingThe node pool is being upgraded.Triggering a node pool upgrade
RepairingNode repair is being performed on the node pool.Triggering node repair on the node pool
DeletingThe node pool is being deleted.Initiating node pool deletion
After deletion completes, the node pool enters a Deleted state that is not visible in the console.

What's next