Memcached — un Aggregate, deux cibles, et un mot de passe refusé
Cet exemple minimal compile un seul cache en mémoire Memcached à partir d’un seul Aggregate écrit par le développeur en deux réalisations :
- Docker Compose pour le développement local, et
- la Recipe helm synthétisée qui exécute l’image upstream officielle
memcacheddirectement sur Kubernetes (aucun chart externe).
La Recipe helm synthétisée est le chemin Kubernetes privilégié : elle ne dépend que d’un tag d’image officiel plutôt que d’un chart tiers, et son ensemble de ressources rendu est exactement ce que déclare la charge de travail.
Le même aggregate.yaml pilote les deux. Seule la couche de Recipe sélectionnée par le Manifest change d’une réalisation à l’autre. Deux autres Aggregates rattachent un mot de passe au cache, et leurs Releases sont des exemples négatifs : le build s’arrête, parce qu’aucune réalisation ne peut faire respecter un mot de passe Memcached.
Fichiers
| Fichier | Rôle |
|---|---|
aggregate.yaml | Intention du développeur : un composant cache de type core/datastore/memcached, sans information d’identification — le cache s’exécute sans authentification. |
aggregate-auth.yaml | Le même cache avec une information d’identification inject-value de mot de passe rattachée au slot facultatif password du composant (chemin Compose). Son build s’arrête. |
aggregate-helm-synth-auth.yaml | Le même cache avec une information d’identification référençable de mot de passe rattachée pour le chemin helm synthétisé. Son build s’arrête. |
manifest-compose.yaml | Associe le type Memcached à la Recipe Compose (compose/memcached) et l’information d’identification à dotenv-secret. |
manifest-helm-synth.yaml | Associe le type Memcached à la Recipe helm synthétisée (helm/memcached) et l’information d’identification à k8s-secret-from-parameter. |
release-compose.yaml / release-helm-synth.yaml | Enregistrements de l’opérateur pour les deux réalisations. |
release-negative-compose-auth.yaml / release-negative-helm-synth-auth.yaml | Documents de l’opérateur portant sur les deux Aggregates avec mot de passe. Chaque build est censé échouer. |
Ce qu’il démontre
- Une seule surface de rédaction, plusieurs cibles. Un seul Aggregate est la source de vérité sur ce qu’est la stack. Chaque Manifest dit comment la réaliser.
- Un datastore sans état. Memcached conserve les entrées en mémoire et ne stocke rien de façon durable, si bien que le composant est typé comme un simple
serverplutôt que comme unstateful-server. Sur Kubernetes, la Recipe rend un Deployment, pas un StatefulSet, et ne demande aucun volume persistant ; sur Compose, le service ne déclare aucun volume de données. - Synthèse de Workload (Kubernetes). La Recipe helm synthétisée déclare un Workload — un Deployment plus un Service ClusterIP exécutant l’image officielle
memcached— que le fournisseur helm traduit en manifestes Kubernetes sans aucun chart externe. L’ensemble de ressources rendu est exactement ce que déclare le Workload. Comme le nommemcachedest porté à la fois par une Recipe Compose et par une helm synthétisée, les Manifests les référencent avec une portée de fournisseur sous les nomscompose/memcachedethelm/memcached. - Une protection qu’une réalisation ne peut pas assurer est refusée, pas abandonnée. Le composant déclare un slot facultatif
password. L’imagememcachedn’impose aucun mot de passe : ses deux modes d’authentification sont SASL, parlé uniquement sur le protocole binaire, et un fichier d’authentification ASCII, et les clients Memcached du catalogue n’utilisent ni l’un ni l’autre. Une Recipe qui accepterait le rattachement rendrait un cache qui répond à tout client alors que l’Aggregate le dit protégé, si bien que chaque Recipe arrête plutôt le build, en nommant le slot.
Générer l’exemple
Vous pouvez construire cet exemple avec les commandes ci-dessous, ou le faire construire pour vous par votre assistant IA.
Écrivez l’exemple dans un nouveau dossier qui porte son nom :
aggrega scaffold --example memcached-cacheElle affiche ensuite les prochaines commandes à exécuter. La première vous place dans le nouveau dossier :
cd memcached-cacheBuild
Ce workspace ne contient aucun .aggrega-config.yaml, si bien que les entités de la bibliothèque standard sont résolues depuis le registre du hub, hub.aggrega.ai, et aucune option de catalogue n’est nécessaire ; --auto-pull écrit pendant le build le lockfile qui manque à un clone récent :
# 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-pullLes artefacts rendus atterrissent sous dist/.
Avec un assistant IA
Un assistant IA configuré avec les outils d’Aggrega peut faire de même : collez-lui ce prompt.
Utilisez uniquement les outils Aggrega et ne créez vous-même aucun dossier. Si le dossier de l’espace de travail ne contient pas encore de dossier `memcached-cache`, appelez une fois l’outil `scaffold` avec `example` défini sur `memcached-cache` et sans `dir` : il écrit l’exemple dans un nouveau dossier `memcached-cache`. Appelez ensuite l’outil `build` une fois pour chaque Release, dans cet ordre — `release-compose.yaml` et `release-helm-synth.yaml` —, chaque fois avec `workspace_root` défini sur `memcached-cache`, `release` défini sur ce fichier, `auto_pull` défini sur true et `write` défini sur true. Indiquez-moi quels fichiers chaque build a écrits ; ils se trouvent sous `memcached-cache/dist/`.Le témoin : un mot de passe que le cache ne peut pas faire respecter
Les deux Releases négatives construisent les Aggregates avec mot de passe, et chaque build est censé échouer :
aggrega build --release release-negative-compose-auth.yaml --auto-pullaggrega build --release release-negative-helm-synth-auth.yaml --auto-pullChacune s’arrête dans la Recipe Memcached, avant que quoi que ce soit ne soit écrit, et l’arrêt se termine par le message propre à la 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 itsnetworkLe refus porte sur le rattachement lui-même, et non sur la façon dont l’information d’identification est livrée, si bien que toute Feature capable de remplir le slot s’arrête de la même façon. Les réalisations managées se comportent de même : Amazon ElastiCache n’offre aucune authentification Memcached, et ses Recipes s’arrêtent elles aussi sur le rattachement. Un cache Memcached est donc protégé par qui peut l’atteindre — le réseau sur lequel il est placé — et l’aggregate.yaml de base est la forme à construire.