Backend and the workers also write their log as JSON into the logs volume, one file a day kept 30 days (LOG_DIR, LOG_NAME, LOG_KEEP_DAYS), so errors can be looked up after a container is replaced. The Docker health check (/healthz every 30 s) no longer goes into the request log of the backend and the horoscope API. The home, login and packages pages no longer compare the analyses to an experienced astrologer's depth; they say what the user gets: detailed, personal text in minutes, for a fraction of a personal consultation's price. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012vLHzh5qUhFtmJhzkcTbXL
91 lines
6.1 KiB
Markdown
91 lines
6.1 KiB
Markdown
# 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:
|
|
```sh
|
|
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:
|
|
|
|
```sh
|
|
# 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 élőben: `docker compose logs -f backend worker worker-ai` (ez a konténer újraindításáig/cseréjéig él).
|
|
- Naplók utólag: a backend és a két worker JSON-sorokat ír a `logs` volume-ba is, naponta új fájlba (`backend.2026-11-20.log`, `worker…`, `worker-ai…`), 30 napig megőrizve (`LOG_DIR`, `LOG_KEEP_DAYS`, `LOG_NAME`). A fájlok helye a szerveren: `docker volume inspect -f '{{.Mountpoint}}' sorsfonalak_logs`, például `grep -h '"level":"ERROR"' /var/lib/docker/volumes/sorsfonalak_logs/_data/backend.*.log | tail`. A Docker 30 másodpercenkénti `/healthz` ellenőrzése nem kerül a naplóba.
|
|
- 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`
|