Skip to content

Deployment standards

High-level deployment guidance across repos.

Principles

  • Prefer repeatable, automated deploys.
  • Avoid manual changes in production environments.
  • Keep environment-specific settings in env vars or secret stores.
  • Ensure deployments are observable (logs, metrics, error monitoring).

Common targets

  • Docker + container platforms (Cloud Run, ECS, Kubernetes)
  • PaaS platforms for staging/prototypes
  • VMs for bespoke setups

Repo-specific references

  • Trak: trak/docs/trak/devops/deployment.md
  • Watchman (frontend): add a repo page when available.
  • ws-infra (IaC): add a repo page when available.