Playbook

Debugging Deployment Config Bugs

How to debug incidents where the source is deployment wiring rather than application logic.

Pattern

Runtime config, health checks, paths, ports, or artifacts differ between local, CI, and production.

warningSymptoms

  • arrow_rightDeployment restarts healthy services
  • arrow_rightArtifact is empty or stale
  • arrow_rightContainer uses local defaults
  • arrow_rightTraffic routes to the wrong port

searchWhere to look

  • arrow_rightHealth check routes
  • arrow_rightDocker and Kubernetes manifests
  • arrow_rightCI artifact paths
  • arrow_rightRuntime environment injection

buildCommon fixes

  • arrow_rightSeparate liveness and readiness
  • arrow_rightRender manifests in tests
  • arrow_rightValidate required env on boot
  • arrow_rightAssert artifact contents before deploy

Practice challenges

No ready practice incident is mapped yet.