Deployments

Deployments#

Recipes for running Webrick in production across popular stacks. Everything here respects Webrick’s own middleware behaviors.

What’s covered#

  • Nginx / Apache — Front‑controller rules, proxy headers, buffering, compression.

  • Containers / K8s — Minimal images, health checks, OPcache/FPM tips.

  • Serverless / Edge — Cache warm‑up, streaming caveats, signed URL pass‑through.

  • Troubleshooting — Real‑world issues and quick fixes.

Golden rules#

  • Choose one source of compression (proxy or app).

  • Preserve query strings for signed/temporary URLs.

  • Disable proxy buffering for streaming endpoints.

  • Pre‑warm route caches in CI before shipping.

Example: Nginx front controller#

location / {
  try_files $uri /index.php?$query_string;
}