Files
sorsfonalak/deploy
fecoandClaude Opus 5.5 13cc1e6e7b
CI / test (push) Successful in 42s
CI / build (push) Failing after 3s
CI / deploy (push) Skipped
Gitea Actions CI: tests, image build to registry.sagifer.com, SSH deploy
- .gitea/workflows/ci.yml: test (Postgres service), build and push the
  four images tagged with the commit hash, deploy over SSH when
  DEPLOY_HOST is set
- ci/runner: act_runner 0.6.1 on the dev server using the host's Docker
- deploy/: production compose with Caddy (https), daily pg_dump backups,
  log rotation; setup guide

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012vLHzh5qUhFtmJhzkcTbXL
2026-11-16 19:29:51 +00:00
..

Build és telepítés

Minden main-re pusholt commit után lefut a .gitea/workflows/ci.yml (Gitea Actions):

  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 címke a commit hash első 12 karaktere, plusz latest. A frontend buildje a TypeScript-típusokat is ellenőrzi.
  3. deploy (csak ha a DEPLOY_HOST be van állítva): 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.

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, HTTP, HTTPS
ufw allow OpenSSH && ufw allow 80,443/tcp && ufw allow 443/udp && ufw enable

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

  • .env: az itteni .env.example kitöltve.
  • .env.secrets: OPENROUTER_API_KEY=....
  • docker login registry.sagifer.com egy read:package jogú tokennel. Amíg a sagifer fiók nyilvános, erre nincs szükség.

A domain DNS A rekordjai (@ és www) még az első telepítés előtt mutassanak a szerverre, különben a Caddy nem kap tanúsítványt. A Google OAuth kliensnél a https://<domain> címet fel kell venni az engedélyezett JavaScript-források közé.

Üzemeltetés

  • Naplók: docker compose logs -f backend worker
  • 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