Memcached — un Aggregate, due target, e una password che viene rifiutata
Questo esempio essenziale compila una singola cache in memoria Memcached a partire da un unico Aggregate scritto dallo sviluppatore in due realizzazioni:
- Docker Compose per lo sviluppo locale, e
- la Recipe helm sintetizzata che esegue l’immagine upstream ufficiale
memcacheddirettamente su Kubernetes (nessun chart esterno).
La Recipe helm sintetizzata è il percorso Kubernetes preferito: dipende solo da un tag di immagine ufficiale anziché da un chart di terze parti, e il suo insieme di risorse renderizzato è esattamente ciò che dichiara il carico di lavoro.
Lo stesso aggregate.yaml guida entrambe. Per ogni realizzazione cambia solo il livello di Recipe selezionato dal Manifest. Altri due Aggregates associano una password alla cache, e le loro Releases sono esempi negativi: il build si arresta, perché nessuna realizzazione può far rispettare una password Memcached.
File
| File | Ruolo |
|---|---|
aggregate.yaml | Intento dello sviluppatore: un componente cache di tipo core/datastore/memcached, nessuna credenziale — la cache funziona senza autenticazione. |
aggregate-auth.yaml | La stessa cache con una credenziale inject-value per la password associata allo slot facoltativo password del componente (percorso Compose). Il suo build si arresta. |
aggregate-helm-synth-auth.yaml | La stessa cache con una credenziale referenziabile per la password associata per il percorso helm sintetizzato. Il suo build si arresta. |
manifest-compose.yaml | Mappa il tipo Memcached sulla Recipe Compose (compose/memcached) e la credenziale su dotenv-secret. |
manifest-helm-synth.yaml | Mappa il tipo Memcached sulla Recipe helm sintetizzata (helm/memcached) e la credenziale su k8s-secret-from-parameter. |
release-compose.yaml / release-helm-synth.yaml | Documenti dell’operatore per le due realizzazioni. |
release-negative-compose-auth.yaml / release-negative-helm-synth-auth.yaml | Documenti dell’operatore sui due Aggregates con password. Ciascun build è destinato a fallire. |
Che cosa dimostra
- Un’unica superficie di authoring, molti target. Un unico Aggregate è la fonte di verità su che cosa è lo stack. Ogni Manifest dice come realizzarlo.
- Un datastore senza stato. Memcached conserva le voci in memoria e non memorizza nulla in modo durevole, quindi il componente è tipizzato come un semplice
serveranziché comestateful-server. Su Kubernetes la Recipe renderizza un Deployment, non uno StatefulSet, e non richiede alcun volume persistente; su Compose il servizio non dichiara alcun volume di dati. - Sintesi del Workload (Kubernetes). La Recipe helm sintetizzata dichiara un Workload — un Deployment più un Service ClusterIP che esegue l’immagine ufficiale
memcached— che il provider helm traduce in manifest Kubernetes senza alcun chart esterno. L’insieme di risorse renderizzato è esattamente ciò che dichiara il Workload. Poiché il nomememcachedè portato sia da una Recipe Compose sia da una helm sintetizzata, i Manifests vi fanno riferimento con ambito di provider comecompose/memcachedehelm/memcached. - Una protezione che una realizzazione non può dare viene rifiutata, non scartata. Il componente dichiara uno slot facoltativo
password. L’immaginememcachednon impone alcuna password: le sue due modalità di autenticazione sono SASL, parlato solo sul protocollo binario, e un file di autenticazione ASCII, e i client Memcached del catalogo non usano né l’una né l’altra. Una Recipe che accettasse l’associazione renderizzerebbe una cache che risponde a ogni client mentre l’Aggregate dice che è protetta, quindi ciascuna Recipe arresta invece il build, nominando lo slot.
Generare l’esempio
Puoi eseguire la build di questo esempio con i comandi qui sotto, oppure farla eseguire al tuo assistente IA.
Scrivi l’esempio in una nuova cartella che porta il suo nome:
aggrega scaffold --example memcached-cachePoi stampa i prossimi comandi da eseguire. Il primo ti porta nella nuova cartella:
cd memcached-cacheBuild
Questo workspace non contiene alcun .aggrega-config.yaml, quindi le entità della libreria standard vengono risolte dal registry dell’hub, hub.aggrega.ai, e non serve alcun flag di catalogo; --auto-pull scrive durante il build il lockfile che manca a un clone appena creato:
# 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-pullGli artefatti renderizzati finiscono sotto dist/.
Con un assistente AI
Un assistente IA configurato con gli strumenti di Aggrega può fare lo stesso: incolla questo prompt nell’assistente.
Usa solo gli strumenti di Aggrega e non creare tu alcuna cartella. Se la cartella del workspace non contiene ancora una cartella `memcached-cache`, chiama una volta lo strumento `scaffold` con `example` impostato su `memcached-cache` e senza `dir`: scrive l’esempio in una nuova cartella `memcached-cache`. Poi chiama lo strumento `build` una volta per ogni Release, in questo ordine — `release-compose.yaml` e `release-helm-synth.yaml` — ogni volta con `workspace_root` impostato su `memcached-cache`, `release` impostato su quel file, `auto_pull` impostato su true e `write` impostato su true. Dimmi quali file ha scritto ciascuna build; si trovano in `memcached-cache/dist/`.Il controllo: una password che la cache non può far rispettare
Le due Releases negative eseguono il build degli Aggregates con password, e ciascun build è destinato a fallire:
aggrega build --release release-negative-compose-auth.yaml --auto-pullaggrega build --release release-negative-helm-synth-auth.yaml --auto-pullCiascuna si arresta nella Recipe Memcached, prima che venga scritto alcunché, e l’arresto termina con il messaggio proprio della Recipe:
a password is attached to the password slot of "cache", but the memcachedimage this Recipe runs cannot enforce a password: it authenticates only throughSASL over the binary protocol or an ASCII authentication file, which thecatalog's Memcached clients do not use, so the cache would accept every clientanyway; remove the attachment, and restrict who can reach the cache through itsnetworkIl rifiuto dipende dall’associazione stessa, non da come viene consegnata la credenziale, quindi ogni Feature che può riempire lo slot si arresta allo stesso modo. Le realizzazioni gestite si comportano in modo analogo: Amazon ElastiCache non offre alcuna autenticazione Memcached, e anche le sue Recipes si arrestano sull’associazione. Una cache Memcached è quindi protetta da chi può raggiungerla — la rete su cui è collocata — e l’aggregate.yaml di base è la forma di cui eseguire il build.