Redis — un Aggregate, dos destinos, autenticación opcional
Este ejemplo mínimo compila una única caché en memoria Redis (protocolo de red de Redis) a partir de un único Aggregate escrito por el desarrollador a dos realizaciones:
- Docker Compose para el desarrollo local, y
- la Recipe helm sintetizada que ejecuta la imagen upstream oficial
redisdirectamente en Kubernetes (sin chart externo).
La Recipe helm sintetizada es la ruta de Kubernetes: depende solo de un tag de imagen oficial en lugar de un chart de terceros, y su conjunto de recursos renderizado es exactamente lo que declara la carga de trabajo.
El mismo aggregate.yaml impulsa ambas. Solo cambia por realización la capa de Recipe que selecciona el Manifest. Un segundo Aggregate, aggregate-auth.yaml, muestra la misma caché con una credencial de contraseña opcional vinculada para la ruta de Compose; aggregate-helm-synth-auth.yaml vincula una credencial referenciable para la ruta helm sintetizada.
Las Recipes de Redis del catálogo que asigna este ejemplo, compose/redis y helm/redis, declaran la licencia AGPL-3.0. El ejemplo valkey-cache despliega Valkey, que habla el mismo protocolo de red; su Recipe helm/valkey declara BSD-3-Clause.
Archivos
| Archivo | Rol |
|---|---|
aggregate.yaml | Intención del desarrollador: un componente cache de tipo core/datastore/redis, sin credencial — la caché se ejecuta sin autenticación. |
aggregate-auth.yaml | La misma caché con una credencial de contraseña vinculada a la ranura opcional password del componente (ruta de Compose). |
aggregate-helm-synth-auth.yaml | La misma caché con una credencial referenciable vinculada para la ruta helm sintetizada — el valor se materializa como un Secret de Kubernetes al que hace referencia el Deployment. |
manifest-compose.yaml | Asigna el tipo Redis a la Recipe de Compose (compose/redis) y la credencial a dotenv-secret. |
manifest-helm-synth.yaml | Asigna el tipo Redis a la Recipe helm sintetizada (helm/redis) y la credencial a k8s-secret-from-parameter. |
release-compose.yaml / release-helm-synth.yaml | Documentos del operador para las dos realizaciones, sin autenticación. |
release-compose-auth.yaml / release-helm-synth-auth.yaml | Documentos del operador que habilitan la autenticación. |
Lo que demuestra
- Una única superficie de autoría, muchos destinos. Un único Aggregate es la fuente de verdad sobre qué es el stack. Cada Manifest dice cómo realizarlo.
- Un almacén de datos con función de caché. Aquí Redis se usa como caché en memoria y no almacena nada de forma duradera, así que el componente se tipa como un simple
serveren lugar de unstateful-server. En Kubernetes la Recipe sintetizada renderiza un Deployment, no un StatefulSet, y no solicita ningún volumen persistente; en Compose el servicio no declara ningún volumen de datos. - Síntesis de Workload (Kubernetes). La Recipe helm sintetizada declara un Workload — un Deployment más un Service ClusterIP que ejecuta la imagen oficial
redis— que el proveedor helm traduce a manifiestos de Kubernetes sin ningún chart externo. El conjunto de recursos renderizado es exactamente lo que declara el Workload. Como el nombreredislo llevan tanto una Recipe de Compose como una helm sintetizada, los Manifests las referencian con ámbito de proveedor comocompose/redisyhelm/redis. - Autenticación opcional mediante una ranura de credenciales. El componente declara una ranura opcional
passworden sufeaturesSchema. Cuando no hay ninguna credencial vinculada (el Aggregate base), la Recipe renderiza la caché con la autenticación desactivada — de forma idéntica byte a byte a una Recipe sin ranura. Cuando hay una credencial vinculada, ambos destinos inician Redis con--requirepass, así que el servidor exige la contraseña: en Compose (aggregate-auth.yaml) el valor se pasa al servidor como ese argumento; en la ruta sintetizada de Kubernetes (aggregate-helm-synth-auth.yaml) se materializa como un Secret al que hace referencia el Deployment.
Generar el ejemplo
Puedes compilar este ejemplo con los comandos de abajo, o hacer que tu asistente de IA lo compile por ti.
Escribe el ejemplo en una carpeta nueva con su nombre:
aggrega scaffold --example redis-cacheDespués imprime los comandos que hay que ejecutar a continuación. El primero entra en la carpeta nueva:
cd redis-cacheCompilación
Este workspace no lleva ningún .aggrega-config.yaml, así que las entidades de la biblioteca estándar se resuelven desde el registro del hub, hub.aggrega.ai, y no se necesita ningún flag de catálogo; --auto-pull escribe durante la compilación el lockfile que le falta a un clon recién creado:
# Local development (Docker Compose), no authenticationaggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official image), no authenticationaggrega build --release release-helm-synth.yaml --auto-pull
# The same realizations with authentication enabledaggrega build --release release-compose-auth.yaml --auto-pullaggrega build --release release-helm-synth-auth.yaml --auto-pullLos artefactos renderizados quedan en dist/.
Con un asistente de IA
Un asistente de IA configurado con las herramientas de Aggrega puede hacer lo mismo: pégale este prompt.
Usa solo las herramientas de Aggrega y no crees ninguna carpeta por tu cuenta. Si la carpeta Workspace aún no contiene una carpeta `redis-cache`, llama una vez a la herramienta `scaffold` con `example` establecido en `redis-cache` y sin `dir`: escribe el ejemplo en una nueva carpeta `redis-cache`. Luego llama a la herramienta `build` una vez por cada Release, en este orden — `release-compose.yaml`, `release-helm-synth.yaml`, `release-compose-auth.yaml` y `release-helm-synth-auth.yaml` — cada vez con `workspace_root` establecido en `redis-cache`, `release` establecido en ese archivo, `auto_pull` establecido en true y `write` establecido en true. Dime qué archivos escribió cada compilación; están en `redis-cache/dist/`.Nota sobre la entrega de credenciales
En la ruta de Compose la credencial es un secreto inject-value (aggregate-auth.yaml): su valor se entrega por la tubería de entorno del componente bajo la variable que nombra su values.key, REDIS_PASSWORD, y la Recipe se lo pasa al servidor como --requirepass. La imagen oficial redis no lee ninguna variable de contraseña, así que el valor se pasa como argumento y aparece en el comando del servicio. Una vinculación cuyo valor no llega a la Recipe bajo ninguna variable que esta lea detiene la compilación, nombrando la ranura, en lugar de dejar la caché abierta.
La ruta helm sintetizada usa una credencial referenciable (aggregate-helm-synth-auth.yaml): el valor se materializa como un Secret de Kubernetes, el Deployment hace referencia a él mediante un secretKeyRef de entorno, y Redis se inicia con --requirepass leyendo esa variable de entorno. Por tanto, la contraseña en texto plano nunca aparece en el manifiesto del Deployment — solo en el Secret. Esto es lo que realmente habilita la autenticación en la imagen oficial redis, que por sí sola no lee una contraseña del entorno.
El valor origin de los Aggregates autenticados es un marcador de posición de desarrollo; proporciona un valor real a través de tu fuente de credenciales para cualquier despliegue real.