Skip to content

Replace /health with /livez and /readyz probes (v3) - #19

Merged
joseluisq merged 4 commits into
masterfrom
docs/health-livez-readyz
Oct 31, 2026
Merged

joseluisq merged 4 commits into
masterfrom
docs/health-livez-readyz

Conversation

@joseluisq

@joseluisq joseluisq commented Oct 31, 2026 •

Copy link
Copy Markdown
Contributor

Description

v3 docs for the health endpoints change from static-web-server/static-web-server#751. With --health, SWS now serves the Kubernetes-style /livez (liveness) and /readyz (readiness) probes, and no longer serves /health.

  • features/health-endpoint.md: rewritten. Covers both paths, CLI/env/TOML forms, GET/HEAD behavior (text/plain OK body), query string handling, exact path matching, other methods, debug-level logging, a curl -i example, interactions with CORS, Basic auth, maintenance mode, redirects, rewrites and custom headers scope = "all", and a Kubernetes example with both probes. A warning box links to the migration guide.
  • features/health-endpoint.md, features/graceful-shutdown.md: /readyz returns 503 during the grace period; a "With TLS" section (probe the TLS port with scheme: HTTPS, not the --https-redirect port).
  • migration-guide.md: new breaking change "10. Health endpoint replaced by /livez and /readyz" and a checklist item.
  • features/docker.md: Kubernetes example uses /livez and /readyz (and names the http port the probes reference).
  • configuration/cli.md, configuration/env.md, configuration/file.md, defaults.md, index.md, features/logging.md, features/custom-http-headers.md: /health replaced with the new paths; --health help text matches the binary.

Merge only together with (or after) static-web-server/static-web-server#751.

yarn format:check (markdownlint-cli2 and prettier --check) passes locally.

🤖 Generated with Claude Code

Document the Kubernetes-style `/livez` (liveness) and `/readyz` (readiness)
health endpoints that replace `/health` in v3, and add the change to the v2 to
v3 migration guide.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Oct 31, 2026 •

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
static-web-server-docs 66bf88b Commit Preview URL

Branch Preview URL
Oct 31 2026, 12:58 PM

joseluisq and others added 3 commits October 31, 2026 12:41
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@joseluisq joseluisq self-assigned this Oct 31, 2026
@joseluisq joseluisq added v3 enhancement New feature or request labels Oct 31, 2026
@joseluisq joseluisq changed the title docs: replace /health with /livez and /readyz probes (v3) Replace /health with /livez and /readyz probes (v3) Oct 31, 2026
@joseluisq
joseluisq merged commit 7b898ab into master Oct 31, 2026
2 checks passed
@joseluisq
joseluisq deleted the docs/health-livez-readyz branch October 31, 2026 15:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request v3

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant