✨ (config): Admite variables de entorno

Las variables PAGETOP_<SECCIÓN>__<CLAVE> sobrescriben cualquier ajuste
de los archivos, como última capa de la cascada (p. ej.
PAGETOP_DATABASE__DB_PASS para db_pass de [database]).
This commit is contained in:
Manuel Cillero 2026-10-31 19:06:01 +01:00
parent f3228d6b59
commit 1df91ce4c8
10 changed files with 349 additions and 35 deletions

View file

@ -201,7 +201,8 @@ una clave secreta, una ruta expuesta) y pierde precisión. Mejor `"internal"`.
```toml
[cron]
mode = "external"
trigger_token = "..." # Clave secreta propia, mejor en config/local.toml.
trigger_token = "..." # Clave secreta propia, mejor en config/local.toml o en
# PAGETOP_CRON__TRIGGER_TOKEN.
trigger_interval_secs = 60 # Una llamada por minuto (el valor por defecto).
```

View file

@ -47,7 +47,8 @@ pub struct CronSettings {
/// Clave secreta que autoriza las llamadas a `POST /cron` con [`CronMode::External`], enviada
/// en la cabecera `Authorization: Bearer <clave>`. Obligatoria en ese modo, con 16 caracteres
/// o más (letras, dígitos, `-` o `_`), o la aplicación no arranca. Conviene guardarla en
/// `config/local.toml`, que no se versiona.
/// `config/local.toml`, que no se versiona, o pasarla con la variable de entorno
/// `PAGETOP_CRON__TRIGGER_TOKEN`.
pub trigger_token: Option<String>,
/// Segundos entre dos llamadas a `POST /cron` con [`CronMode::External`]. Cada llamada ejecuta
/// los trabajos programados en el último intervalo de esta duración, contado en múltiplos

View file

@ -206,7 +206,8 @@ una clave secreta, una ruta expuesta) y pierde precisión. Mejor `"internal"`.
```toml
[cron]
mode = "external"
trigger_token = "..." # Clave secreta propia, mejor en config/local.toml.
trigger_token = "..." # Clave secreta propia, mejor en config/local.toml o en
# PAGETOP_CRON__TRIGGER_TOKEN.
trigger_interval_secs = 60 # Una llamada por minuto (el valor por defecto).
```

View file

@ -59,7 +59,8 @@ base_url = "https://example.com"
host = "smtp.example.com"
security = "starttls" # "none", "opportunistic", "starttls" o "tls".
username = "no-reply@example.com"
password = "secreto" # Mejor en config/local.toml, que no se versiona.
password = "secreto" # Mejor en config/local.toml, que no se versiona, o en la
# variable de entorno PAGETOP_MAIL__SMTP__PASSWORD.
```
Sin configurar, los correos se escriben en las trazas en lugar de enviarse (`transport = "log"`),

View file

@ -152,7 +152,8 @@ pub struct SmtpSettings {
pub security: SmtpSecurity,
/// Usuario para autenticarse en el servidor. Sin valor, no se autentica.
pub username: Option<String>,
/// Contraseña del usuario. Conviene guardarla en `config/local.toml`, que no se versiona.
/// Contraseña del usuario. Conviene guardarla en `config/local.toml`, que no se versiona, o
/// pasarla con la variable de entorno `PAGETOP_MAIL__SMTP__PASSWORD`.
pub password: Option<String>,
/// Nombre con el que se presenta la aplicación al servidor (`EHLO`). Sin valor, el nombre del
/// equipo.

View file

@ -60,7 +60,8 @@ base_url = "https://example.com"
host = "smtp.example.com"
security = "starttls" # "none", "opportunistic", "starttls" o "tls".
username = "no-reply@example.com"
password = "secreto" # Mejor en config/local.toml, que no se versiona.
password = "secreto" # Mejor en config/local.toml, que no se versiona, o en la
# variable de entorno PAGETOP_MAIL__SMTP__PASSWORD.
```
Sin configurar, los correos se escriben en las trazas en lugar de enviarse (`transport = "log"`),