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

Modèle de données

Cette page explique une seule idée, qui écrit quelles données sur un composant, et n’est pas un espace de travail exécutable. Un contrat, trois réalisations la montre dans un espace de travail que vous construisez ; écrivez-le dans un dossier à vous avec :

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

Elle affiche ensuite les prochaines commandes à exécuter :

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 et infra : deux espaces de noms, deux auteurs

Un Component déclare deux ensembles de paramètres distincts. Ses values appartiennent au développeur et s’écrivent dans l’Aggregate : ce dont l’application a besoin, identique dans chaque environnement. Ses infra appartiennent à l’opérateur et s’écrivent dans la Release : le dimensionnement et le placement, qui diffèrent d’un environnement à l’autre. Les schémas séparent les deux — le schéma de l’Aggregate n’a pas d’infra sur un composant et le schéma de la Release n’a pas de values — de sorte qu’aucun auteur ne peut définir les champs de l’autre. Une Recipe reçoit les deux, sous forme de deux objets distincts, .values et .infra.

Dans l’exemple, le développeur nomme la base de données et son rôle de connexion, extrait de aggregate.yaml :

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

et la Release qui construit une instance gérée la dimensionne, extrait de release-managed.yaml sans ses commentaires :

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

Les deux autres Releases de l’exemple construisent le même Aggregate dans un cluster et sur un serveur qui existe déjà, chacune avec ses propres infra ; l’Aggregate ne change pas.

Une valeur qui doit malgré tout varier selon l’environnement est remontée : l’Aggregate déclare un paramètre, l’écrit dans la valeur, et chaque Release renseigne le paramètre (voir Les fichiers d’un build).

Une Release construite sur une autre

Une Release peut nommer une autre Release comme base avec extends: et ne changer que ce qui diffère. L’enfant hérite des frontières, du placement et des paramètres de la base, et déclarer aggregate: à côté de extends: est refusé par le schéma de la Release, car l’enfant doit construire le même Aggregate que sa base. Il peut nommer son propre Manifest, ou omettre manifest: et hériter de celui de la base.

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

Le directory: d’une frontière est hérité comme n’importe quel autre paramètre, de sorte qu’un enfant qui hérite d’un répertoire littéral effectue son rendu au même endroit que sa base. Écrire le répertoire en fonction d’un paramètre est ce qui envoie la sortie de chaque Release vers un emplacement qui lui est propre ; voir Release composite et héritage par extends.

Un Manifest construit sur un autre

Un Manifest peut en étendre un autre de la même façon, et ses entrées remplacent l’entrée de la base pour la même clé. Un Manifest de développement peut conserver chaque liaison de celui de production et changer la façon dont les identifiants sont réalisés : ici, un rattachement core/referenced-secret est récupéré depuis un coffre de secrets en production et écrit dans un Secret à partir de la valeur qu’un auteur fournit en développement.

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

Les deux réalisations publient le nom du Secret de la même façon, de sorte qu’un composant qui lit l’identifiant effectue le rendu de la même référence avec l’un ou l’autre Manifest ; Une intention du développeur, deux formes de livraison des identifiants construit les deux et les compare.

Deux étiquettes : le type et la catégorie

Chaque Component porte une valeur d’un ensemble fermé sur l’étiquette réservée component.aggrega.ai/type : server, un point de terminaison de longue durée ; worker, un consommateur en arrière-plan ; stateful-server, quelque chose qui conserve ses propres données durables ; task, qui s’exécute jusqu’à son terme ; function, une fonction pilotée par les événements ; et resource, une ressource cloud gérée qui n’exécute aucun calcul propre. La valeur se trouve sur l’entité du catalogue, jamais sur l’instance dans un Aggregate.

Le type indique comment l’infrastructure doit traiter un composant, et non à quoi sert le composant. Un broker de messages qui détient son propre disque est un stateful-server, exactement comme une base de données : core/messaging/kafka et core/datastore/postgres portent le même type. Ce que parcourt un lecteur, c’est l’autre étiquette, component.aggrega.ai/category — messaging pour le broker, datastore pour la base de données — qui est aussi le répertoire du catalogue dans lequel se trouve l’entité. Un sélecteur écrit pour une étiquette ne correspond jamais sur l’autre.