Glossary¶
Terms and acronyms used throughout the tomoda devops docs.
Argo CD: Declarative GitOps controller for Kubernetes. The single reconciler for everything in k8s/. Installed once by scripts/ovh/bootstrap-argocd.sh, then self-managed by the argocd Application (values in k8s/envs/platform/argocd/values.yaml); UI at argo-app.tomoda.life.
Barman: PostgreSQL backup tool; CloudNativePG runs its barman-cloud tools through the Barman Cloud plugin (CNPG-I), in a sidecar of each instance. Writes WAL segments and base backups to the R2 bucket tomoda-db-backups. Provides point-in-time recovery.
Bitnami: Maintainer of the upstream Helm chart used for the in-cluster Redis (registry-1.docker.io/bitnamicharts/redis). We pin a specific version in k8s/envs/{dev,prod}/redis/application.yaml.
CDN: Content Delivery Network. Media is served by the Cloudflare assets Worker from R2.
CNPG: CloudNativePG. The Postgres operator running both postgres-dev and postgres-prod clusters in the data namespace. Image: the custom ghcr.io/tomoda-labs/tomoda-postgres (PostGIS + PGroonga + pgvector).
Dex: OIDC connector bundled with Argo CD. Configured with the Google connector + hostedDomains: ["tomoda.life"] so only company Google accounts can sign in. See k8s/envs/platform/argocd/values.yaml.
External-DNS: Controller that syncs Kubernetes Ingress and Service objects to DNS records. In our case it writes to the Cloudflare tomoda.life zone. See k8s/envs/platform/external-dns/values.yaml.
External Secrets Operator (ESO): Controller that pulls secrets from GCP Secret Manager and materializes them as native Kubernetes Secret objects via ExternalSecret and ClusterSecretStore resources. Authenticates with a scoped service-account key.
GitOps: The pattern where the cluster's desired state lives in git, and a controller (Argo CD) reconciles the live state to match. Direct kubectl apply is reserved for bootstrap.
k3s: Lightweight, certified Kubernetes distribution. Runs the cluster on the OVH bare-metal server; config in scripts/ovh/.
Kustomize: The templating layer for k8s/apps/. Base manifests live in k8s/apps/<app>/base/; per-env patches live in k8s/apps/<app>/overlays/{dev,prod}/.
Let's Encrypt: TLS certificate authority used by cert-manager via the letsencrypt-prod ClusterIssuer for in-cluster Traefik-served hosts (api.*, the app hosts, argo-app.*, grafana.*, ota.*). The Worker-served assets.* hosts use Cloudflare edge certificates.
oauth2-proxy: Reverse-proxy authenticator deployed in-cluster. Used to gate ancillary admin UIs (pgAdmin, Redis Insight, dashboards) behind Google OAuth. See k8s/envs/platform/oauth2-proxy/.
PDB: PodDisruptionBudget. Prevents voluntary disruptions (node drains, rollouts) from taking all replicas of a Deployment offline. Both envs define tomoda-api-pdb and tomoda-async-pdb: minAvailable: 1 in prod, maxUnavailable: 1 in dev (k8s/apps/tomoda/overlays/{dev,prod}/pdb.yaml).
Photon: Multilingual geocoder backed by an OSM-derived Lucene index. Runs in-cluster from the rtuszik/photon-docker image. The index is built externally and uploaded to the R2 bucket tomoda-photon-index.
PostGIS: PostgreSQL extension for geospatial data. Used by tomoda for location features. Included in the CNPG image; loaded via the postInitSQL hook in k8s/envs/{dev,prod}/postgres/manifests/cluster.yaml.
PVC: PersistentVolumeClaim. CNPG and Redis both use PVCs on the local-path storage class (directories on the server's RAID1 NVMe).
R2: Cloudflare's S3-compatible object storage with no egress fees. Holds media, backups, logs, traces, OTA bundles, the Photon index and seed sets. See Cloudflare.
Traefik: In-cluster ingress controller. Terminates TLS, routes by host header, integrates with cert-manager via Ingress annotations. Exposed on the server's public IP through k3s ServiceLB (externalTrafficPolicy: Local). See k8s/envs/platform/traefik/values.yaml.
Tomoda-specific terms¶
data namespace: the shared namespace holding stateful workloads: postgres-dev, postgres-prod, Redis (dev + prod), pgAdmin, Redis Insight.
platform namespace: shared platform workloads such as NATS, Photon and the Xavia OTA servers.
tomoda-dev namespace: The dev app namespace. Backend, frontend, and dev-specific config live here.
tomoda-prod namespace: The prod app namespace. Same shape as tomoda-dev with the prod overlay applied.
gsm-tomoda: The ClusterSecretStore resource that points External Secrets Operator at GCP Secret Manager for the development-485000 project.
Bootstrap manifest: k8s/envs/bootstrap.yaml. The root Argo Application that, once applied by scripts/ovh/bootstrap-argocd.sh, pulls in every other Application. The only manifest applied by hand.
App-of-apps: The pattern where Argo Applications reference other Argo Applications. See Environments.