Cache (Valkey)
1. Visión General
El add-on Cache (Valkey) implementa una instancia de Valkey — fork open-source de Redis — dentro de un entorno, para usar como caché, gestión de sesión, pub/sub y estructuras de datos en tiempo real.
Úsalo cuando el flujo, app u otro add-on necesita un almacenamiento clave/valor rápido en memoria, con o sin persistencia en disco.
Tags del catálogo: Cache, In-Memory, Key-Value.
2. Prerrequisitos
- Un squad y un entorno ya seleccionados en la pantalla de Add-ons.
3. Paso a paso del Deploy
El asistente de deploy de Cache (Valkey) tiene 4 pasos:
Paso 1 — General
| Campo | Obligatorio | Descripción |
|---|---|---|
| Add-on Name | Sí | Nombre del add-on dentro del entorno. Solo letras minúsculas, números y guiones (3 a 63 caracteres). Ejemplo: my-cache. |
Paso 2 — Admin User
El usuario por defecto de Valkey usa autenticación por contraseña vía REQUIREPASS. El nombre de usuario es fijo (default) y no puede cambiarse en el deploy; usuarios ACL adicionales pueden crearse después, en la propia instancia.
| Campo | Obligatorio | Descripción |
|---|---|---|
| Admin Username | — | Fijo en default, no editable. |
| Password | Sí | Contraseña de autenticación del usuario default. |
| Eviction Policy | No | Define cómo se eliminan las claves cuando se alcanza el límite de memoria. Por defecto: allkeys-lru (política recomendada para uso como caché). |
Paso 3 — Persistence
Define cómo sobreviven los datos a los reinicios, y configura los backups automáticos (mismo patrón del add-on PostgreSQL).
| Campo | Obligatorio | Descripción |
|---|---|---|
| Persistence Mode | No | Modo de persistencia de los datos. Opciones: NONE (caché puro en memoria, sin persistencia), RDB — snapshots periódicos (por defecto), AOF — log append-only (más durable, pero más lento), RDB+AOF — ambos combinados. |
| RDB Save Schedule | Si modo RDB o RDB+AOF | Pares segundos cambios que definen cuándo se dispara un snapshot. Por defecto: 3600 1 300 100 60 10000 — dispara un snapshot cada hora con al menos 1 cambio, cada 5 min con 100, o cada 1 min con 10000. |
| Enable automatic backups | No | Activa/desactiva los backups automáticos. Activado por defecto. |
| Keep last N backups | Si backups activados | Cantidad de backups más recientes que se mantienen antes de purgar los más antiguos. Por defecto: 10. |
| Cron schedule (UTC) | Si backups activados | Expresión cron (en UTC) que define la frecuencia de los backups. Por defecto: 0 2 * * * (todos los días a las 02:00 UTC). |
Paso 4 — Resources
Define los recursos asignados a la instancia.
| Campo | Por defecto | Máximo |
|---|---|---|
| Memory | 256Mi | 2Gi |
| CPU | 500m | 2000m |
| Disk Size | 1Gi | 20Gi |
Al hacer clic en Deploy Add-on, se inicia la implementación. El add-on pasa a aparecer en la pestaña My Add-ons del entorno.
4. Preguntas frecuentes
¿Cuál es la diferencia entre los modos de persistencia (NONE, RDB, AOF, RDB+AOF)?
NONE no graba nada en disco — si la instancia se reinicia, los datos se pierden (uso como caché puro). RDB toma fotos periódicas del estado (puede perder los últimos cambios entre snapshots). AOF graba un log de cada cambio (más durable, pero con más overhead). RDB+AOF combina ambos.