How ankit0514/chronos-job_scheduling works
Chronos is a C++ workload scheduler prototype. Its main distributed workflow accepts jobs through an authenticated HTTP API, persists job metadata and publishes events, then a scheduler consumes submissions, selects a healthy worker, records state and publishes assignments. Workers report heartbeats and execution events; retries and workflow DAG execution are additional capabilities. The repository also offers an in-memory thread-pool scheduler. The README documents integration boundaries; sampled source confirms key scheduler dispatch behavior, but does not expose every service or worker-agent interaction.
Main entry points: scheduler_service_main.cpp Scheduler service · api_main.cpp API service entry · in_memory_scheduler.cpp In-memory scheduler · job_repository.cpp Job repository
Components 22
API ingress
- HTTP gateway
src/api_gateway.cpp - API service entry
src/api_main.cpp
Persistence and events
- Job repository
src/job_repository.cpp - PostgreSQL
- Kafka event bus
src/kafka_event_bus.cpp - Kafka
Scheduling
- Job model
include/chronos/domain/job.hpp - Job states
include/chronos/domain/job_state.hpp - Scheduler service
src/scheduler_service_main.cpp - Worker selector
src/worker_selector.cpp - Retry policy
src/retry_policy.cpp - In-memory scheduler
src/in_memory_scheduler.cpp - Priority queue
src/job_priority_queue.cpp
Worker management
- Worker manager
src/worker_manager.cpp - Worker model
include/chronos/domain/worker.hpp - Worker manager service
src/worker_manager_service_main.cpp - Redis worker store
src/redis_worker_store.cpp - Redis
- Worker agent
src/worker_agent_main.cpp
Workflow execution
- Workflow graph
src/workflow_graph.cpp - Workflow executor
src/workflow_executor.cpp
Other components
- API client
Connections 21
- API client → HTTP gateway: submits jobs
README.md - HTTP gateway → API service entry: routes requests
- API service entry → Job repository: persists metadata
README.md - API service entry → Kafka event bus: publishes events
README.md - Job repository → PostgreSQL: reads and writes
README.md - Kafka event bus → Kafka: publishes events
README.md - Kafka → Scheduler service: delivers submissions
src/scheduler_service_main.cpp - Scheduler service → Kafka event bus: publishes assignments
src/scheduler_service_main.cpp - Scheduler service → Job repository: transitions job state
src/scheduler_service_main.cpp - Scheduler service → Worker selector: selects worker
src/scheduler_service_main.cpp - Scheduler service → Worker manager: tracks workers
src/scheduler_service_main.cpp - Scheduler service → Retry policy: computes retry delay
src/scheduler_service_main.cpp - Scheduler service → Job model: handles jobs
src/scheduler_service_main.cpp - Scheduler service → Job states: transitions states
src/scheduler_service_main.cpp - Worker agent → Kafka: reports events
README.md - Worker manager service → Redis worker store: stores worker state
- Redis worker store → Redis: stores expiring state
README.md - In-memory scheduler → Priority queue: queues jobs
- In-memory scheduler → Retry policy: applies retries
- Workflow executor → Workflow graph: executes DAG
- Workflow executor → In-memory scheduler: schedules tasks