Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Kubernetes health checks: php liveness is now httpGet, and the probe path skips Souin for the kubelet

Closed Beginner friendly
  • Is something wrong?
#120 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
88/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
kubernetes, php
Domain
devops, documentation

Research direction

Open content/6.deployment/2.kubernetes.md and find the Health Checks section. Update the PHP liveness prose and rendered YAML, reword the timeout and PWA paragraphs, then search the documentation for the template's Souin patch list and add the singleflight patch if it is listed. Done means the PHP probe details and all related explanations match the issue without claiming the pod never becomes ready.

Written by the indexing model from the issue text.

Description

Template change: components-web-app 9b7bca6 (issue components-web-app#104).

Affects content/6.deployment/2.kubernetes.md → Health Checks:

  • The php container's livenessProbe is no longer tcpSocket. It is the same httpGet as readiness (/_api/_/site_config_parameters.jsonld, same Accept header) with periodSeconds: 10, failureThreshold: 6, timeoutSeconds: 5, and no initialDelaySeconds (the startup probe holds it off). Update the opening sentence and the rendered YAML. A pod whose php stops answering now restarts after about a minute. A database outage also restarts it.
  • The timeoutSeconds: 5 callout: the singleflight wedge it describes is now fixed in three ways. The template's Souin build carries darkweak/souin#850 (api/frankenphp/souin/v1.7.9-singleflight-fix.patch), so a timed-out call releases its key. The Caddyfile's @use_cache skips requests to that path whose User-Agent starts with kube-probe/. And liveness now catches a stuck php. Keep the 5s timeout (the 1s default can lose a cold worker's first request), but reword the callout so it no longer says the pod "never becomes ready".
  • The pwa paragraph says "the same TCP liveness probe". It's still TCP for pwa, so reword that to stop implying php's probe is TCP.
  • If the docs list the template's Souin patches anywhere, add the singleflight patch next to the purge patch. Remove it once a Souin release includes #850.
Dominant language
Vue
Stars
0
Forks
0
No merged PRs in 30d

Getting set up

This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from components-web-app/docs

All issues in components-web-app/docs

Similar issues

More DevOps issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.