Ir al contenido
AggregaAggrega
Seleccionar idioma: Español
Esta página se tradujo automáticamente. Lee el original en inglés.

Memcached — un Aggregate, dos destinos y una contraseña que se rechaza

Este ejemplo mínimo compila una única caché en memoria Memcached 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 memcached directamente en Kubernetes (sin chart externo).

La Recipe helm sintetizada es la ruta preferida 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. Otros dos Aggregates vinculan una contraseña a la caché, y sus Releases son ejemplos negativos: la compilación se detiene, porque ninguna realización puede hacer cumplir una contraseña de Memcached.

Archivos

ArchivoRol
aggregate.yamlIntención del desarrollador: un componente cache de tipo core/datastore/memcached, sin credencial — la caché funciona sin autenticación.
aggregate-auth.yamlLa misma caché con una credencial de contraseña inject-value vinculada al slot opcional password del componente (ruta de Compose). Su compilación se detiene.
aggregate-helm-synth-auth.yamlLa misma caché con una credencial de contraseña referenciable vinculada para la ruta helm sintetizada. Su compilación se detiene.
manifest-compose.yamlAsigna el tipo Memcached a la Recipe de Compose (compose/memcached) y la credencial a dotenv-secret.
manifest-helm-synth.yamlAsigna el tipo Memcached a la Recipe helm sintetizada (helm/memcached) y la credencial a k8s-secret-from-parameter.
release-compose.yaml / release-helm-synth.yamlDocumentos del operador para las dos realizaciones.
release-negative-compose-auth.yaml / release-negative-helm-synth-auth.yamlDocumentos del operador sobre los dos Aggregates con contraseña. Se espera que cada compilación falle.

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 sin estado. Memcached guarda las entradas en memoria y no almacena nada de forma duradera, así que el componente se tipa como un simple server en lugar de como un stateful-server. En Kubernetes la Recipe 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 memcached — 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 nombre memcached lo llevan tanto una Recipe de Compose como una helm sintetizada, los Manifests las referencian con ámbito de proveedor como compose/memcached y helm/memcached.
  • Una protección que una realización no puede dar se rechaza, no se descarta. El componente declara un slot opcional password. La imagen memcached no hace cumplir ninguna contraseña: sus dos modos de autenticación son SASL, que se habla solo sobre el protocolo binario, y un archivo de autenticación ASCII, y los clientes de Memcached del catálogo no usan ninguno de los dos. Una Recipe que aceptara la vinculación renderizaría una caché que responde a cualquier cliente mientras el Aggregate dice que está protegida, así que cada Recipe detiene en cambio la compilación, nombrando el slot.

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:

Terminal window
aggrega scaffold --example memcached-cache

Después imprime los comandos que hay que ejecutar a continuación. El primero entra en la carpeta nueva:

Terminal window
cd memcached-cache

Compilació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:

Terminal window
# Local development (Docker Compose)
aggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official image)
aggrega build --release release-helm-synth.yaml --auto-pull

Los 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 tú ninguna carpeta. Si la carpeta del espacio de trabajo aún no contiene una carpeta `memcached-cache`, llama una vez a la herramienta `scaffold` con `example` establecido en `memcached-cache` y sin `dir`: escribe el ejemplo en una nueva carpeta `memcached-cache`. Después llama a la herramienta `build` una vez por cada Release, en este orden — `release-compose.yaml` y `release-helm-synth.yaml` —, cada vez con `workspace_root` establecido en `memcached-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 `memcached-cache/dist/`.

El control: una contraseña que la caché no puede hacer cumplir

Las dos Releases negativas compilan los Aggregates con contraseña, y se espera que cada compilación falle:

Terminal window
aggrega build --release release-negative-compose-auth.yaml --auto-pull
aggrega build --release release-negative-helm-synth-auth.yaml --auto-pull

Cada una se detiene en la Recipe de Memcached, antes de que se escriba nada, y la detención termina con el mensaje propio de la Recipe:

a password is attached to the password slot of "cache", but the memcached
image this Recipe runs cannot enforce a password: it authenticates only through
SASL over the binary protocol or an ASCII authentication file, which the
catalog's Memcached clients do not use, so the cache would accept every client
anyway; remove the attachment, and restrict who can reach the cache through its
network

El rechazo depende de la vinculación misma, no de cómo se entrega la credencial, así que toda Feature que pueda rellenar el slot se detiene de la misma manera. Las realizaciones gestionadas se comportan igual: Amazon ElastiCache no ofrece ninguna autenticación de Memcached, y sus Recipes también se detienen ante la vinculación. Una caché Memcached está, por tanto, protegida por quién puede alcanzarla — la red en la que está colocada — y el aggregate.yaml base es la forma que hay que compilar.