Skip to main content

okustera_database_valkey (Resource)

The okustera_database_valkey resource provisions an in-memory caching and key-value cluster powered by Valkey 7.2 (valkey/valkey:7.2.7) and managed by the Spotahome Operator. Valkey provides community-driven, truly open-source in-memory storage with complete RESP wire-protocol compatibility. It supports automated 3-node Sentinel quorum election, sub-10-second master failover, dynamic Ceph RBD persistence, and OpenStack Barbican credential vaulting.

Example Usage​

Production Valkey Cluster with Sentinel Quorum​

resource "okustera_database_valkey" "cache" {
  name              = "session-cache"
  namespace         = "default"
  replicas          = 3
  sentinel_replicas = 3
  memory_limit      = "4Gi"
  storage_size      = "10Gi"
  storage_class     = "ceph-rbd"
}

Schema​

Required​

  • name (String) Name of the Valkey cluster.

Optional​

  • namespace (String) Kubernetes namespace for the Valkey pods. Defaults to default.
  • replicas (Number) Number of Valkey server replicas. Defaults to 3.
  • sentinel_replicas (Number) Number of Sentinel monitor replicas for quorum election. Defaults to 3.
  • memory_limit (String) Maximum RAM allocated per Valkey pod (e.g. "2Gi", "8Gi"). Defaults to "1Gi".
  • storage_size (String) Persistent volume size (e.g. "10Gi", "50Gi"). Defaults to "5Gi".
  • storage_class (String) Kubernetes StorageClass for volume claims (defaults to ceph-rbd).

Read-Only Attributes​

  • id (String) Unique identifier for the Valkey cluster.
  • master_endpoint (String) Direct endpoint to the active Valkey master (valkey-endpoint:6379).
  • sentinel_endpoint (String) Host and port for Sentinel clients (host:26379).
  • connection_uri (String, Sensitive) Connection URI formatted for Valkey clients (valkey://...).
  • status (String) Current cluster operational status.