Comandi operativi

CLI server

Control plane Rust:

/opt/obelica/infra/tools/obelica
/opt/obelica/infra/bin/obelica -> /opt/obelica/infra/tools/obelica/target/release/obelica

Wrapper globale storico:

/usr/local/bin/obelica

Stato 2026-06-24: il binario Rust e' installato e testato in /opt/obelica/infra/bin/obelica e promosso anche come /usr/local/bin/obelica. Se il binario operativo cambia, ripromuovere la copia globale con sudo.

Comandi:

OBELICA=/opt/obelica/infra/bin/obelica

$OBELICA help
$OBELICA --version
$OBELICA status
$OBELICA health
$OBELICA doctor
$OBELICA dns test.obelica.com
$OBELICA security
$OBELICA backup run
$OBELICA backup status
$OBELICA backup offsite-sync
$OBELICA backup offsite-sync-all
$OBELICA backup verify-offsite
$OBELICA backup prune-local --keep 1
$OBELICA backup configs
$OBELICA backup decrypt <input> [output]
$OBELICA smoke staging
$OBELICA cron list
$OBELICA cron run <job>
$OBELICA deploy docs
$OBELICA app status <name>
$OBELICA app deploy <name>
$OBELICA actions-runner

Dopo la promozione del binario a /usr/local/bin/obelica, gli stessi comandi potranno essere eseguiti come obelica ....

Check consigliati

Dopo modifiche normali:

/opt/obelica/infra/bin/obelica status
/opt/obelica/infra/bin/obelica doctor
/opt/obelica/infra/bin/obelica dns test.obelica.com
/opt/obelica/infra/bin/obelica smoke staging

Dopo modifiche sicurezza:

/opt/obelica/infra/bin/obelica security
/opt/obelica/infra/bin/obelica doctor

Prima di modifiche infrastrutturali importanti:

/opt/obelica/infra/bin/obelica backup configs
/opt/obelica/infra/bin/obelica backup run

Dopo modifiche a DNS, Traefik, Compose o deploy app pubblici:

/opt/obelica/infra/bin/obelica smoke staging

Stack Compose

Traefik:

cd /opt/obelica/infra/traefik
docker compose ps
docker compose up -d
docker compose logs --tail=100

Forgejo:

cd /opt/obelica/infra/forgejo
docker compose ps
docker compose up -d
docker compose logs --tail=100

Docs:

cd /opt/obelica/apps/obelica-docs
docker compose ps
docker compose up -d --build
docker compose logs --tail=100

Whoami:

cd /opt/obelica/apps/whoami
docker compose ps
docker compose up -d
docker compose logs --tail=100

Runtime read-only

docker ps
docker network ls
docker compose ls
ss -tulpen
systemctl is-active docker ssh fail2ban ufw
df -h /
free -h

Exit code script

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

I controlli privilegiati usano sudo -n. Se la sessione non puo' elevare senza prompt, lo stato diventa UNKNOWN.

Framework Rust

Il framework operativo Rust centralizza le funzioni che prima erano distribuite fra script shell in /opt/obelica/infra/scripts e /opt/obelica/infra/cron.

Moduli attuali:

status, health, doctor, security, dns: diagnostica VPS;
smoke staging: test HTTPS/DNS/router/container per le app su *.vps.obelica.com;
backup run/status/offsite-sync/configs/decrypt: orchestrazione backup;
backup offsite-sync-all/verify-offsite/prune-local: retention offsite-first e pulizia sicura degli snapshot locali;
cron list/run: chiamata controllata degli endpoint cron applicativi;
deploy docs e app deploy/status: helper deploy controllati;
actions-runner: controllo runner Forgejo.

I vecchi script shell restano temporaneamente come fallback/compatibilita' finche' runner docs, cron staging e documentazione non verranno migrati al 100% sul control plane Rust.