Valkey Component

High-performance key-value cache store, Redis-compatible with optional clustering and replication.

Architecture

Valkey Server - Redis-compatible cache
Replication - Master-replica (if replicas > 1)
Persistence - Optional RDB/AOF via PVC

Quick Reference

REQUIRED = Must be defined by user
Attribute Example Default Effect
namespace REQ valkey - K8s namespace
version REQ 7.2.5 - Valkey version
password REQ secret123 - Auth password
image_repository valkey/valkey valkey/valkey Container image
enable_auth true true Enable authentication
replicas 1 1 Number of replicas
pvc_enabled true false Persistent storage
pvc_size 10Gi 10Gi Storage size
cpu_request / cpu_limit 250m / 1000m - CPU resources
mem_request / mem_limit 512Mi / 2Gi - Memory resources

Link Variables

Variable Link Type Purpose
__prometheus prometheus-valkey Metrics collection, ServiceMonitor

Link Automations (Inbound)

image_base-valkey - Injects REDIS_* ENVs into app
external_source_code-valkey - Injects REDIS_* ENVs
langflow-valkey - LANGFLOW_REDIS_HOST/PORT/PASSWORD
open-webui-valkey - WEBSOCKET_MANAGER=redis, REDIS_URL
airflow-valkey - Celery broker configuration

Generated ENV Variables (by framework_type)

spring: SPRING_DATA_REDIS_HOST, SPRING_DATA_REDIS_PORT, SPRING_DATA_REDIS_PASSWORD
python/nodejs/rails: REDIS_URL (connection string)
laravel: REDIS_HOST, REDIS_PORT, REDIS_PASSWORD
generic: REDIS_HOST, REDIS_PORT, REDIS_PASSWORD

Generated Files

File Condition Contains
helm/helm-values.yaml Always Helm chart config
service-monitor.yaml __prometheus Prometheus ServiceMonitor

Ports

Port Purpose Protocol
6379 Redis protocol TCP
9121 Metrics exporter HTTP (if prometheus)