Tomoda DevOps¶
Production infrastructure and operations for the tomoda platform.
This site describes how tomoda runs in production: the Terraform-managed cloud resources, the Kubernetes manifests Argo CD reconciles, and the operational runbooks.
How to read these docs¶
-
Big-picture topology, dev vs prod, provider split, architectural decisions.
-
The OVH bare-metal k3s server, the Cloudflare stack (DNS, Workers, Tunnel, R2), GCP (secrets and identity) and the GitHub org.
-
Argo CD GitOps. Apps (
tomoda, Xavia OTA), tenant data (Postgres, Redis, pgAdmin, Redis Insight), platform services (Traefik, cert-manager, External-DNS, External Secrets, oauth2-proxy, monitoring, Loki, NATS, Photon). -
Deploy, rollback, scale, debug, disaster recovery, Postgres operations, Photon indexing, Terraform CI/CD, observability, access control.
-
Secrets management, IAM, network policies, TLS, vulnerability scanning, threat model.
-
Glossary, scripts, task catalog, dev-vs-prod environments matrix, third-party accounts.
Quick links¶
- New to the stack: Architecture
- Deploying a fix: Deploy
- Production is down: Debugging, Alert response, Disaster recovery
- Adding a secret: Secrets management
- App-side docs live in the tomoda repo's
docs/.
Editing these docs¶
The docs source lives in this repo's docs/ directory. Serve locally with hot reload:
task docs:install # one-time
task docs # http://localhost:8000
Strict-build check before committing:
task docs:build # mkdocs build --strict
The tomoda repo's combined docs site also includes these pages (mkdocs-monorepo-plugin).
Which changes need a doc update: .claude/rules/docs-sync.md.