Skip to content
FrogDB Logo FrogDB

Kubernetes

Overview

Section titled “Overview”

FrogDB provides a Kubernetes operator (frogdb-operator) for managing FrogDB clusters on Kubernetes. The operator handles:

  • Provisioning and lifecycle management of FrogDB instances
  • Cluster topology and slot management
  • Rolling upgrades
  • Automated failover

The operator source code lives in the frogdb-operator/ directory of the repository.

StatefulSet (Manual)

Section titled “StatefulSet (Manual)”

For environments without the operator, you can deploy FrogDB using a StatefulSet directly. See the Deployment guide for a complete StatefulSet example with persistent volumes and health checks.

Health Probes

Section titled “Health Probes”

FrogDB exposes HTTP health endpoints suitable for Kubernetes probes:

livenessProbe:
  httpGet:
    path: /health/live
    port: 9090
  initialDelaySeconds: 5
readinessProbe:
  httpGet:
    path: /health/ready
    port: 9090
  initialDelaySeconds: 5

Planned Features

Section titled “Planned Features”

The following sections will be documented as the operator stabilizes:

  • Helm Chart — installation and configuration values
  • Custom Resources — CRD reference for FrogDB and FrogDBCluster resources
  • Rolling Upgrades — zero-downtime upgrade workflow
  • Monitoring Integration — ServiceMonitor and PodMonitor for Prometheus Operator
  • Backup Integration — scheduled snapshots with S3/GCS storage

See Also

Section titled “See Also”
Deployment Production deployment guide
Clustering Cluster architecture and configuration
Debug UI & HTTP API Health endpoints for probes