Skip to content

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

  • Overview

    Big-picture topology, dev vs prod, provider split, architectural decisions.

  • Infrastructure

    The OVH bare-metal k3s server, the Cloudflare stack (DNS, Workers, Tunnel, R2), GCP (secrets and identity) and the GitHub org.

  • Kubernetes

    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).

  • Operations

    Deploy, rollback, scale, debug, disaster recovery, Postgres operations, Photon indexing, Terraform CI/CD, observability, access control.

  • Security

    Secrets management, IAM, network policies, TLS, vulnerability scanning, threat model.

  • Reference

    Glossary, scripts, task catalog, dev-vs-prod environments matrix, third-party accounts.

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.