Routage de modules vers des frontières — placer des sous-modules entiers dans des frontières
Cet exemple compile deux capacités — un niveau de lecture des métriques Thanos sur un stockage objet et une base de données documentaire parlant le protocole réseau de MongoDB — à partir d’un seul Aggregate écrit par le développeur, et place chacune dans une frontière qui lui est propre depuis la Release.
Les deux capacités sont des modules : des sous-agrégats réutilisables qui composent chacun plusieurs composants à charge de travail unique et câblent leurs propres arêtes internes. L’Aggregate nomme les deux modules et rien sur l’endroit où ils s’exécutent. La Release place chaque module entier avec une entrée aggregates: par frontière — l’opérateur décide où une capacité s’exécute sans suivre, ni reformuler, ce qu’elle contient.
Fichiers
| Fichier | Rôle |
|---|---|
aggregate.yaml | Intention du développeur : importe le module de métriques (core/thanos) et le module de base de données documentaire (core/ferretdb). |
manifest.yaml | Associe chaque type de composant qu’apportent les deux modules à sa Recipe helm synth, la Feature d’informations d’identification que rattache le module de métriques à la réalisation qui émet un Secret à partir de chacun des deux paramètres de clé du module, et la Feature de scrape à sa FeatureRecipe. |
release.yaml | Document de l’opérateur : route chaque module vers sa propre frontière, dimensionne un composant d’un module et lui rattache la Feature de scrape. |
Ce qu’il démontre
- Router un module entier vers une frontière. L’entrée
aggregates:d’une frontière a pour clé le nom du module dans l’Aggregate. Elle place chaque composant que contient le module, si bien que les artefacts émis pour les trois composants de métriques aboutissent sous la frontièreobservabilityet les deux composants de la base de données documentaire sousdata. - Ne nommer aucun composant est la forme principale. La frontière
dataroute le module de base de données documentaire avec un simpledocuments: {}. Chaque composant qu’il contient est placé et prend ses propres valeurs par défaut de schéma ; la Release a besoin du nom du module et de rien d’autre à son sujet. - Configurer un composant routé par son nom local. Une entrée de routage peut aussi configurer des composants individuels du module qu’elle route, adressés par le nom local que chacun porte dans ce module —
query, et nonmetrics.query, car dans le module c’est le seul nom qu’il a. Nommer un composant ne dit rien des autres : ici,queryest dimensionné et reçoit une cible de scrape, tandis que le magasin d’objets et le store gateway sont routés avec leurs valeurs par défaut. - Un composant routé est un composant de cette frontière. Il hérite de la cascade d’annotations de la frontière comme tout autre, et c’est ce qui donne à chaque ressource d’un module routé la valeur
aggrega.ai/namespacede la frontière — y compris aux composants que l’entrée de routage ne mentionne jamais. - Le routage est un placement, pas un autre type d’appartenance. Un composant routé sans que rien ne soit dit à son sujet est rendu de la même façon que le même composant nommé directement dans cette frontière avec un corps vide. Les deux écritures sont deux façons de dire où se range un composant, et non deux comportements.
Générer l’exemple
Vous pouvez construire cet exemple avec les commandes ci-dessous, ou le faire construire pour vous par votre assistant IA.
Écrivez l’exemple dans un nouveau dossier qui porte son nom :
aggrega scaffold --example module-boundary-routingElle affiche ensuite les prochaines commandes à exécuter. La première vous place dans le nouveau dossier :
cd module-boundary-routingBuild
Ce workspace ne contient aucun .aggrega-config.yaml, si bien que les entités de la bibliothèque standard sont résolues depuis le registre du hub, hub.aggrega.ai, et aucune option de catalogue n’est nécessaire ; --auto-pull écrit pendant le build le lockfile qui manque à un clone récent :
aggrega build --release release.yaml --auto-pullLes artefacts rendus atterrissent sous dist/. La cible Kubernetes rend des manifestes simples hors ligne — aucun pull de chart n’est requis.
Avec un assistant IA
Un assistant IA configuré avec les outils d’Aggrega peut faire de même : collez-lui ce prompt.
Utilisez uniquement les outils Aggrega et ne créez vous-même aucun dossier. Si le dossier de l’espace de travail ne contient pas encore de dossier `module-boundary-routing`, appelez une fois l’outil `scaffold` avec `example` défini sur `module-boundary-routing` et sans `dir` : il écrit l’exemple dans un nouveau dossier `module-boundary-routing`. Appelez ensuite l’outil `build` avec `workspace_root` défini sur `module-boundary-routing`, `release` défini sur `release.yaml`, `auto_pull` défini sur true et `write` défini sur true. Indiquez-moi quels fichiers le build a écrits ; ils se trouvent sous `module-boundary-routing/dist/`.À quoi ressemblent les stacks placées
Le directory de chaque frontière est la racine des artefacts pour tout ce qui y est placé, si bien que les composants des deux modules se séparent sur le disque selon la frontière qui les a routés :
dist/observability/helm/ metrics-zdobjstore, metrics-zdstore, metrics-zdquerydist/data/helm/ documents-zdproxy, documents-zdbackendLes noms de fichiers portent l’identité de chaque composant avec le séparateur de module écrit en toutes lettres, car un point n’est pas un caractère que tout nom de ressource peut contenir — metrics.store dans l’Aggregate est metrics-zdstore dans le cluster. Composer un module est la seule chose qui place un séparateur dans une identité, si bien qu’un composant que vous nommez directement s’écrit de la même façon aux deux endroits.
Chaque ressource porte le namespace de la frontière de routage et enregistre quelle frontière l’a placée. Le store gateway n’est jamais nommé dans l’entrée de routage et hérite pourtant des deux :
metadata: name: metrics-zdstore namespace: observability [… omitted: the labels every rendered document carries] annotations: aggrega.ai/boundary-path: observability [… omitted: the annotation naming the Recipe that rendered it]Il en va de même pour les quatre Secrets qu’émet la Feature d’informations d’identification du module de métriques pour la paire de clés du magasin d’objets et pour celle que lui présente le store gateway : chacun aboutit sous observability avec ce namespace, à côté de la charge de travail qui le lit.
La Feature de scrape rattachée au composant routé query rend son propre artefact sous cette même frontière, portant les paramètres de scrape de l’opérateur :
apiVersion: monitoring.coreos.com/v1kind: ServiceMonitormetadata: name: metrics-zdquery-scrape [… omitted: the namespace, labels and annotations every rendered document carries]spec: selector: matchLabels: app.kubernetes.io/name: metrics-zdquery endpoints: - port: http interval: 30s path: /metrics