36 lines
2.5 KiB
Markdown
36 lines
2.5 KiB
Markdown
# REPORT — healthcheck fixes (komga + gitea) — 2026-06-22, unattended test campaign
|
||
|
||
Two healthcheck fixes of the same class, found + verified live on guest 9201 during the unattended
|
||
test campaign (full evidence in `felhom-controller/TEST-REPORT.md`):
|
||
|
||
- **gitea** (`17e00b7`): docker HC + `.felhom.yml` probe `/api/v1/version` (404 until install-lock) →
|
||
`/api/healthz` (200 while serving); start_period 30s→90s. Surfaced during the Phase-2 deploy sweep;
|
||
validated: re-sync → redeploy → `docker inspect: healthy`.
|
||
- **komga** (`3faa5ae`, `9b066de`): detailed below.
|
||
|
||
## What changed
|
||
Repointed komga's health probe from the auth-gated `/api/v1/actuator/health` (HTTP 401) to the
|
||
unauthenticated `/actuator/health` (HTTP 200), in **both** places that probe komga:
|
||
- `templates/komga/docker-compose.yml` — the Docker `healthcheck` (`curl -f`).
|
||
- `templates/komga/.felhom.yml` — the controller-side `healthcheck.checks[].path` (this is what drives
|
||
the dashboard "Nem egészséges" badge and route publishing).
|
||
|
||
## Why (diagnosed live on guest 9201)
|
||
- The running container's docker HC `curl -f http://localhost:25600/api/v1/actuator/health` exited 22
|
||
(HTTP 401) → container reported `unhealthy` for 18h despite serving normally on :25600.
|
||
- The controller probe logged `Health probe komga: API GET :25600/api/v1/actuator/health → expected 200, got 401`.
|
||
- Endpoint probe matrix (wget inside the image): `/`, `/actuator/health`, `/api/v1/oauth2/providers`,
|
||
`/login` all → 200; only `/api/v1/actuator/health` → 401. Komga's Spring actuator is served
|
||
unauthenticated **off** the `/api/v1` prefix.
|
||
- The `gotson/komga:1.20.0` image ships `curl` (verified `/usr/bin/curl`), so the probe tool is unchanged.
|
||
|
||
## Validation (end-to-end through the real UI + server pipeline)
|
||
1. Committed + pushed to `app-catalog` `main` (`3faa5ae` docker HC, `9b066de` controller probe).
|
||
2. GUI "Sablonok frissítése" → controller git-sync: logs `Updated komga/docker-compose.yml` +
|
||
`Updated komga/.felhom.yml`; catalog-cache + live stack `/opt/docker/stacks/komga/docker-compose.yml`
|
||
both updated to `/actuator/health`.
|
||
3. GUI "Frissítés" → `POST /api/stacks/komga/update` 200 → `docker compose up -d --remove-orphans` →
|
||
container recreated (StartedAt 2026-06-22T13:09:50Z), "Stack komga updated successfully (4.2s)".
|
||
4. Result: `docker ps` → `komga Up (healthy)`, HC now `/actuator/health`; controller "Health probes: ok";
|
||
dashboard card flipped to **Fut** and the "URL nem elérhető – útvonal nincs publikálva" warning cleared.
|