Obelica Docs
Operazioni

Smoke test staging

Verifica globale DNS, TLS, Traefik e container delle app staging

Obiettivo

Lo smoke test staging e' il controllo rapido da eseguire dopo ogni modifica a DNS, Traefik, Compose, deploy app o configurazioni pubbliche.

Il comando ufficiale locale e':

obelica smoke staging

Il comando usa SSH verso obelica-prod ed esegue lo script server:

/opt/obelica/infra/scripts/check-staging-apps.sh

La lista app controllata dallo script vive in:

/opt/obelica/infra/config/staging-apps.tsv

Cosa verifica

Per vps.obelica.com, test.obelica.com e ogni app in *.vps.obelica.com:

  • DNS A verso 129.212.141.97;
  • certificato HTTPS trusted;
  • status HTTP previsto;
  • remote IP uguale alla reserved IP;
  • container Docker running;
  • host rule presente nei router Traefik;
  • assenza di router app che espongono domini produzione *.obelica.com.

Interpretazione

Lo script usa la convenzione standard Obelica:

StatoSignificato
OKcontrollo passato
WARNanomalia non bloccante, da capire
UNKNOWNinformazione non leggibile o permessi insufficienti
FAILproblema reale da correggere prima di procedere

Exit code:

  • 0: nessun warning, unknown o fail;
  • 1: warning o unknown, ma nessun fail reale;
  • 2: almeno un fail reale.

Ultimo risultato noto

Verificato il 2026-06-22 dopo DNS staging e log rotation:

OK:      96
WARN:    0
UNKNOWN: 0
FAIL:    0

RESULT: STAGING APPS - OK

Quando usarlo

Eseguire sempre:

  • dopo modifiche a Traefik;
  • dopo docker compose up -d --build su app pubbliche;
  • dopo modifiche ai record DNS staging;
  • prima di considerare conclusa una sessione operativa sulla VPS;
  • prima di iniziare una migrazione produzione app per app.

Manutenzione della lista app

Quando una nuova app entra nello staging VPS, aggiungerla a:

/opt/obelica/infra/config/staging-apps.tsv

Poi rieseguire:

obelica smoke staging

Se una app viene rimossa dallo staging, rimuoverla dalla lista e confermare che Traefik non esponga piu' il dominio.

On this page