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

Valkey — un Aggregate, deux cibles, authentification facultative

Cet exemple minimal compile un seul cache en mémoire Valkey (protocole réseau de Redis) à 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 valkey/valkey directement sur Kubernetes (aucun chart externe).

La Recipe helm synthétisée est le chemin Kubernetes : 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 montrent le même cache avec une information d’identification facultative de mot de passe rattachée : aggregate-auth.yaml pour le chemin Compose (une information d’identification inject-value avec laquelle le serveur est démarré), et aggregate-helm-synth-auth.yaml pour le chemin helm synthétisé (une information d’identification référençable matérialisée sous forme de Secret Kubernetes).

Fichiers

FichierRôle
aggregate.yamlIntention du développeur : un composant cache de type core/datastore/valkey, sans information d’identification — le cache fonctionne sans authentification.
aggregate-auth.yamlLe même cache avec une information d’identification de mot de passe rattachée à l’emplacement facultatif password du composant (chemin Compose).
aggregate-helm-synth-auth.yamlLe même cache avec une information d’identification référençable rattachée pour le chemin helm synthétisé — la valeur est matérialisée sous forme d’un Secret Kubernetes que référence le Deployment.
manifest-compose.yamlAssocie le type Valkey à la Recipe Compose (compose/valkey) et l’information d’identification à dotenv-secret.
manifest-helm-synth.yamlAssocie le type Valkey à la Recipe helm synthétisée (helm/valkey) et l’information d’identification à k8s-secret-from-parameter.
release-compose.yaml / release-helm-synth.yamlDocuments de l’opérateur pour les deux réalisations, sans authentification.
release-compose-auth.yaml / release-helm-synth-auth.yamlEnregistrements de l’opérateur qui activent l’authentification.

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 dans un rôle de cache. Valkey est utilisé ici comme cache en mémoire et ne stocke rien de manière durable, si bien que le composant est typé comme un simple server plutôt que comme un stateful-server. Sur Kubernetes, la Recipe helm synthétisée rend un Deployment, et non 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 valkey/valkey — 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 valkey 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/valkey et helm/valkey.
  • Authentification facultative via un emplacement d’identifiants. Le composant déclare un emplacement facultatif password dans son featuresSchema. Lorsqu’aucune information d’identification n’est rattachée (l’Aggregate de base), la Recipe rend le cache avec l’authentification désactivée — de manière identique octet par octet à une Recipe sans emplacement. Lorsqu’une information d’identification est rattachée, les deux cibles démarrent Valkey avec --requirepass, si bien que le serveur exige le mot de passe : sur Compose, la valeur atteint le serveur via la variable VALKEY_EXTRA_FLAGS de l’image ; sur Kubernetes, le chemin helm synthétisé la matérialise sous forme d’un Secret que référence le Deployment.

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 valkey-cache

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

Terminal window
cd valkey-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), no authentication
aggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official image), no authentication
aggrega build --release release-helm-synth.yaml --auto-pull
# The same realizations with authentication enabled
aggrega build --release release-compose-auth.yaml --auto-pull
aggrega build --release release-helm-synth-auth.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 `valkey-cache`, appelez une fois l’outil `scaffold` avec `example` défini sur `valkey-cache` et sans `dir` : il écrit l’exemple dans un nouveau dossier `valkey-cache`. Appelez ensuite l’outil `build` une fois pour chaque Release, dans cet ordre — `release-compose.yaml`, `release-helm-synth.yaml`, `release-compose-auth.yaml` et `release-helm-synth-auth.yaml` —, chaque fois avec `workspace_root` défini sur `valkey-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 `valkey-cache/dist/`.

Note sur la livraison des informations d’identification

Sur le chemin Compose, l’information d’identification est un secret inject-value (aggregate-auth.yaml) : sa valeur est livrée sur le pipe d’environnement du composant sous la variable que nomme son values.key, VALKEY_PASSWORD, et la Recipe la transmet au serveur comme --requirepass via la variable VALKEY_EXTRA_FLAGS de l’image, si bien qu’elle apparaît dans l’environnement du service mais pas sur sa ligne de commande. Le script de démarrage de l’image développe cette variable sans guillemets, si bien qu’un mot de passe contenant une espace arrête le serveur au démarrage, et qu’un mot de passe contenant *, ? ou [ est comparé aux noms de fichiers du répertoire de données du serveur ; écrivez donc le mot de passe sans l’un ni l’autre. Un rattachement de mot de passe dont la valeur n’atteint la Recipe sous aucune variable qu’elle lit arrête le build, en nommant l’emplacement, plutôt que de rendre un cache non protégé.

Le chemin helm synthétisé utilise une information d’identification référençable (aggregate-helm-synth-auth.yaml) : la valeur est matérialisée sous forme de Secret Kubernetes, le Deployment la référence via un secretKeyRef d’environnement, et Valkey est démarré avec --requirepass lisant cette variable d’environnement. Le mot de passe en clair n’apparaît donc jamais dans le manifeste du Deployment — seulement dans le Secret. C’est ce qui active réellement l’authentification sur l’image officielle valkey/valkey, qui ne lit pas d’elle-même de mot de passe depuis l’environnement.

La valeur origin dans les Aggregates authentifiés est un espace réservé de développement ; fournissez une valeur réelle via votre source d’informations d’identification pour tout déploiement réel.