✨ (cron): Añade la extensión pagetop-cron
- Trabajos programados con expresiones cron (croner), `fixed_rate()` y `fixed_delay()`, declarados con la acción `DeclareCronJobs` y ajustables por su clave en `[cron.jobs."clave"]`. - Control de solapamiento, tiempo máximo, zona horaria por trabajo, ejecución al arrancar y bajo demanda con `run_now()`. - Modo `external` sin estado, para réplicas y escalado a cero: `POST /cron` con `Authorization: Bearer`, ventanas alineadas de `trigger_interval_secs` y respuesta al terminar los trabajos. - Estado con `jobs()`/`job()`, acción `AfterJobRun` y parada ordenada con `JobContext::is_stopping()`.
This commit is contained in:
parent
4c3f4dab1b
commit
86d9f0e213
22 changed files with 3678 additions and 1 deletions
50
extensions/pagetop-cron/src/error.rs
Normal file
50
extensions/pagetop-cron/src/error.rs
Normal file
|
|
@ -0,0 +1,50 @@
|
|||
//! Errores de `pagetop-cron`.
|
||||
|
||||
/// Errores al declarar, configurar o ejecutar trabajos programados.
|
||||
#[derive(Debug, thiserror::Error)]
|
||||
pub enum CronError {
|
||||
/// Una programación no es válida (p. ej. una expresión cron mal escrita o un intervalo nulo).
|
||||
#[error("invalid schedule \"{schedule}\": {reason}")]
|
||||
InvalidSchedule {
|
||||
/// Programación tal como se indicó.
|
||||
schedule: String,
|
||||
/// Motivo del error.
|
||||
reason: String,
|
||||
},
|
||||
/// La clave de un trabajo no es válida.
|
||||
#[error(
|
||||
"invalid job key \"{0}\": use lowercase letters, digits, '_', '-' and '.', starting with a \
|
||||
letter or digit"
|
||||
)]
|
||||
InvalidKey(String),
|
||||
/// Dos trabajos se declaran con la misma clave.
|
||||
#[error("job \"{0}\" is declared more than once")]
|
||||
DuplicateJob(String),
|
||||
/// Un trabajo no se puede programar, por su declaración o por sus ajustes.
|
||||
#[error("invalid job \"{key}\"")]
|
||||
InvalidJob {
|
||||
/// Clave del trabajo.
|
||||
key: String,
|
||||
/// Motivo del error.
|
||||
#[source]
|
||||
source: Box<CronError>,
|
||||
},
|
||||
/// Un ajuste de la sección `[cron]` no es válido.
|
||||
#[error("invalid cron setting \"{key}\": {reason}")]
|
||||
InvalidSetting {
|
||||
/// Clave del ajuste, p. ej. `"cron.trigger_token"`.
|
||||
key: &'static str,
|
||||
/// Motivo del error.
|
||||
reason: String,
|
||||
},
|
||||
/// No hay ningún trabajo declarado con la clave indicada.
|
||||
#[error("unknown job \"{0}\"")]
|
||||
UnknownJob(String),
|
||||
/// El trabajo ya se está ejecutando y no admite ejecuciones simultáneas
|
||||
/// ([`Overlap::Skip`](crate::Overlap::Skip)).
|
||||
#[error("job \"{0}\" is already running")]
|
||||
AlreadyRunning(String),
|
||||
/// Los trabajos aún no están disponibles: la aplicación no se ha preparado.
|
||||
#[error("cron jobs are not available until the application is prepared")]
|
||||
NotInitialized,
|
||||
}
|
||||
Loading…
Add table
Add a link
Reference in a new issue