fvbock/endless
Endless
Endless is a zero-downtime server wrapper and process manager for Go HTTP servers. It replaces standard library listeners to coordinate process transitions and socket management, allowing binaries to be updated without dropping active network connections.
The project enables zero-downtime restarts by forking a new child process to take over network sockets before the parent process shuts down. It manages secure traffic flow by wrapping servers with TLS encryption layers and supports coordination for both standard network ports and Unix sockets.
The system handles the server lifecycle through signal-driven management, executing specific setup and cleanup functions during restarts. It ensures continuous availability through socket-handoff coordination and provides graceful shutdown mechanisms that drain active requests or terminate hanging connections after a defined grace period.
Features
- Zero-Downtime Upgrades - Provides a mechanism for updating service binaries without dropping active connections through socket handover.
- Zero-Downtime Binaries Upgrades - Replaces Go service binaries without dropping network connections by handing over sockets to a new process.
- Socket Handoffs - Transfers listening network ports between process instances to prevent dropping incoming requests during updates.
- Go Server Process Managers - Provides lifecycle control for Go applications, coordinating process transitions and monitoring system signals.
- Signal-Driven Process Spawning - Uses operating system signals to trigger the spawning of new process instances for seamless binary upgrades.
- System Signal Handling - Defines custom routines to handle operating system signals for application state management and cleanup.
- Binary Swaps - Enables updating server binaries by forking a new process to take over network sockets before the parent exits.
- HTTP Server Implementations - Provides a custom HTTP server listener implementation that manages system signals and graceful process handovers.
- Connection Termination - Force-terminates lingering network connections after a defined grace period during server shutdown.
- Graceful Shutdowns - Ensures clean termination of Go servers by allowing in-flight requests to complete within a grace period.
- Unix Socket Handoffs - Coordinates Unix socket transitions between parent and child processes to ensure continuous request handling.
- High Availability Server Networking - Ensures continuous service availability by running multiple server instances on different ports from a single binary.
- Multi-Port Listeners - Manages multiple server listeners on different ports within a single binary to facilitate coordinated restarts.
- Independent Server Instance Hosting - Supports running multiple independent server instances with distinct sockets from a single binary to coordinate restarts.
- TLS Servers - Implements a secure TLS server that maintains encrypted traffic flow during binary swaps and restarts.
- TLS Session Wrapping - Wraps standard HTTP servers with TLS encryption layers while preserving the ability to perform process rotations.
- Security & HTTPS - Manages TLS certificates and encryption protocols to maintain secure communication during seamless binary swaps.
- TLS Traffic Encryption - Secures communication channels using TLS certificates while maintaining stability during server restarts.
- Connection Draining - Implements network connection draining to allow active HTTP requests to finish before the server process terminates.
