Shaken Fist's State Machine
Shaken Fist implements a state machine for each object type. This page documents the possible states for each object, and which transitions between states are valid.
Initial: this is the first state for an instance. A UUID has been allocated, a placeholder database entry created, and a request to create the instance has been queued.
Preflight: the instance creation request has been dequeued and is being validated against the current state of the cluster by the scheduler.
Creating: the instance is being created.
Created: the instance is now running.
Deleted: the instance is now deleted.
Error: the instance is unable to be used.
Instances marked as Deleted are deleted from the DB after sitting deleted for some period of time.
Any instance may enter the Error state, which happens when something bad has happened. That process involves the instance being moved to a transition state named for the instance's previous state, so for example an instance which was Created that went into Error would transition through Created-Error. This is done because the Error transition is a queue job and happens sometime later. Instances in the Error state are not removed like those in the deleted state, as we assume a caller must acknowledge an error occured. To remove them, delete the instance in Error state.
Initial: first state for a network. A UUID has been allocated, database entry created, and a request to create the network on the
networknodehas been queued.
Created: the network has been created on the
Delete_Wait: the network has been scheduled for deletion. Waiting for instances on the network to be deleted.
Deleted: the network is now deleted.
Error: the network has encountered an error and cannot be used.
Networks marked as Deleted are deleted from the DB after sitting deleted for some period of time.
A network is regarded as
Deadwhen it is in state
Created: on first check in, a node is created in the "created" state.
Stopping: the node is gracefully shutting down.
Stopped: the node has gracefully shut down.
Deleted: the node was manually evacuated and removed.
Missing: the node has not checked in within the NODE_CHECKIN_MAXIMUM deadline.
Error: the node has not check in for ten times NODE_CHECKIN_MAXIMUM, and all instances on this node have been declared to be in an error state.