Valkey — ein Aggregate, zwei Ziele, optionale Authentifizierung
Dieses schlanke Beispiel kompiliert einen einzelnen Valkey-In-Memory-Cache (Redis-Wire-Protokoll) aus einem einzigen vom Entwickler verfassten Aggregate zu zwei Realisierungen:
- Docker Compose für die lokale Entwicklung und
- das synthetisierte helm-Recipe, das das offizielle Upstream-Image
valkey/valkeydirekt auf Kubernetes ausführt (kein externes Chart).
Das synthetisierte helm-Recipe ist der Kubernetes-Pfad: Es hängt nur von einem offiziellen Image-Tag statt von einem Chart eines Drittanbieters ab, und seine gerenderte Ressourcenmenge ist genau das, was die Arbeitslast deklariert.
Dasselbe aggregate.yaml steuert beide. Pro Realisierung ändert sich nur die vom Manifest ausgewählte Recipe-Schicht. Zwei weitere Aggregates zeigen denselben Cache mit angebundenen optionalen Zugangsdaten für das Passwort: aggregate-auth.yaml für den Compose-Pfad (Zugangsdaten vom Typ inject-value, mit denen der Server gestartet wird) und aggregate-helm-synth-auth.yaml für den synthetisierten helm-Pfad (referenzierbare Zugangsdaten, als Kubernetes-Secret materialisiert).
Dateien
| Datei | Rolle |
|---|---|
aggregate.yaml | Entwicklerabsicht: eine Komponente cache vom Typ core/datastore/valkey, keine Zugangsdaten — der Cache läuft ohne Authentifizierung. |
aggregate-auth.yaml | Derselbe Cache mit Zugangsdaten für das Passwort, angebunden an den optionalen Slot password der Komponente (Compose-Pfad). |
aggregate-helm-synth-auth.yaml | Derselbe Cache mit referenzierbaren Zugangsdaten, angebunden für den synthetisierten helm-Pfad — der Wert wird als Kubernetes-Secret materialisiert, das das Deployment referenziert. |
manifest-compose.yaml | Bildet den Valkey-Typ auf das Compose-Recipe (compose/valkey) und die Zugangsdaten auf dotenv-secret ab. |
manifest-helm-synth.yaml | Bildet den Valkey-Typ auf das synthetisierte helm-Recipe (helm/valkey) und die Zugangsdaten auf k8s-secret-from-parameter ab. |
release-compose.yaml / release-helm-synth.yaml | Dokumente des Operators für die beiden Realisierungen, ohne Authentifizierung. |
release-compose-auth.yaml / release-helm-synth-auth.yaml | Betreiber-Datensätze, die die Authentifizierung aktivieren. |
Was es zeigt
- Eine Authoring-Oberfläche, viele Ziele. Ein einziges Aggregate ist die maßgebliche Quelle dafür, was der Stack ist. Jedes Manifest sagt, wie er zu realisieren ist.
- Ein Datenspeicher in der Rolle eines Caches. Valkey wird hier als In-Memory-Cache verwendet und speichert nichts dauerhaft, daher ist die Komponente als einfacher
serverstatt alsstateful-servertypisiert. Auf Kubernetes rendert das synthetisierte helm-Recipe ein Deployment, kein StatefulSet, und fordert kein persistentes Volume an; auf Compose deklariert der Service kein Daten-Volume. - Workload-Synthese (Kubernetes). Das synthetisierte helm-Recipe deklariert eine Workload — ein Deployment plus einen ClusterIP-Service, der das offizielle Image
valkey/valkeyausführt —, die der helm-Provider ohne externes Chart in Kubernetes-Manifeste übersetzt. Die gerenderte Ressourcenmenge ist genau das, was die Workload deklariert. Da der Namevalkeysowohl von einem Compose- als auch von einem synthetisierten helm-Recipe getragen wird, referenzieren die Manifests sie auf den Provider bezogen alscompose/valkeyundhelm/valkey. - Optionale Authentifizierung über einen Slot für Zugangsdaten. Die Komponente deklariert in ihrem
featuresSchemaeinen optionalen Slotpassword. Sind keine Zugangsdaten angebunden (das Basis-Aggregate), rendert das Recipe den Cache mit deaktivierter Authentifizierung — byteidentisch zu einem Recipe ohne Slot. Sind Zugangsdaten angebunden, starten beide Ziele Valkey mit--requirepass, sodass der Server das Passwort verlangt: Auf Compose erreicht der Wert den Server über die VariableVALKEY_EXTRA_FLAGSdes Images; auf Kubernetes materialisiert ihn der synthetisierte helm-Pfad als Secret, das das Deployment referenziert.
Das Beispiel generieren
Sie können dieses Beispiel mit den folgenden Befehlen bauen oder es von Ihrem KI-Assistenten für Sie bauen lassen.
Schreiben Sie das Beispiel in einen neuen Ordner, der nach ihm benannt ist:
aggrega scaffold --example valkey-cacheDanach gibt er die als Nächstes auszuführenden Befehle aus. Der erste wechselt in den neuen Ordner:
cd valkey-cacheBuild
Dieser Workspace enthält kein .aggrega-config.yaml, daher werden die Entitäten der Standardbibliothek aus der Hub-Registry hub.aggrega.ai aufgelöst, und es ist kein Katalog-Flag nötig; --auto-pull schreibt während des Builds das Lockfile, das einem frischen Klon fehlt:
# Local development (Docker Compose), no authenticationaggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official image), no authenticationaggrega build --release release-helm-synth.yaml --auto-pull
# The same realizations with authentication enabledaggrega build --release release-compose-auth.yaml --auto-pullaggrega build --release release-helm-synth-auth.yaml --auto-pullGerenderte Artefakte landen unter dist/.
Mit einem KI-Assistenten
Ein KI-Assistent, der mit den Tools von Aggrega eingerichtet ist, kann dasselbe tun: Fügen Sie ihm diesen Prompt ein.
Verwenden Sie ausschließlich die Aggrega-Werkzeuge und legen Sie selbst keinen Ordner an. Wenn der Ordner des Arbeitsbereichs noch keinen Ordner `valkey-cache` enthält, rufen Sie das Werkzeug `scaffold` einmal auf, mit `example` auf `valkey-cache` gesetzt und ohne `dir`: Es schreibt das Beispiel in einen neuen Ordner `valkey-cache`. Rufen Sie dann das Werkzeug `build` einmal für jedes Release auf, in dieser Reihenfolge — `release-compose.yaml`, `release-helm-synth.yaml`, `release-compose-auth.yaml` und `release-helm-synth-auth.yaml` —, jedes Mal mit `workspace_root` auf `valkey-cache`, `release` auf diese Datei, `auto_pull` auf true und `write` auf true gesetzt. Nennen Sie mir die Dateien, die jeder Build geschrieben hat; sie liegen unter `valkey-cache/dist/`.Hinweis zur Zustellung der Zugangsdaten
Auf dem Compose-Pfad sind die Zugangsdaten ein Secret vom Typ inject-value (aggregate-auth.yaml): Sein Wert wird über die Umgebungs-Pipe der Komponente unter der Variable zugestellt, die sein values.key benennt, VALKEY_PASSWORD, und das Recipe übergibt ihn dem Server als --requirepass über die Variable VALKEY_EXTRA_FLAGS des Images, sodass er in der Umgebung des Service erscheint, aber nicht in seiner Befehlszeile. Das Startskript des Images expandiert diese Variable ohne Anführungszeichen, daher stoppt ein Passwort mit einem Leerzeichen den Server beim Start, und eines mit *, ? oder [ wird mit Dateinamen im Datenverzeichnis des Servers abgeglichen; schreiben Sie das Passwort daher ohne beides. Eine Passwort-Anbindung, deren Wert das Recipe unter keiner Variable erreicht, die es liest, bricht den Build ab und benennt den Slot, statt einen ungeschützten Cache zu rendern.
Der synthetisierte helm-Pfad verwendet referenzierbare Zugangsdaten (aggregate-helm-synth-auth.yaml): Der Wert wird als Kubernetes-Secret materialisiert, das Deployment referenziert es über einen secretKeyRef in der Umgebung, und Valkey wird mit --requirepass gestartet, das diese Umgebungsvariable liest. Das Klartext-Passwort erscheint daher nie im Deployment-Manifest — nur im Secret. Erst dies aktiviert tatsächlich die Authentifizierung beim offiziellen Image valkey/valkey, das von sich aus kein Passwort aus der Umgebung liest.
Der Wert origin in den authentifizierten Aggregates ist ein Platzhalter für die Entwicklung; liefern Sie für jede reale Bereitstellung einen echten Wert über Ihre Zugangsdatenquelle.