containers / Node.js CLI

healthcheck-gen

Generate a Docker health check from the image, command, and exposed port.

healthcheck-gen reads a Dockerfile and proposes a HEALTHCHECK instruction, a Compose block, or JSON output. It understands common application and service images and provides a matching endpoint snippet when it can infer a framework.

verified public Dockerfile

A Node slim image gets a probe its runtime can actually execute.

The tool inspected the release-intel-mcp Dockerfile and detected Node 22 slim, Express, and port 3000 before choosing the built-in fetch API.

observed output
image node:22-slimframework expressport 3000probe node fetch

what it exposes

Capabilities

  • Inspect the final stage of multi-stage Dockerfiles
  • Choose probes for common Node, Python, Go, Postgres, Redis, and nginx images
  • Generate Dockerfile, Compose, or JSON output
  • Replace an existing HEALTHCHECK only when explicitly requested

workflow integration

Keep the evidence in the run

Generate a reviewable probe and apply it only when requested.

- uses: barissozudogru/healthcheck-gen@v0.5.1

good fit

Use it when

  • Adding a first health check to an existing container
  • Reviewing a generated probe before committing it
  • Producing consistent health-check configuration for CI automation

operating limits

Know before using

  • Framework and endpoint detection is heuristic
  • Verify the proposed path and command against the application before using append mode
  • A container health check does not replace end-to-end service monitoring