Zum Inhalt springen
AggregaAggrega
Sprache wählen: Deutsch
Diese Seite wurde maschinell übersetzt. Das englische Original lesen.

Memcached — ein Aggregate, zwei Ziele und ein Passwort, das zurückgewiesen wird

Dieses schlanke Beispiel kompiliert einen einzelnen Memcached-In-Memory-Cache 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 memcached direkt auf Kubernetes ausführt (kein externes Chart).

Das synthetisierte helm-Recipe ist der bevorzugte 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 binden ein Passwort an den Cache an, und ihre Releases sind Negativbeispiele: Der Build bricht ab, weil keine Realisierung ein Memcached-Passwort durchsetzen kann.

Dateien

DateiRolle
aggregate.yamlEntwicklerabsicht: eine Komponente cache vom Typ core/datastore/memcached, keine Zugangsdaten — der Cache läuft ohne Authentifizierung.
aggregate-auth.yamlDerselbe Cache mit Zugangsdaten vom Typ inject-value für das Passwort, angebunden an den optionalen Slot password der Komponente (Compose-Pfad). Sein Build bricht ab.
aggregate-helm-synth-auth.yamlDerselbe Cache mit referenzierbaren Zugangsdaten für das Passwort, angebunden für den synthetisierten helm-Pfad. Sein Build bricht ab.
manifest-compose.yamlBildet den Memcached-Typ auf das Compose-Recipe (compose/memcached) und die Zugangsdaten auf dotenv-secret ab.
manifest-helm-synth.yamlBildet den Memcached-Typ auf das synthetisierte helm-Recipe (helm/memcached) und die Zugangsdaten auf k8s-secret-from-parameter ab.
release-compose.yaml / release-helm-synth.yamlBetreiber-Datensätze für die beiden Realisierungen.
release-negative-compose-auth.yaml / release-negative-helm-synth-auth.yamlDokumente des Operators zu den beiden Aggregates mit Passwort. Jeder Build soll fehlschlagen.

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 zustandsloser Datenspeicher. Memcached hält Einträge im Speicher und speichert nichts dauerhaft, daher ist die Komponente als einfacher server statt als stateful-server typisiert. Auf Kubernetes rendert das 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 memcached ausführt —, die der helm-Provider ohne externes Chart in Kubernetes-Manifeste übersetzt. Die gerenderte Ressourcenmenge ist genau das, was die Workload deklariert. Da der Name memcached sowohl von einem Compose- als auch von einem synthetisierten helm-Recipe getragen wird, referenzieren die Manifests sie auf den Provider bezogen als compose/memcached und helm/memcached.
  • Ein Schutz, den eine Realisierung nicht bieten kann, wird zurückgewiesen, nicht verworfen. Die Komponente deklariert einen optionalen Slot password. Das Image memcached setzt kein Passwort durch: Seine beiden Authentifizierungsmodi sind SASL, das nur über das Binärprotokoll gesprochen wird, und eine ASCII-Authentifizierungsdatei, und die Memcached-Clients des Katalogs verwenden keinen von beiden. Ein Recipe, das die Anbindung akzeptierte, würde einen Cache rendern, der jedem Client antwortet, während das Aggregate sagt, er sei geschützt, daher bricht jedes Recipe stattdessen den Build ab und nennt den Slot.

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:

Terminal window
aggrega scaffold --example memcached-cache

Danach gibt er die als Nächstes auszuführenden Befehle aus. Der erste wechselt in den neuen Ordner:

Terminal window
cd memcached-cache

Build

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:

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

Gerenderte 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-Tools und legen Sie selbst keinen Ordner an. Wenn der Workspace-Ordner noch keinen Ordner `memcached-cache` enthält, rufen Sie das Tool `scaffold` einmal mit `example` auf `memcached-cache` gesetzt und ohne `dir` auf: Es schreibt das Beispiel in einen neuen Ordner `memcached-cache`. Rufen Sie anschließend das Tool `build` einmal für jedes Release auf, in dieser Reihenfolge — `release-compose.yaml` und `release-helm-synth.yaml` —, jedes Mal mit `workspace_root` auf `memcached-cache`, `release` auf diese Datei, `auto_pull` auf true und `write` auf true gesetzt. Nennen Sie mir, welche Dateien jeder Build geschrieben hat; sie liegen unter `memcached-cache/dist/`.

Die Kontrolle: ein Passwort, das der Cache nicht durchsetzen kann

Die beiden negativen Releases bauen die Aggregates mit Passwort, und jeder Build soll fehlschlagen:

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

Jedes bricht im Memcached-Recipe ab, bevor irgendetwas geschrieben wird, und der Abbruch endet mit der eigenen Meldung des 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

Die Zurückweisung hängt an der Anbindung selbst, nicht daran, wie die Zugangsdaten zugestellt werden, daher bricht jedes Feature, das den Slot füllen kann, auf dieselbe Weise ab. Die verwalteten Realisierungen verhalten sich ebenso: Amazon ElastiCache bietet keine Memcached-Authentifizierung, und auch seine Recipes brechen bei der Anbindung ab. Ein Memcached-Cache wird daher dadurch geschützt, wer ihn erreichen kann — durch das Netzwerk, in dem er platziert ist —, und das grundlegende aggregate.yaml ist die Form, die gebaut werden sollte.