Salta ai contenuti
AggregaAggrega
Seleziona lingua: Italiano
Questa pagina è stata tradotta automaticamente. Leggi l’originale in inglese.

Modello dei dati

Questa pagina spiega un’unica idea, chi scrive quali dati su un componente, e non è un’area di lavoro eseguibile. Un contratto, tre realizzazioni la mostra in un’area di lavoro che compili tu; scrivila in una cartella tua con:

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

Poi stampa i prossimi comandi da eseguire:

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 e infra: due namespace, due autori

Un Component dichiara due insiemi separati di impostazioni. I suoi values sono dello sviluppatore, scritti nell’Aggregate: ciò di cui l’applicazione ha bisogno, uguale in ogni ambiente. I suoi infra sono dell’operatore, scritti nella Release: dimensionamento e posizionamento, che cambiano da un ambiente all’altro. Gli schemi tengono separati i due — lo schema dell’Aggregate non ha infra su un componente e lo schema della Release non ha values — quindi nessuno dei due autori può impostare i campi dell’altro. Una Recipe li riceve entrambi, come due oggetti separati, .values e .infra.

Nell’esempio, lo sviluppatore nomina il database e il suo ruolo di login, da aggregate.yaml:

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

e la Release che compila un’istanza gestita la dimensiona, da release-managed.yaml senza i commenti:

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

Le altre due Releases dell’esempio compilano lo stesso Aggregate in un cluster e su un server che esiste già, ciascuna con i propri infra; l’Aggregate non cambia.

Un valore che deve comunque variare a seconda dell’ambiente viene sollevato: l’Aggregate dichiara un parametro, lo scrive nel valore e ciascuna Release soddisfa il parametro (vedi I file di un build).

Una Release costruita su un’altra

Una Release può nominare un’altra Release come propria base con extends: e cambiare solo ciò che differisce. La figlia eredita dalla base i confini, il posizionamento e i parametri, e la dichiarazione di aggregate: accanto a extends: viene rifiutata dallo schema della Release, perché la figlia deve compilare lo stesso Aggregate della sua base. Può nominare un proprio Manifest, oppure omettere manifest: ed ereditare quello della base.

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

Il directory: di un confine viene ereditato come qualsiasi altra impostazione, quindi una figlia che eredita una directory letterale renderizza nello stesso posto della sua base. Scrivere la directory in funzione di un parametro è ciò che manda l’output di ogni Release in un posto tutto suo; vedi Release composita ed ereditarietà con extends.

Un Manifest costruito su un altro

Un Manifest può estenderne un altro allo stesso modo, e le sue voci sostituiscono la voce della base con la stessa chiave. Un Manifest di sviluppo può mantenere ogni associazione di quello di produzione e cambiare il modo in cui vengono realizzate le credenziali: qui un allegato core/referenced-secret viene recuperato da un archivio di segreti in produzione e scritto in un Secret a partire dal valore che un autore fornisce in sviluppo.

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

Le due realizzazioni pubblicano il nome del Secret allo stesso modo, quindi un componente che legge la credenziale renderizza lo stesso riferimento con l’uno o l’altro Manifest; Un intento dello sviluppatore, due forme di consegna delle credenziali li compila entrambi e li confronta.

Due etichette: il tipo e la categoria

Ogni Component porta un valore di un insieme chiuso sull’etichetta riservata component.aggrega.ai/type: server, un endpoint di lunga durata; worker, un consumatore in background; stateful-server, qualcosa che conserva i propri dati persistenti; task, che viene eseguito fino al completamento; function, una funzione guidata dagli eventi; e resource, una risorsa cloud gestita che non esegue alcuna elaborazione propria. Il valore si trova sull’entità del catalogo, mai sull’istanza in un Aggregate.

Il tipo dice come l’infrastruttura deve trattare un componente, non a cosa serve il componente. Un broker di messaggi che possiede il proprio disco è uno stateful-server, esattamente come lo è un database: core/messaging/kafka e core/datastore/postgres portano lo stesso tipo. Ciò su cui un lettore naviga è l’altra etichetta, component.aggrega.ai/category — messaging per il broker, datastore per il database — che è anche la directory del catalogo in cui si trova l’entità. Un selettore scritto su un’etichetta non trova mai corrispondenze sull’altra.