Serverless Scale-to-Zero Dual-Lane Dispatch QueueConfig routes interactive tasks (<= 30m) to CloudTasksExecutionConfig push webhooks and heavy batch tasks to CloudRunExecutionConfig one-shot Job containers. Multi-Backend Router QueueConfig execution_backend = CloudTasks execution_backends = (CloudRun,) @task(execution_backend="cloudrun") schedules_on_enqueue=True Fast Push Lane (<= 30 min) CloudTasksExecutionBackend Dispatches OIDC-signed HTTP POST Schedule Horizon up to 30 days ahead Heavy Batch Lane (Multi-Hour) CloudRunExecutionBackend Calls JobsClient.run_job(overrides) Injects QUEUES_TASK_ID env var Cloud Run Service Webhook /_litestar-queues/cloud-tasks CloudTasksOIDCGuard + claim_task Active lease -> 503; stale -> reclaim Cloud Run Job Execution litestar queues run-task Dedicated CPU/RAM container Exits 0 on complete, 1 on retry/fail
Six-Phase QueueMaintenanceService Sweep Ordered execution of expire, external, stale, schedules, terminal, and events phases via /_litestar-queues/maintenance or litestar queues run-maintenance. 1. expire Expire queued tasks past expires_at expire_pending 2. external Reconcile Cloud Run / Tasks refs reconcile_task 3. stale Reclaim stale running leases & redispatch requeue_stale 4. schedules Claim due cron/interval & enqueue claim_due 5. terminal Delete old terminal rows past retention cleanup_tasks 6. events Prune expired QueueEventLog history rows cleanup_events