Ir al contenido
AggregaAggrega
Seleccionar idioma: Español
Esta página se tradujo automáticamente. Lee el original en inglés.

Enrutamiento de módulos a límites — colocar submódulos completos en límites

Este ejemplo compila dos capacidades — un nivel de lectura de métricas de Thanos sobre almacenamiento de objetos y una base de datos documental que habla el protocolo de red de MongoDB — a partir de un único Aggregate escrito por el desarrollador, y coloca cada una en un límite propio desde la Release.

Ambas capacidades son módulos: subagregados reutilizables que componen cada uno varios componentes de una sola carga de trabajo y conectan sus propias aristas internas. El Aggregate nombra los dos módulos y nada sobre dónde se ejecutan. La Release coloca cada módulo completo con una entrada aggregates: por límite — el operador decide dónde se ejecuta una capacidad sin rastrear, ni repetir, lo que hay dentro de ella.

Archivos

ArchivoRol
aggregate.yamlIntención del desarrollador: importa el módulo de métricas (core/thanos) y el módulo de base de datos documental (core/ferretdb).
manifest.yamlAsigna cada tipo de componente que aportan los dos módulos a su Recipe helm synth, la Feature de credencial que vincula el módulo de métricas, a la realización que emite un Secret a partir de cada uno de los dos parámetros de clave del módulo, y la Feature de scrape a su FeatureRecipe.
release.yamlDocumento del operador: enruta cada módulo a su propio límite, dimensiona un componente de un módulo y le vincula la Feature de scrape.

Lo que demuestra

  • Enrutar un módulo completo a un límite. La entrada aggregates: de un límite tiene como clave el nombre del módulo en el Aggregate. Coloca cada componente que contiene el módulo, así que los artefactos emitidos para los tres componentes de métricas quedan bajo el límite observability y los dos componentes de la base de datos documental bajo data.
  • No nombrar ningún componente es la forma principal. El límite data enruta el módulo de base de datos documental con un simple documents: {}. Cada componente que contiene se coloca y toma sus propios valores predeterminados de esquema; la Release necesita el nombre del módulo y nada más sobre él.
  • Configurar un componente enrutado por su nombre local. Una entrada de enrutamiento también puede configurar componentes individuales del módulo que enruta, a los que se dirige por el nombre local que cada uno lleva dentro de ese módulo — query, no metrics.query, porque dentro del módulo es el único nombre que tiene. Nombrar un componente no dice nada de los demás: aquí query se dimensiona y recibe un destino de scrape, mientras que el almacén de objetos y el store gateway se enrutan con sus valores predeterminados.
  • Un componente enrutado es un componente de ese límite. Hereda la cascada de anotaciones del límite como cualquier otro, y eso es lo que da a cada recurso de un módulo enrutado el valor aggrega.ai/namespace del límite — incluidos los componentes que la entrada de enrutamiento nunca menciona.
  • El enrutamiento es colocación, no un tipo distinto de pertenencia. Un componente enrutado sin decir nada sobre él se renderiza igual que el mismo componente nombrado directamente en ese límite con un cuerpo vacío. Las dos escrituras son dos maneras de decir dónde está un componente, no dos comportamientos.

Generar el ejemplo

Puedes compilar este ejemplo con los comandos de abajo, o hacer que tu asistente de IA lo compile por ti.

Escribe el ejemplo en una carpeta nueva con su nombre:

Terminal window
aggrega scaffold --example module-boundary-routing

Después imprime los comandos que hay que ejecutar a continuación. El primero entra en la carpeta nueva:

Terminal window
cd module-boundary-routing

Compilación

Este workspace no lleva ningún .aggrega-config.yaml, así que las entidades de la biblioteca estándar se resuelven desde el registro del hub, hub.aggrega.ai, y no se necesita ningún flag de catálogo; --auto-pull escribe durante la compilación el lockfile que le falta a un clon recién creado:

Terminal window
aggrega build --release release.yaml --auto-pull

Los artefactos renderizados quedan en dist/. El destino Kubernetes renderiza manifiestos simples sin conexión — no se requiere ningún pull de chart.

Con un asistente de IA

Un asistente de IA configurado con las herramientas de Aggrega puede hacer lo mismo: pégale este prompt.

Usa solo las herramientas de Aggrega y no crees tú ninguna carpeta. Si la carpeta del espacio de trabajo aún no contiene una carpeta `module-boundary-routing`, llama una vez a la herramienta `scaffold` con `example` establecido en `module-boundary-routing` y sin `dir`: escribe el ejemplo en una nueva carpeta `module-boundary-routing`. Después llama a la herramienta `build` con `workspace_root` establecido en `module-boundary-routing`, `release` establecido en `release.yaml`, `auto_pull` establecido en true y `write` establecido en true. Dime qué archivos escribió la compilación; están en `module-boundary-routing/dist/`.

Cómo se ven los stacks colocados

El directory de cada límite es la raíz de artefactos de todo lo que se coloca en él, así que los componentes de los dos módulos se separan en disco según el límite que los enrutó:

dist/observability/helm/ metrics-zdobjstore, metrics-zdstore, metrics-zdquery
dist/data/helm/ documents-zdproxy, documents-zdbackend

Los nombres de archivo llevan la identidad de cada componente con el separador de módulo escrito explícitamente, porque un punto no es un carácter que todo nombre de recurso pueda contener — metrics.store en el Aggregate es metrics-zdstore en el clúster. Componer un módulo es lo único que pone un separador en una identidad, así que un componente que nombras directamente se escribe igual en ambos lugares.

Cada recurso lleva el namespace del límite que lo enruta y registra qué límite lo colocó. El store gateway nunca se nombra en la entrada de enrutamiento y aun así hereda ambos:

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]

Lo mismo vale para los cuatro Secrets que emite la Feature de credencial del módulo de métricas para el par de claves del almacén de objetos y el que le presenta el store gateway: cada uno queda bajo observability con ese namespace, junto a la carga de trabajo que lo lee.

La Feature de scrape vinculada al componente enrutado query renderiza su propio artefacto bajo ese mismo límite, con la configuración de scrape del operador:

apiVersion: monitoring.coreos.com/v1
kind: ServiceMonitor
metadata:
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