From 19e5badc0718b59c16fa71cbcab959c7ec9c298d Mon Sep 17 00:00:00 2001 From: feco Date: Sat, 21 Nov 2026 10:16:12 +0000 Subject: [PATCH] deploy: optional Beszel monitoring agent on the Tailscale address Off unless COMPOSE_PROFILES=monitoring and BESZEL_KEY are set in .env. Also documents the TrueNAS pull of the daily backups. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_012vLHzh5qUhFtmJhzkcTbXL --- deploy/.env.example | 4 ++++ deploy/README.md | 3 ++- deploy/docker-compose.yml | 18 ++++++++++++++++++ 3 files changed, 24 insertions(+), 1 deletion(-) diff --git a/deploy/.env.example b/deploy/.env.example index 350f4ca..7f97a1d 100644 --- a/deploy/.env.example +++ b/deploy/.env.example @@ -24,3 +24,7 @@ TAG=latest # worker-ai: analyses and answers written at the same time. # QUICK_CONCURRENCY=2 # summaries and answers # ANALYSIS_CONCURRENCY=4 # detailed analyses and forecasts + +# Beszel monitoring agent (deploy/README.md): the hub's public key. +# COMPOSE_PROFILES=monitoring +# BESZEL_KEY=ssh-ed25519 AAAA... diff --git a/deploy/README.md b/deploy/README.md index 7c49ae2..a8cf47d 100644 --- a/deploy/README.md +++ b/deploy/README.md @@ -87,5 +87,6 @@ A Google OAuth kliensnél a `https://sorsfonalak.hu` címet fel kell venni az en - Deploy és futó feladatok: leállításkor a worker nem vesz fel újat, a futókat befejezi (`SHUTDOWN_DRAIN_SECS`: `worker` 40 s, `worker-ai` 270 s, `stop_grace_period` 1, 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 `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=`, 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). +- Mentés: naponta egy `pg_dump` a `/opt/sorsfonalak/backups` mappába, 14 napig megmarad. Az otthoni TrueNAS naponta lehúzza (Rsync Task, Pull, SSH) a `nasbackup` felhaszná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. +- 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` és `BESZEL_KEY=`, utána `docker compose up -d beszel-agent`. A hubban a rendszer címe `100.69.226.118`, port `45876`. - Visszatöltés: `gunzip -c backups/sorsfonalak-.sql.gz | docker compose exec -T postgres psql -U sorsfonalak sorsfonalak` diff --git a/deploy/docker-compose.yml b/deploy/docker-compose.yml index 550f8ed..65bbaa6 100644 --- a/deploy/docker-compose.yml +++ b/deploy/docker-compose.yml @@ -196,9 +196,27 @@ services: logging: *logging restart: unless-stopped + # Beszel agent: CPU, memory, disk, network and per-container stats for the + # Beszel hub on the home NAS. Off unless COMPOSE_PROFILES=monitoring and + # BESZEL_KEY (the hub's public key) are in .env. It listens only on the + # server's Tailscale address, so nothing is opened to the internet. + beszel-agent: + image: henrygd/beszel-agent:0.21.2 + profiles: [monitoring] + network_mode: host + environment: + KEY: ${BESZEL_KEY:-} + LISTEN: ${BESZEL_LISTEN:-100.69.226.118:45876} + volumes: + - beszel-agent:/var/lib/beszel-agent + - /var/run/docker.sock:/var/run/docker.sock:ro + logging: *logging + restart: unless-stopped + volumes: pgdata: # Backend and worker logs (backend.YYYY-MM-DD.log, worker…, worker-ai…). logs: caddy-data: caddy-config: + beszel-agent: