Salta ai contenuti
AggregaAggrega
Seleziona lingua: Italiano
Questa pagina è stata tradotta automaticamente. Leggi l’originale in inglese.

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 memcached direttamente 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

FileRuolo
aggregate.yamlIntento dello sviluppatore: un componente cache di tipo core/datastore/memcached, nessuna credenziale — la cache funziona senza autenticazione.
aggregate-auth.yamlLa 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.yamlLa stessa cache con una credenziale referenziabile per la password associata per il percorso helm sintetizzato. Il suo build si arresta.
manifest-compose.yamlMappa il tipo Memcached sulla Recipe Compose (compose/memcached) e la credenziale su dotenv-secret.
manifest-helm-synth.yamlMappa il tipo Memcached sulla Recipe helm sintetizzata (helm/memcached) e la credenziale su k8s-secret-from-parameter.
release-compose.yaml / release-helm-synth.yamlDocumenti dell’operatore per le due realizzazioni.
release-negative-compose-auth.yaml / release-negative-helm-synth-auth.yamlDocumenti 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 server anziché come stateful-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 nome memcached è portato sia da una Recipe Compose sia da una helm sintetizzata, i Manifests vi fanno riferimento con ambito di provider come compose/memcached e helm/memcached.
  • Una protezione che una realizzazione non può dare viene rifiutata, non scartata. Il componente dichiara uno slot facoltativo password. L’immagine memcached non 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:

Terminal window
aggrega scaffold --example memcached-cache

Poi stampa i prossimi comandi da eseguire. Il primo ti porta nella nuova cartella:

Terminal window
cd memcached-cache

Build

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:

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

Gli 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:

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

Ciascuna 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 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

Il 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.