Async::Container

Getting Started

This guide explains how to use async-container to build basic scalable systems.

Container Policies

This guide explains how to use policies to monitor container health and implement custom failure handling strategies.

Systemd Integration

This guide explains how to use async-container with systemd to manage your application as a service.

Kubernetes Integration

This guide explains how to use async-container with Kubernetes to manage your application as a containerized service.

v0.34.2

• Once a container is stopped, it stays stopped.

v0.34.0

• Add Async::Container::Generic#stopping? so that policies can more accurately track the state of the container.

v0.33.0

• Add Policy#make_statistics to allow policies to customize statistics initialization.

v0.32.1

• Expose Async::Container::Controller #notify, #container_class, and #graceful_stop for testing.

v0.32.0

• Minor breaking changes to Async::Container::Policy interface.
• Expose Async::Container::Statistics::Rate#window.

v0.31.0

• Introduce Async::Container::Policy for managing child lifecycle events and implementing custom failure handling strategies.
• Add Async::Container::Statistics::Rate for tracking failure and restart rates over sliding time windows.
• Fix restart counter to only increment when actually restarting (check @running flag).

v0.30.0

• SIGTERM is now graceful, the same as SIGINT, for better compatibility with Kubernetes and systemd.
• ASYNC_CONTAINER_INTERRUPT_TIMEOUT and ASYNC_CONTAINER_TERMINATE_TIMEOUT are removed and replaced by ASYNC_CONTAINER_GRACEFUL_TIMEOUT.

v0.29.0

• Introduce Client#healthy! for sending health check messages.

v0.28.0

• Add startup_timeout parameter to spawn and run methods for detecting processes that hang during startup and never become ready.
• Health check timeout now only applies after a process becomes ready, preventing premature timeouts for slow-starting applications.

v0.27.5

• Make the child handling more robust in the face of exceptions.