Skip to content

Operations Runbook — superloom.dev Website

This directory contains the complete infrastructure setup documentation for hosting the Superloom website. Follow the numbered directories in order when setting up or handing over the environment.

Structure

#DirectoryPurpose
0000-domain/Domain registration and Route 53 hosted zone
0101-dns/DNS configuration and nameserver delegation
0202-ssl-certificates/TLS certificate provisioning via ACM
0303-object-storage/S3 bucket for website assets
0404-cdn/CloudFront distribution
0505-identity-access/IAM policy for CI/CD deployment
0606-deployment/CI/CD pipeline (GitHub Actions)

Conventions

  • Directory names are vendor-agnostic (object-storage/, not s3/)
  • File names are vendor-prefixed (aws-s3-setup.md, not setup.md)
  • Secret values are never stored here — reference __dev__/secrets/ instead
  • Secret format: [SECRET → __dev__/secrets/production.md]

Reference

For generic how-to guides, see docs/ops/. For the full documentation standard, see docs/architecture/operations-documentation.md.

Released under the MIT License.