Cluster and node lifecycle states in Bamboo
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 state | Description |
---|---|
STARTING | The cluster is starting, and none of the nodes are operational yet. |
RUNNING | At least the primary node is running. |
PAUSING | The cluster nodes are shutting down components necessary for the cluster to be fully paused. |
PAUSED | The cluster is paused and has limited capabilities. For example, no builds can be queued. |
UNKNOWN | The state of the cluster can't be established. |
Node lifecycle states
Lifecycle state | Description |
---|---|
SETUP | The node is in the initial setup phase. The cluster state doesn't exist yet. |
STARTING | The node is starting and is not yet operational. |
RUNNING | The node is up and running as a primary node. |
RUNNING_AS_SECONDARY | The node is up and running as a secondary node. A secondary node may become the primary node in the event of a failover. |
PAUSING | The 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. |
PAUSED | The 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:
|
READY_FOR_RESTART | The 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. |