Files
accounted/docker-compose.yml
T
Claude Code c3a2ace846
masterplan-lock / check (pull_request) Successful in 8s
security / scan (pull_request) Failing after 2m43s
feat(cron): missad-tick-detektion — heartbeat per schema, 503 när ett jobb slutar komma
Den 2026-11-15 tappade accounted-cron 1 497 av 10 455 körningar på ett dygn
(14,3 %) när pids_limit 30 fick fork/exec /bin/sh att misslyckas. supercronic
hoppade tyst över tickarna. Containern var Up hela tiden, appen svarade 200 på
allt, och enda spåret var cron-containerns egen logg. Orsaken är fixad i #43;
det här gör att ett tappat jobb SYNS nästa gång.

Tre luckor stängs:
1. Ingen körningshistorik — with-cron-context loggade men skrev inget
   beständigt, så en körning som aldrig startade lämnade inget spår.
2. Cron-tjänstens healthcheck var `ps ax | grep supercronic`, som bara blir röd
   när processen dör, inte när scheman slutar köra.
3. Ingen hade kodifierat vad "för sen" betyder per schema.

Implementering:
- lib/cron/cron-interval.ts: tolkare för 5-fälters cron (det enda vercel.json
  använder) som räknar ut VÄRSTA gapet i sekunder över ett 12-årsfönster
  (behövs för 29 februari), inte medelgapet. Okänd syntax kastar hellre än
  gissar.
- scripts/generate-crontabs.ts skriver nu även lib/cron/schedules.generated.ts
  (path + schedule + maxIntervalSeconds) från samma vercel.json-array som
  crontaben, så en schemalagd path som kontrollen inte känner till inte kan
  uppstå. Drift-testet jämför filen byte för byte.
- supabase/migrations/20261115190000_cron_heartbeats.sql: en rad per path
  (declared_at, last_started_at, last_completed_at, last_status,
  last_http_status, last_duration_ms). RLS på, noll policies: instansglobal
  schemaläggning är inte tenantdata.
- lib/cron/heartbeat-evaluation.ts: ren utvärdering — ok / pending (aldrig körd
  men deklarerad inom sin egen kadens) / stale. Tröskel 2 x kadens + 120 s.
  Mätt från last_started_at, inte completion: en hängd körning avslutas aldrig
  och supercronic skjuter då upp varje senare tick, så ett completion-baserat
  mått hade sett levande ut.
- lib/cron/heartbeat-store.ts: Supabase-IO. Skrivningar är best effort (kastar
  aldrig — en mätningsskrivning får inte fälla jobbet den mäter); läsningar
  kastar så endpointen kan säga "kan inte verifiera" istället för att ljuga
  grönt. No-op utan Supabase-env.
- app/api/cron/health/route.ts: 200 när alla scheman ligger inom sina fönster,
  503 vid stale eller oläsbart lager. Deklarerar okända paths först (nytt jobb
  får respit istället för omedelbart rött). Autentiseras med befintlig
  cron-hemlighet, report:false så en felkopplad probe inte spammar auth-larm.
- lib/api/with-cron-context.ts: skriver heartbeat per körning (path ur
  request-URL:en) med status och duration. 401 räknas inte som körning.
- docker-compose.yml: cron-healthcheck byter från supercronic-grep till att
  anropa /api/cron/health med `$${CRON_SECRET}`/`$${APP_URL}` (dubbelt $ krävs,
  annars interpolerar compose på värden), start_period 120 s.

Migrationen är redan applicerad på accounted-sb-db (additiv, 0 rader) så
endpointen fungerar direkt vid deploy. Ordning vid utrullning: deploya appen
först, recreata cron-containern sedan — den gamla imagen saknar routen, och
healthchecken failar då korrekt stängt (verifierat i containern: curl -f ger
404/rc=22 mot icke-deployad route).

Verifiering: 99 nya tester (kadens 60/120/300/3600/7200/86400/604800 s,
29 februari, cron-regeln OR; utvärdering ok/pending/stale/hängd körning;
endpoint 200/503/401/unverifiable; wiring inklusive 401 utan heartbeat och
kastat heartbeat-fel som inte fäller körningen; drift av genererad fil).
Hela sviten 1687 filer / 22 400 tester grön; check:types 533/533; check:lint
0 fel; check:guards passed.

Revert: git revert <sha> (kod + migration + compose i en commit). Migrationen
kan lämnas kvar om bara koden rullas tillbaka.
2026-11-15 19:56:45 +01:00

103 lines
4.0 KiB
YAML

services:
app:
image: ghcr.io/erp-mafia/gnubok:${IMAGE_TAG:-latest}
env_file: .env
# Bound to loopback by default: put a TLS-terminating reverse proxy in
# front (see docker-compose.caddy.yml). Override PORT in .env to change
# the host port, or use the caddy overlay to remove the host binding.
ports:
- "127.0.0.1:${PORT:-3000}:3000"
security_opt:
- no-new-privileges:true
cap_drop:
- ALL
read_only: true
init: true
# tmpfs ordering matters: the parent /app/.next must be mounted before
# any sub-mounts. The entrypoint cp's image-baked templates into these
# mounts at startup, then sed-substitutes the NEXT_PUBLIC_* placeholders,
# then drops the write bits.
#
# uid=1001 (nextjs), mode=750: the entrypoint runs UNPRIVILEGED as nextjs
# and owns these mounts, so it can populate them with no CAP_CHOWN/CAP_SETUID,
# which is what lets the container run under `cap_drop: ALL`. nodejs-group
# members can read the served bundle; nothing else on the host can.
tmpfs:
- /tmp
- /app/.next:uid=1001,gid=1001,mode=750,size=400m
- /app/public:uid=1001,gid=1001,mode=750,size=200m
# CPU limits are intentionally left to host tooling or a local override.
# Some Compose builds bundled with NAS platforms reject the `cpus` key.
mem_limit: 1g
pids_limit: 200
restart: unless-stopped
healthcheck:
# 127.0.0.1, not localhost: the app binds 0.0.0.0 (IPv4) but localhost can
# resolve to ::1 (IPv6), where nothing listens → false-unhealthy → the
# cron service (depends_on healthy) never starts.
test: ["CMD", "wget", "-q", "--spider", "http://127.0.0.1:3000/api/health"]
interval: 30s
timeout: 5s
start_period: 30s
# `start_interval` requires Docker Compose 2.20.2+ and Docker Engine 25.0+.
# Omitting it keeps the base file usable with older NAS container stacks.
retries: 3
logging:
driver: json-file
options:
max-size: "10m"
max-file: "5"
cron:
build:
context: docker
dockerfile: cron.Dockerfile
depends_on:
app:
condition: service_healthy
environment:
- CRON_SECRET=${CRON_SECRET}
- APP_URL=http://app:3000
volumes:
- ./docker/crontab.self-hosted:/etc/supercronic/crontab:ro
init: true
security_opt:
- no-new-privileges:true
cap_drop:
- ALL
read_only: true
tmpfs:
- /tmp
# 2026-11-15: pids_limit 30 gav "fork/exec /bin/sh: resource temporarily
# unavailable" i 14,3 % av cron-körningarna (1 497 av 10 455 senaste dygnet)
# när flera scheman (var 1/2/5/10 min) sammanföll — jobben hoppades över
# utan larm. 200 pids och 256 MiB ger marginal; uppmätt behov är ~17 pids
# och ~12 MiB i drift.
mem_limit: 256m
pids_limit: 200
healthcheck:
# 2026-11-15: this used to be `ps ax | grep supercronic`, which stays green
# while the scheduler process is up but ticks are being dropped — exactly
# what happened when pids_limit 30 made 14,3 % of runs fail to fork (see
# docker-compose.accounted.yml and the cron_heartbeats migration). Ask the
# app instead: /api/cron/health answers 503 when any schedule has not run
# within its own worst-case window, so a silent stop makes this container
# unhealthy and reaches alerting. `$$` is required — a single `$` would be
# interpolated by compose on the host instead of by the shell in here.
test:
- CMD-SHELL
- 'curl -fsS -m 10 -o /dev/null -H "Authorization: Bearer $${CRON_SECRET}" "$${APP_URL}/api/cron/health"'
interval: 60s
timeout: 15s
retries: 3
# The probe calls the app over HTTP, so it can only pass once the app
# answers. 30 s was too tight for a cold `docker compose up` and produced
# a false unhealthy.
start_period: 120s
restart: unless-stopped
logging:
driver: json-file
options:
max-size: "10m"
max-file: "5"