dragonfly

Configure and troubleshoot DragonflyDB operator resources on Kubernetes clusters.

4|2|Updated Jun 1, 2026
One-click install
npx skills add https://github.com/Aidas-dev/k8s-agent-skills --skill dragonfly-aidas-dev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dragonfly
Source: https://github.com/Aidas-dev/k8s-agent-skills/tree/main/skills/dragonfly
Command: npx skills add https://github.com/Aidas-dev/k8s-agent-skills --skill dragonfly-aidas-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Operating DragonflyDB on Kubernetes requires knowing the Dragonfly operator's CRD schema, replication model, and configuration pitfalls, and mistakes like misconfigured replicas or missing snapshots cause data loss. ## Core Features & Use Cases - Dragonfly CRD Configuration: Create Dragonfly resources with replicas, args, resources, affinity, and scheduling constraints using the dragonflydb.io/v1alpha1 API. - Replication, TLS, and Auth Setup: Configure primary-replica topologies, password or ACL authentication, TLS secrets, and mutual TLS client verification. - Snapshots and Monitoring: Set up cron-based snapshots to PVCs for persistence and PodMonitor scraping of the admin metrics port. - Use Case: Deploy a Redis-compatible cache for an application by creating a Dragonfly resource with password authentication, snapshot persistence to a ceph-block PVC, and a ClusterIP service, then point the app's REDIS_URL at the generated service. ## Quick Start Create a Dragonfly resource named my-cache with one replica, password authentication from a secret, and snapshots every five minutes to a 2Gi PVC.

Frequently Asked Questions about dragonfly

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy DragonflyDB on Kubernetes with the operator?▼

Install the operator via the Helm chart at oci://ghcr.io/dragonflydb/dragonfly-operator/helm/dragonfly-operator, then create a Dragonfly resource in the dragonflydb.io/v1alpha1 API. Set replicas, args, resources, and optionally authentication and snapshot fields.

How does Dragonfly operator replication work?▼

The replicas field sets total instances: replicas=1 is a standalone primary, replicas=2 is one primary plus one replica. There is always exactly one primary, the operator handles automatic failover, and the service always points to the current primary.

How do I enable persistence for Dragonfly on Kubernetes?▼

Configure the snapshot field with a cron schedule and a persistentVolumeClaimSpec specifying storageClassName and size. Without a snapshot cron and PVC, pod restarts lose all data, and snapshots are not auto-pruned.

Does Dragonfly support TLS and password authentication?▼

Yes. Set tlsSecretRef to a Secret containing tls.crt and tls.key for server TLS, and use authentication.passwordFromSecret for password auth or aclFromSecret for ACL rules. Avoid setting the password via both the CRD field and the --requirepass arg.

Why is my Dragonfly cluster mode not working with multi-key operations?▼

When using --cluster_mode=emulated, you must also set --lock_on_hashtags for hashtag-based locking, otherwise multi-key operations fail. Emulated mode lets Redis cluster clients connect while only one Dragonfly instance runs behind the service.