Tool locali Mac

Concetto

obelica-tools e' il CLI locale installabile sul Mac. Il binario si chiama obelica e serve a lavorare con i servizi privati della VPS senza esporli pubblicamente.

Uso tipico:

obelica tunnel all

Questo apre tunnel SSH locali verso Forgejo, Fumadocs e Traefik. Dopo il tunnel, Forgejo si usa come un GitHub privato:

git pull
git push

Se il repository ha Actions/runner configurati, il push su Forgejo attiva gli autodeploy configurati.

Attenzione al contesto

Esistono due CLI chiamati obelica:

Quando lavori dal Mac, obelica tunnel all e' il prerequisito per usare remote Git basati su http://127.0.0.1:3333/....

Quando lavori via SSH sulla VPS, obelica health, obelica doctor e obelica smoke staging usano il control plane server.

Repo

bona/obelica-tools

Primo bootstrap

1. Verificare alias SSH:

ssh obelica-prod

2. Se il repo obelica-tools non e' ancora clonato, aprire temporaneamente il tunnel Forgejo:

ssh -L 3333:127.0.0.1:3333 obelica-prod

3. In un altro terminale clonare:

git clone http://127.0.0.1:3333/bona/obelica-tools.git
cd obelica-tools

4. Installare:

cargo install --path .

5. Testare:

obelica services
obelica tunnel docs --open
obelica tunnel all
obelica smoke staging

Uso quotidiano

Aprire tutti i tunnel privati:

obelica tunnel all

Oppure aprire e lanciare il browser:

obelica tunnel all --open

Tunnel singoli:

obelica tunnel forgejo --open
obelica tunnel docs --open
obelica tunnel traefik --open

Servizi locali dopo obelica tunnel all:

Workflow Git con Forgejo privato

1. Aprire i tunnel:

obelica tunnel all

2. In un altro terminale lavorare normalmente:

cd ~/Developer/obelica-docs
git pull
git checkout -b my-branch
git commit -am "docs: update"
git push

3. Forgejo riceve il push tramite 127.0.0.1:3333.

4. Se il repo ha Actions/runner configurati, parte l'autodeploy.

Se git fetch, Cursor o VS Code mostrano:

Failed to connect to 127.0.0.1 port 3333

significa che il tunnel Forgejo non e' attivo nel contesto locale che sta eseguendo Git. Aprire obelica tunnel all e riprovare.

Smoke test staging

obelica smoke staging

Esegue via SSH lo smoke test server.

Va usato dopo modifiche a DNS, Traefik, Compose o deploy app. Il risultato atteso per una situazione pulita e':

RESULT: STAGING APPS - OK

Nota porte

Il CLI controlla se le porte locali sono libere. Se un tunnel e' gia' aperto, puo' fallire per porta occupata.

Opzioni:

• chiudere il tunnel precedente;
• usare --no-port-check solo se si sa cosa si sta facendo.