Async::Service

Getting Started

This guide explains how to get started with async-service to create and run services in Ruby.

Container Policies

This guide explains how to configure container policies for your services and understand the default failure handling behavior.

Service Architecture

This guide explains the key architectural components of async-service and how they work together to provide a clean separation of concerns.

Best Practices

This guide outlines recommended patterns and practices for building robust, maintainable services with async-service.

Deployment

This guide explains how to deploy async-service applications using systemd and Kubernetes. We'll use a simple example service to demonstrate deployment configurations.

v0.20.1

• Use container.stopping? in policy to prevent redundant stop calls during graceful shutdown.

v0.20.0

• Introduce Async::Service::Policy for monitoring service health and implementing failure handling strategies. Default threshold: 6 failures in 60 seconds (0.1 failures/second).
• Add container_policy configuration method for specifying custom policies in service configuration files.
• Add Configuration#make_controller (aliased as controller) for creating controllers with policy injection.
• Add Service::Controller#make_policy which returns Service::Policy::DEFAULT by default.

v0.19.0

• Renamed Async::Service::GenericService -> Async::Service::Generic, added compatibility alias for GenericService.
• Renamed Async::Service::ManagedService -> Async::Service::Managed::Service, added compatibility alias for ManagedService.
• Renamed Async::Service::ManagedEnvironment -> Async::Service::Managed::Environment, added compatibility alias for ManagedEnvironment.
• Renamed Async::Service::HealthChecker -> Async::Service::Managed::HealthChecker, added compatibility alias for HealthChecker.

v0.18.1

• Remove prepared and running log messages - not as useful as I imagined, and quite noisy.

v0.18.0

• Start health checker earlier in the process. Use #healthy! message instead of #ready!.
• Emit prepared and running log messages with durations (e.g. how long it took to transition to prepared and running states).
• Async::Service::Configuration.build{|loader|...} can now take an argument for more flexible configuration construction.

v0.17.0

• ManagedService now sends status! messages during startup to prevent premature health check timeouts for slow-starting services.
• Support for startup_timeout option via container_options to detect processes that hang during startup and never become ready.

v0.16.0

• Renamed Async::Service::Generic -> Async::Service::GenericService, added compatibilty alias.
• Renamed Async::Service::Managed::Service -> Async::Service::ManagedService.
• Renamed Async::Service::Managed::Environment -> Async::Service::ManagedEnvironment.

v0.15.1

• Managed::Service should run within Async do ... end.

v0.15.0

• Rename ContainerEnvironment and ContainerService to Managed::Environment and Managed::Service respectively.
• Health check uses Fiber.new{instance.ready!}.resume to confirm fiber allocation is working.

v0.14.4

• Use String::Format gem for formatting.