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.
103 lines
4.0 KiB
YAML
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"
|