70 lines
3.8 KiB
Markdown
70 lines
3.8 KiB
Markdown
# 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:
|
||
|
|
```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, 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`
|