1 v0.2.8 Docker Healthcheck
david edited this page 2026-06-19 09:07:30 -07:00

Pagemaster v0.2.8 Docker Healthcheck

v0.2.8 hardens the packaged Docker path with a built-in app healthcheck and a documented image tag policy.

What Changed

  • Added pagemaster healthcheck [url].
  • Added Docker HEALTHCHECK using /usr/local/bin/pagemaster healthcheck.
  • Kept the healthcheck dependency-free inside the runtime image.
  • Added healthcheck tests with a fake HTTP transport.
  • Documented the Docker image tag policy:
    • version tags are immutable release artifacts;
    • lab can become the moving verified lab channel;
    • latest is reserved for a later stable/public release policy.
  • Bumped app/package/image metadata to 0.2.8.

Operator Notes

The default healthcheck calls http://127.0.0.1:${PORT}/api/health inside the container and requires ok: true.

Manual checks:

docker exec pagemaster /usr/local/bin/pagemaster healthcheck
docker exec pagemaster /usr/local/bin/pagemaster healthcheck http://127.0.0.1:8090/api/health

Set PAGEMASTER_HEALTHCHECK_URL only when the default loopback URL cannot represent the container's actual health endpoint.

Verification

  • make frontend-check.
  • make test.
  • make build.
  • make docker-build.
  • Docker image label inspection for pagemaster:0.2.8.
  • Container smoke for /api/health, /api/setup/status, and Docker health status.
  • git diff --check.