Files
sorsfonalak/deploy/README.md
T
fecoandClaude Opus 5.5 2a0830fda0
CI / test (push) Successful in 1m29s
CI / build (push) Successful in 9m7s
CI / deploy (push) Skipped
Invoices: issued in Billingo by the worker, downloadable on Számláim
A paid checkout queues an invoice row with every invoice detail (buyer,
tax type and number, item, net, VAT, gross). The worker's new 'invoices'
task creates the Billingo partner and the paid card invoice and e-mails
it (API v3), saving each step so a retry never issues a second invoice,
and keeps Billingo's whole answer; the PDF is fetched from Billingo when
the user downloads it from the new Számláim page (in the menu once there
is an invoice). Payments and invoices outlive a deleted account.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012vLHzh5qUhFtmJhzkcTbXL
2026-11-20 07:52:34 +00:00

5.6 KiB

Build és telepítés

A .gitea/workflows/ci.yml (Gitea Actions) két ágra fut:

  • main: tesztek, majd image-build. Címkék: a commit hash első 12 karaktere és main.
  • prod: ugyanez, majd telepítés a szerverre. Címkék: hash, prod és latest. Élesíteni tehát úgy kell, hogy a main-t a prod-ba mergeled (vagy pusholod).

A lépések:

  1. test: cargo test a backendre, a workerre, a db-re, a horoscope-clientre és a service-kitre, egy Postgres szolgáltatás-konténerrel.
  2. build: megépíti a négy image-et, és feltölti őket a registry.sagifer.com/sagifer/sorsfonalak-<szolgáltatás> címre. A frontend buildje a TypeScript-típusokat is ellenőrzi. Egy main-en már megépült commit a cache-ből pár mp alatt újraépül.
  3. deploy (csak prod): felmásolja a docker-compose.yml-t és a Caddyfile-t a szerverre, beírja az új TAG-et a szerveren lévő .env-be, majd docker compose pull && up -d. Az adatbázis-migrációk a backend indulásakor futnak le.
  4. release (csak prod, a deploy után): létrehoz egy v<év.hónap.nap>-<hash> taget és Gitea-release-t az előző release óta bekerült commitok listájával (repó → Releases).

Kézzel is indítható a repó Actions oldaláról (workflow_dispatch).

Runner (dev szerver)

A runner a ci/runner mappában van. A jobokat a gép Dockerén indítja, így az image-buildek a meglévő BuildKit cache-t használják. A tesztek cargo-cache-e a sorsfonalak-ci-* kötetekben marad meg.

  1. Regisztrációs token: Gitea → repó → Beállítások → Actions → Runners → Create new runner.
  2. Indítás:
    cd ci/runner
    GITEA_RUNNER_REGISTRATION_TOKEN=<token> docker compose up -d
    
    A regisztráció a runner-data kötetbe kerül. A későbbi indításokhoz már nem kell token.

A jobok elérik a gép Docker-socketjét, ez root-jogot jelent a dev szerveren. A workflow csak a repóba pusholt commitokra fut, forkból érkező pull requestekre nem.

Repó-beállítások

Gitea → repó → Beállítások → Actions:

Név Fajta Érték
REGISTRY_TOKEN secret a sagifer fiók access tokenje, write:package jogosultsággal
DEPLOY_SSH_KEY secret a szerveren lévő deploy felhasználó privát kulcsa
DEPLOY_HOST variable deploy@<szerver IP>
DEPLOY_KNOWN_HOSTS variable az ssh-keyscan <szerver IP> kimenete
DEPLOY_PATH variable nem kötelező, alapértéke /opt/sorsfonalak

Szerver (egyszeri beállítás)

Egy friss Ubuntu dropleten, rootként:

# Docker
curl -fsSL https://get.docker.com | sh
# 2 GB swap a 2 GB RAM mellé
fallocate -l 2G /swapfile && chmod 600 /swapfile && mkswap /swapfile && swapon /swapfile
echo '/swapfile none swap sw 0 0' >> /etc/fstab
# deploy felhasználó, aki dockert futtathat
adduser --disabled-password --gecos '' deploy && usermod -aG docker deploy
mkdir -p /home/deploy/.ssh && echo '<publikus kulcs>' > /home/deploy/.ssh/authorized_keys
chown -R deploy: /home/deploy/.ssh && chmod 700 /home/deploy/.ssh && chmod 600 /home/deploy/.ssh/authorized_keys
mkdir -p /opt/sorsfonalak && chown deploy: /opt/sorsfonalak
# tűzfal: SSH bárhonnan, HTTP/HTTPS csak a Cloudflare felől
ufw allow OpenSSH
for net in $(curl -s https://www.cloudflare.com/ips-v4) $(curl -s https://www.cloudflare.com/ips-v6); do
  ufw allow from "$net" to any port 80,443 proto tcp
done
ufw enable

A Docker által kinyitott portokat az ufw magától nem szűri, ezért a 80-as és a 443-as portot a DigitalOcean Cloud Firewall-ban is érdemes a Cloudflare tartományaira korlátozni: Networking → Firewalls, Inbound: SSH, és HTTP/HTTPS a Cloudflare IP-listával.

deploy felhasználóként, a /opt/sorsfonalak mappában:

  • .env: az itteni .env.example kitöltve.
  • .env.secrets: OPENROUTER_API_KEY=..., a levélküldés adatai, és ha van, STRIPE_SECRET_KEY / STRIPE_WEBHOOK_SECRET és BILLINGO_API_KEY (docs/fizetes.md).
  • docker login registry.sagifer.com egy read:package jogú tokennel. Amíg a sagifer fiók nyilvános, erre nincs szükség.

Cloudflare (sorsfonalak.hu)

  • DNS: A sorsfonalak.hu → 165.22.194.5 és CNAME www → sorsfonalak.hu, mindkettő proxyzva (narancs felhő).
  • SSL/TLS mód: Full (strict).
  • Always Use HTTPS: ki. A Let's Encrypt a Cloudflare-en át, sima HTTP-n ellenőrzi a domaint, a tanúsítvány megújításakor is. A HTTP→HTTPS átirányítást a Caddy maga végzi.
  • A Caddy a Cloudflare címtartományaiban megbízik, ezért a naplókban és a backendnél a látogató valódi IP-címe látszik (CF-Connecting-IP).

A Google OAuth kliensnél a https://sorsfonalak.hu címet fel kell venni az engedélyezett JavaScript-források közé.

Üzemeltetés

  • Naplók: docker compose logs -f backend worker worker-ai
  • A worker két konténerben fut, ugyanabból az image-ből: a worker küldi az e-maileket és takarít (WORKER_TASKS=email,cleanup, ide kerülnek a további háttérfeladatok is), a worker-ai írja az elemzéseket és a válaszokat (WORKER_TASKS=analyses, gyors és lassú sáv). A sávok mérete a szerver .env fájljában állítható (QUICK_CONCURRENCY, ANALYSIS_CONCURRENCY).
  • Visszaállás korábbi verzióra: .env-ben TAG=<régebbi hash>, utána docker compose up -d
  • Mentés: naponta egy pg_dump a /opt/sorsfonalak/backups mappába, 14 napig megmarad. A mentéseket érdemes a szerverről is elvinni (DigitalOcean backup, vagy rsync otthonra).
  • Visszatöltés: gunzip -c backups/sorsfonalak-<dátum>.sql.gz | docker compose exec -T postgres psql -U sorsfonalak sorsfonalak