Skip to main content
Version: 3.2.0

Kubernetes install path

Version: 3.2.0 Date: 2026-11-17

Goal: Operators who run IP Tower on Kubernetes / GKE need manifests and a documented one-replica install, not only docker run.

Solution: Raw manifests in deploy/k8s/ (copied into the image) plus operator pages (EN / FR) for kubectl / Kustomize, seed config from a Secret, and a GKE how-to (Artifact Registry, Workload Identity, bucket).

Features:

  • Deployment + Service + PVC + ServiceAccount (replicas: 1, Recreate, probe on /api/v1/ping)
  • Init-container example to render config.yaml from a ConfigMap template and a Secret (envsubst)
  • Operator docs: single replica (SQLite), Ingress, GKE Autopilot, Secret rotation (pod restart / Reloader)

Implementation Details:

  • Templates in the image (/templates/k8s). Operators extract with docker run --rm -v "$PWD/iptower:/out" <image> get-templates (optional set: k8s, kube)
  • Two apply paths: kubectl apply -f, optional Kustomize (kubectl apply -k). No Helm. Placeholders only — no client names, no secrets in git
  • SPA ServeStatic exclude for Nest 11 / path-to-regexp v8 is a separate fragment (fix-spa-static-exclude.md)

Files Modified:

  • deploy/k8s/ - Namespace, ServiceAccount, Deployment, Service, PVC, Kustomize, config-from-template example
  • entrypoint.sh / docker/Dockerfile - get-templates extract
  • docs/user/install/kubernetes.md - install how-to (EN / FR)
  • docs/user/install/gke.md - GKE setup how-to (EN / FR)

Release fragment: feat-k8s-deploy-docs