Aller au contenu
AggregaAggrega
Selectionner la langue: Français
Cette page a été traduite automatiquement. Lire l’original en anglais.

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

FichierRôle
aggregate.yamlIntention du développeur : un composant cache de type core/datastore/memcached, sans information d’identification — le cache s’exécute sans authentification.
aggregate-auth.yamlLe 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.yamlLe 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.yamlAssocie le type Memcached à la Recipe Compose (compose/memcached) et l’information d’identification à dotenv-secret.
manifest-helm-synth.yamlAssocie 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.yamlEnregistrements de l’opérateur pour les deux réalisations.
release-negative-compose-auth.yaml / release-negative-helm-synth-auth.yamlDocuments 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 server plutôt que comme un stateful-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 nom memcached est 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 noms compose/memcached et helm/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’image memcached n’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 :

Terminal window
aggrega scaffold --example memcached-cache

Elle affiche ensuite les prochaines commandes à exécuter. La première vous place dans le nouveau dossier :

Terminal window
cd memcached-cache

Build

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 :

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

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

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

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

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