mcuadros/ofelia
Ofelia
Ofelia is a recurring job scheduler designed to run commands inside Docker containers or directly on the host system using a defined timetable. It functions as a configuration engine that reads job schedules and commands from container labels, a concurrency guard to prevent overlapping task executions, and a log router for reporting job outcomes.
The system distinguishes itself by using a label-based configuration model, allowing job schedules and execution logic to be defined within container metadata rather than external configuration files. It employs a lock-based concurrency control mechanism to ensure a scheduled task does not start if a previous instance of the same job is still running.
The project covers a broad capability surface including high-precision temporal scheduling, hybrid runtime execution across host and container environments, and pluggable log routing to destinations such as webhooks, email, or local files.
Features
- Configuration via Labels - Uses Docker container labels as the primary configuration mechanism to define job schedules and execution logic.
- Cron Scheduling - Provides a scheduling engine that uses cron expressions to trigger tasks with second-level precision.
- Job Schedulers - Functions as a dedicated job scheduler for automating recurring operations across Docker containers and the host.
- Container Command Executors - Executes arbitrary commands inside existing Docker containers or spawns temporary ones for specific tasks.
- Task Concurrency Control - Prevents redundant task execution by using locks to ensure a job does not start if a previous run is active.
- Scheduled Container Tasks - Provides a system for automating recurring commands inside Docker containers using a defined timetable.
- Containerized Task Execution - Runs recurring maintenance and system jobs by executing commands in existing containers or spawning temporary ones.
- Docker Container Execution - Executes commands and manages container lifecycles by communicating directly with the Docker socket.
- Job Concurrency Controllers - Implements lock-based concurrency control to prevent multiple instances of the same scheduled job from overlapping.
- Recurring Maintenance Scheduling - Automates repetitive system maintenance and operational tasks using a high-precision recurring timetable.
- Hybrid Host-Container Execution - Supports the flexibility to run scheduled jobs either inside a sandboxed container or directly on the host.
- Scheduled Command Execution - Enables the scheduling and execution of commands directly on the local host system.
- Job Scheduling - Manages background processing jobs with a focus on preventing overlapping executions.
- Job Execution Logging - Provides a pluggable system for routing job outcomes and execution reports to webhooks, email, or local files.
- Pluggable Logging Backends - Ships a pluggable reporting interface to route execution logs and outcomes to webhooks, email, or files.
- Container Utilities - Job scheduler for running tasks in containers.
- In-Container Tooling - Modern job scheduler for container environments.
