Skip to content

[documentation] Add Render production deployment runbook #39

Description

@yinkscss

Context

render.yaml defines gateway, API, and Postgres but README only covers local docker-compose and cargo run.

Problem

Maintainers lack step-by-step production deploy instructions including secrets, webhook URL, and contract id setup.

Proposed scope

  • Add docs/deployment/render.md runbook
  • Cover Blueprint deploy, env vars, GitHub webhook URL, and health verification
  • Include rollback and pause program operator steps

Acceptance criteria

  • Runbook covers full Render deploy from empty project
  • Lists all required secrets with rotation notes
  • Verifies health, metrics, and sample admin API call
  • Linked from README documentation section

References

  • render.yaml
  • .env.example
  • docs/security-checklist.md
  • Dockerfile.gateway, Dockerfile.api

Activity

  1. added
    documentationImprovements or additions to documentation
    help wantedExtra attention is needed
    phase-3Phase 3: Production Hardening
    infraCI, Docker, deployment
    on Jun 18, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    complexity:mediumStandard feature or involved fixdocumentationImprovements or additions to documentationhelp wantedExtra attention is neededinfraCI, Docker, deploymentphase-3Phase 3: Production Hardening

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions