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

Datenmodell

Diese Seite erklärt eine einzige Idee, wer welche Daten über eine Komponente schreibt, und ist kein ausführbarer Arbeitsbereich. Ein Vertrag, drei Realisierungen zeigt sie in einem Arbeitsbereich, den Sie bauen; schreiben Sie ihn in einen eigenen Ordner mit:

Terminal window
aggrega scaffold --example postgres-three-realizations

Danach gibt er die als Nächstes auszuführenden Befehle aus:

Terminal window
cd postgres-three-realizations
aggrega build --release release-selfhosted.yaml --auto-pull
aggrega build --release release-managed.yaml --auto-pull
aggrega build --release release-managed-dns.yaml --auto-pull
aggrega build --release release-external.yaml --auto-pull

values und infra: zwei Namensräume, zwei Autoren

Eine Component deklariert zwei getrennte Gruppen von Einstellungen. Ihre values gehören dem Entwickler und werden im Aggregate geschrieben: was die Anwendung braucht, in jeder Umgebung gleich. Ihre infra gehören dem Operator und werden im Release geschrieben: Dimensionierung und Platzierung, die sich von einer Umgebung zur nächsten unterscheiden. Die Schemas halten beide getrennt — das Aggregate-Schema hat kein infra an einer Komponente und das Release-Schema hat keine values —, sodass keiner der beiden Autoren die Felder des anderen setzen kann. Ein Recipe erhält beide als zwei getrennte Objekte, .values und .infra.

Im Beispiel benennt der Entwickler die Datenbank und ihre Login-Rolle, aus aggregate.yaml:

spec:
components:
db:
type: core/datastore/postgres
values:
database: appdb
user: appuser

und das Release, das eine verwaltete Instanz baut, dimensioniert sie, aus release-managed.yaml ohne die Kommentare:

spec:
boundaries:
stack:
directory: stack
components:
db:
infra:
engine_version: "16"
storage:
size: 100Gi
type: gp3
ha:
enabled: true
read_replicas: 0

Die anderen beiden Releases des Beispiels bauen dasselbe Aggregate in einem Cluster und gegen einen bereits existierenden Server, jedes mit seinen eigenen infra; das Aggregate ändert sich nicht.

Ein Wert, der dennoch je nach Umgebung variieren soll, wird hochgezogen: Das Aggregate deklariert einen Parameter, schreibt ihn in den Wert, und jedes Release erfüllt den Parameter (siehe Die Dateien eines Builds).

Ein Release, das auf einem anderen aufbaut

Ein Release kann mit extends: ein anderes Release als seine Basis nennen und nur ändern, was sich unterscheidet. Das Kind erbt die Boundaries, die Platzierung und die Parameter der Basis, und eine Deklaration von aggregate: neben extends: wird vom Release-Schema abgelehnt, weil das Kind dasselbe Aggregate bauen muss wie seine Basis. Es darf ein eigenes Manifest nennen oder manifest: weglassen und das der Basis erben.

# release-prod.yaml: the base gives every other setting
spec:
extends: ./release-base.yaml
boundaries:
stack:
components:
db:
infra:
storage:
size: 500Gi

Das directory: einer Boundary wird wie jede andere Einstellung geerbt, sodass ein Kind, das ein literales Verzeichnis erbt, an dieselbe Stelle rendert wie seine Basis. Das Verzeichnis abhängig von einem Parameter zu schreiben, ist das, was die Ausgabe jedes Release an einen eigenen Ort schickt; siehe Zusammengesetztes Release und Vererbung mit extends.

Ein Manifest, das auf einem anderen aufbaut

Ein Manifest kann ein anderes auf dieselbe Weise erweitern, und seine Einträge ersetzen den Eintrag der Basis für denselben Schlüssel. Ein Manifest für die Entwicklung kann jede Bindung desjenigen für die Produktion behalten und ändern, wie Anmeldedaten realisiert werden: Hier wird ein Anhang core/referenced-secret in der Produktion aus einem Secret-Store abgerufen und in der Entwicklung aus dem Wert, den ein Autor angibt, in ein Secret geschrieben.

manifest-prod.yaml
spec:
mappings:
components:
type:
core/datastore/postgres:1.0.0: helm/postgres:1.0.0
features:
type:
core/referenced-secret:1.0.0: helm/k8s-external-secret:1.0.0
---
# manifest-dev.yaml
spec:
extends: ./manifest-prod.yaml
mappings:
features:
type:
core/referenced-secret:1.0.0: helm/k8s-secret-from-parameter:1.0.0

Die beiden Realisierungen veröffentlichen den Namen des Secrets auf dieselbe Weise, sodass eine Komponente, die die Anmeldedaten liest, dieselbe Referenz rendert, gleich welches Manifest gilt; Eine Entwicklerabsicht, zwei Formen der Bereitstellung von Anmeldedaten baut beide und vergleicht sie.

Zwei Labels: der Typ und die Kategorie

Jede Component trägt auf dem reservierten Label component.aggrega.ai/type einen Wert aus einer geschlossenen Menge: server, einen langlebigen Endpunkt; worker, einen Hintergrund-Consumer; stateful-server, etwas, das seine eigenen dauerhaften Daten hält; task, der bis zum Abschluss läuft; function, eine ereignisgesteuerte Funktion; und resource, eine verwaltete Cloud-Ressource, die keine eigene Rechenleistung ausführt. Der Wert steht an der Katalog-Entität, nie an der Instanz in einem Aggregate.

Der Typ sagt, wie die Infrastruktur eine Komponente behandeln muss, nicht, wofür die Komponente da ist. Ein Message-Broker mit eigener Festplatte ist ein stateful-server, genau wie eine Datenbank: core/messaging/kafka und core/datastore/postgres tragen denselben Typ. Wonach ein Leser browst, ist das andere Label, component.aggrega.ai/category — messaging für den Broker, datastore für die Datenbank —, das zugleich das Katalogverzeichnis ist, in dem die Entität liegt. Ein Selektor, der gegen das eine Label geschrieben ist, trifft nie auf das andere zu.