Documentation

Kubernetes Operator

Deploy and manage Antfly database clusters on Kubernetes — high availability, autoscaling, scheduled backups, and native cloud-platform support. Ships as ghcr.io/antflydb/antfly-operator.

Installation

Install the Antfly Operator in your Kubernetes cluster

Quickstart

Deploy your first Antfly cluster on Kubernetes

Concepts

Understand the Antfly Operator architecture and key concepts

Cloud Platforms#

AWS EKS

Deploy Antfly on Amazon EKS with Spot Instances and IRSA

GCP GKE

Deploy Antfly on GKE Autopilot with Spot Pods

Generic Kubernetes

Deploy Antfly on any Kubernetes distribution

Operations#

Autoscaling

Configure automatic scaling of Antfly data nodes

Backup & Restore

Schedule backups and restore Antfly data

Monitoring

Health checks, metrics, and observability for Antfly clusters

Hot-Standby HA

Operate a highly available hot standby in standalone mode

Pod Scheduling

Configure pod placement with node selectors, affinities, tolerations, and topology spread constraints

Storage

Configure PVC retention, volume expansion, and storage lifecycle

Troubleshooting

Common issues and solutions for the Antfly Operator

Security#

RBAC

Role-based access control for the Antfly Operator

Secrets Management

Manage credentials and secrets for Antfly clusters

Service Mesh

Istio, Linkerd, and Consul Connect integration

Reference#

AntflyCluster API

Complete CRD reference for the AntflyCluster resource

AntflyBackup API

Complete CRD reference for the AntflyBackup resource

AntflyRestore API

Complete CRD reference for the AntflyRestore resource

Example Configurations

Ready-to-use example YAML configurations for the Antfly Operator