Obelica Docs
Operazioni

Deploy manuale da Forgejo

Flusso manuale controllato prima dell'autodeploy

Obiettivo

Standardizzare il flusso:

Forgejo repo -> checkout server -> Docker build -> Compose up -> smoke test

Regola importante

Non pushare direttamente verso il bare repository host:

/opt/obelica/data/forgejo/app/git/repositories/.../*.git

I push devono passare da Forgejo HTTP, UI o futuro SSH Git. I hook Forgejo devono girare nel contesto corretto.

Fetch/pull locale da bare repo per deploy server puo' essere accettabile, ma i push no.

Layout

/opt/obelica/repos/<repo-name>
/opt/obelica/apps/<app-name>
/opt/obelica/secrets/apps/<app-name>.env

Procedura

  1. Verificare repo.
cd /opt/obelica/repos/<repo-name>
git status --short --branch
git fetch origin main
git pull --ff-only origin main
  1. Build e avvio.
cd /opt/obelica/apps/<app-name>
docker compose up -d --build
  1. Verificare container.
docker compose ps
docker logs <container-name> --tail=100
  1. Smoke test.
curl -I http://127.0.0.1:<local-port>
  1. Verificare porte.
ss -tulpen | rg '<local-port>|:80|:443'

Primo test completato

Repo:

bona/obelica-docs

Runtime:

/opt/obelica/apps/obelica-docs

Risultato:

  • Docker build OK;
  • container obelica-docs running;
  • bind 127.0.0.1:3334;
  • /docs risponde 200.

On this page