- Admin "Híres emberek": birth data, one photo (S3: DigitalOcean Spaces in production, RustFS in development), a face point that every crop keeps in view, publishing, and a detailed portrait written with its own `celebrity` prompt (third person, by name, from the chart alone). - The photo is stored once (upright JPEG, at most 2000 px, no metadata); next/image makes the sizes from it, so Cloudflare can cache those. - Public list and pages (/hires-emberek), in the sitemap, with a share image showing the face and the chart. - Share images: the wheel's glyphs and numbers are drawn with the card's fonts (inside the SVG image they came out as boxes, on every card). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012vLHzh5qUhFtmJhzkcTbXL
Build és telepítés
A .gitea/workflows/ci.yml (Gitea Actions) két ágra fut:
- main: csak tesztek.
- prod: tesztek, image-build, majd telepítés a szerverre. Címkék: a commit hash első 12 karaktere,
prodéslatest. Élesíteni tehát úgy kell, hogy a main-t a prod-ba mergeled (vagy pusholod).
A runner egyszerre egy feladatot futtat; ha a main is buildelne, minden kitett commit kétszer épülne, és a két futás feladatai egymás közé ékelődnének. A fordítási hibák (például a frontend TypeScript-ellenőrzése) így a prod buildben derülnek ki, ezért kitétel előtt helyben is érdemes buildelni.
A lépések:
- test:
cargo testa backendre, a workerre, a db-re, a horoscope-clientre és a service-kitre, egy Postgres szolgáltatás-konténerrel. - build (csak prod): 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. - deploy (csak prod): felmásolja a
docker-compose.yml-t és aCaddyfile-t a szerverre, beírja az újTAG-et a szerveren lévő.env-be, majddocker compose pull && up -d. Az adatbázis-migrációk a backend indulásakor futnak le. - 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.
- Regisztrációs token: Gitea → repó → Beállítások → Actions → Runners → Create new runner.
- Indítás:
A regisztráció a
cd ci/runner GITEA_RUNNER_REGISTRATION_TOKEN=<token> docker compose up -drunner-datakö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.examplekitöltve..env.secrets:OPENROUTER_API_KEY=..., a levélküldés adatai, és ha van,STRIPE_SECRET_KEY/STRIPE_WEBHOOK_SECRETésBILLINGO_API_KEY(docs/fizetes.md).docker login registry.sagifer.comegyread:packagejogú tokennel. Amíg asagiferfiók nyilvános, erre nincs szükség.
Cloudflare (sorsfonalak.hu)
- DNS:
A sorsfonalak.hu → 165.22.194.5ésCNAME 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). - AI-robotok: Security → Settings → Bot traffic → AI Crawler and Agent access policies: Training: Block, Search: Allow, Agents: Allow (a részletek:
docs/megosztas.md, Robotok). Bot Fight Mode: ki, mert a link-előnézeteket is elrontja.
A Google OAuth kliensnél a https://sorsfonalak.hu címet fel kell venni az engedélyezett JavaScript-források közé.
Fotók: DigitalOcean Spaces (híres emberek)
A híres emberek fotóit a backend S3-kompatibilis tárolóba teszi, fotónként egyetlen változatot (álló JPEG, legfeljebb 2000 px, metaadatok nélkül). A tároló privát marad. A backend a /v1/public/photos/... címen adja ki a képet, a méretezett változatokat a Next.js képoptimalizálója készíti (/_next/image), és ezeket a Cloudflare cache-eli. Minden feltöltés új kulcsot kap, ezért a régi kép sosem ragad be a cache-ben.
- Spaces: Create → Spaces Object Storage, régió például
fra1, név példáulsorsfonalak-photos. A File Listing legyen Restricted. CDN nem kell. - Kulcs: Spaces Object Storage → Access Keys → Limited access, csak erre a bucketre, Read/Write/Delete joggal.
.env:S3_ENDPOINT=https://fra1.digitaloceanspaces.com,S3_BUCKET=sorsfonalak-photos(aS3_REGIONmaradhatus-east-1)..env.secrets:S3_ACCESS_KEY_IDésS3_SECRET_ACCESS_KEY. Utánadocker compose up -d backend.- Ha nincs beállítva
S3_ENDPOINT, minden más működik, csak fotót nem lehet feltölteni. - A fotók nincsenek benne a napi
pg_dump-ban. A Spaces maga is több példányban tárol, de ha a bucketet törlik, a fotókat újra fel kell tölteni. - Cloudflare: Caching → Cache Rules → új szabály: URI Path starts with
/_next/image→ Eligible for cache, Edge TTL: Use cache-control header if present. Kiterjesztés nélküli címet a Cloudflare magától nem cache-el, a szabály nélkül minden méretet a szerver számolna újra. A Next csak WebP-t ad, ezért nem gond, hogy a Cloudflare azAcceptfejlécet nem veszi figyelembe.
Ü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
logsvolume-ba is, szolgáltatásonként külön mappába, UTC-nap szerint új fájlba (backend/backend.2026-11-20.log,worker/…,worker-ai/…; a nap magyar idő szerint hajnali 1-2 órakor fordul). 30 napig maradnak meg, naponta legfeljebb 50 MB (LOG_KEEP_DAYS,LOG_MAX_DAY_MB,LOG_DIR,LOG_NAME); a kérések útvonalában az e-mail-címek és a tokenek maszkolva vannak. A fájlok helye:docker volume inspect -f '{{.Mountpoint}}' sorsfonalak_logs, példáulgrep -h '"level":"ERROR"' /var/lib/docker/volumes/sorsfonalak_logs/_data/backend/*.log | tail. A Docker 30 másodpercenkénti/healthzellenőrzése csak akkor kerül a naplóba, ha hibás. - Deploy és futó feladatok: leállításkor a worker nem vesz fel újat, a futókat befejezi (
SHUTDOWN_DRAIN_SECS:worker40 s,worker-ai270 s,stop_grace_period1, illetve 5 perc); ami addig nem készül el, visszakerül a sorba, a próbálkozás nem számít. Ha éppen elemzés készül, a deploy ennyivel tovább tarthat. - A worker két konténerben fut, ugyanabból az image-ből: a
workerküldi az e-maileket és takarít (WORKER_TASKS=email,cleanup, ide kerülnek a további háttérfeladatok is), aworker-aiírja az elemzéseket és a válaszokat (WORKER_TASKS=analyses, gyors és lassú sáv). A sávok mérete a szerver.envfájljában állítható (QUICK_CONCURRENCY,ANALYSIS_CONCURRENCY). - Visszaállás korábbi verzióra:
.env-benTAG=<régebbi hash>, utánadocker compose up -d - Mentés: naponta egy
pg_dumpa/opt/sorsfonalak/backupsmappába, 14 napig megmarad. Az otthoni TrueNAS naponta lehúzza (Rsync Task, Pull, SSH) anasbackupfelhasználóval, aki csak ezt a mappát olvashatja (authorized_keys:command="/usr/bin/rrsync -ro /opt/sorsfonalak/backups",restrict); a NAS-on a régi mentések is megmaradnak. - Vásárlási értesítő: a
workernotifyfeladata minden kifizetett vásárlásról egyszer szól Telegramon („🛒 Vásárlás: Páros csomag, 6 000 Ft”, a vevő adatai nélkül), a számlázástól függetlenül. Beállítás:TELEGRAM_BOT_TOKENa.env.secrets-ben,TELEGRAM_CHAT_IDa.env-ben; ha bármelyik hiányzik, nincs értesítés. - Monitorozás: a
beszel-agent(Beszel, CPU/memória/lemez/konténerek) a NAS-on futó Beszel hubnak ad adatot, Tailscale-en át. Csak a szerver Tailscale-címén figyel (100.69.226.118:45876), az internet felé nem nyit portot; a hub kapcsolódik hozzá. Bekapcsolás a.env-ben:COMPOSE_PROFILES=monitoringésBESZEL_KEY=<a hub nyilvános kulcsa>, utánadocker compose up -d beszel-agent. A hubban a rendszer címe100.69.226.118, port45876. - Visszatöltés:
gunzip -c backups/sorsfonalak-<dátum>.sql.gz | docker compose exec -T postgres psql -U sorsfonalak sorsfonalak