Hooks

Lifecycle Events#

Lifecycle events refer to different stages in the existence of entities managed by Oakestra. Hooks focus on three primary event types for entities:

• Creation: Triggered when a new entity, such as an application or service, is created within Oakestra.
• Update: Encompasses all state changes for an entity after its initial creation, providing flexibility for services to retrieve additional state details if required.
• Deletion: Triggered when an entity is removed from the system.

When an event is triggered, all registered subscribers are notified, allowing them to take necessary actions based on the entity’s current lifecycle stage.

Trigger Modes#

Hooks can be triggered in two modes:

• Synchronous Mode: The triggering component waits for a response from the subscriber(s) before proceeding. This is useful when subsequent steps depend on the outcome of the subscriber’s response, such as when network address must be assigned before deployment.
• Asynchronous Mode: The triggering component does not wait for the subscriber(s) to respond, allowing the system to continue without delay. This mode is appropriate for non-blocking actions, like logging or notifying external systems.