Cluster and node lifecycle states in Bamboo

Still need help?

The Atlassian Community is here for you.

Ask the community

The Bamboo Data Center warm standby architecture supports different lifecycle states. Some of them are related to the cluster as a whole and others are specific only to individual nodes. These states are used mostly internally but can give you an idea of the health of your cluster.

You can preview the current lifecycle states by calling the following REST endpoint:

GET <BASE_URL>/rest/api/latest/server

Cluster lifecycle states

Lifecycle stateDescription
STARTINGThe cluster is starting, and none of the nodes are operational yet.
RUNNINGAt least the primary node is running.
PAUSINGThe cluster nodes are shutting down components necessary for the cluster to be fully paused.
PAUSEDThe cluster is paused and has limited capabilities. For example, no builds can be queued.
UNKNOWNThe state of the cluster can't be established.

Node lifecycle states

Lifecycle stateDescription
SETUPThe node is in the initial setup phase. The cluster state doesn't exist yet.
STARTINGThe node is starting and is not yet operational.
RUNNINGThe node is up and running as a primary node.
RUNNING_AS_SECONDARYThe node is up and running as a secondary node. A secondary node may become the primary node in the event of a failover.
PAUSINGThe node is attempting to gracefully suspend active components. This state is directly mapped to the cluster's "PAUSING" state. If the cluster is in the "PAUSING" state, all nodes in the cluster are also in that state.
PAUSEDThe node is paused and has limited capabilities. This state is directly mapped to the cluster's "PAUSED" state. If the cluster is in the "PAUSED" state, all nodes in the cluster are also in that state.
PREPARING_FOR_RESTART

The node is attempting to gracefully shut down all running activities. This state can't be recovered from. Once a node reaches this state, it must be restarted or permanently shut down. You can put a node in this state by calling the following REST endpoint:

PUT <node-hostname>/rest/api/latest/server/prepareForRestart
READY_FOR_RESTARTThe node is ready for restart or permanent shutdown. This state can't be recovered from. Once a node reaches this state, it must be restarted or permanently shut down.

Last modified on Jul 1, 2024

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.