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

Instradamento dei moduli nei confini — collocare interi sotto-moduli nei confini

Questo esempio compila due capacità — un livello di lettura delle metriche Thanos su object storage e un database documentale che parla il protocollo di rete di MongoDB — a partire da un unico Aggregate scritto dallo sviluppatore, e colloca ciascuna in un proprio confine dalla Release.

Entrambe le capacità sono moduli: sotto-aggregati riutilizzabili che compongono ciascuno diversi componenti a carico di lavoro singolo e cablano i propri archi interni. L’Aggregate nomina i due moduli e nulla su dove vengono eseguiti. La Release colloca ciascun modulo intero con una voce aggregates: per confine — l’operatore decide dove viene eseguita una capacità senza tenere traccia, né ripetere, ciò che contiene.

File

FileRuolo
aggregate.yamlIntento dello sviluppatore: importa il modulo delle metriche (core/thanos) e il modulo di database documentale (core/ferretdb).
manifest.yamlMappa ogni tipo di componente che i due moduli apportano alla rispettiva Recipe helm synth, la Feature di credenziale che il modulo delle metriche associa alla realizzazione che emette un Secret da ciascuno dei due parametri di chiave del modulo, e la Feature di scrape alla sua FeatureRecipe.
release.yamlDocumento dell’operatore: instrada ciascun modulo nel proprio confine, dimensiona un componente di un modulo e gli associa la Feature di scrape.

Che cosa dimostra

  • Instradare un intero modulo in un confine. La voce aggregates: di un confine ha come chiave il nome del modulo nell’Aggregate. Colloca ogni componente che il modulo contiene, così gli artefatti emessi per tutti e tre i componenti delle metriche finiscono sotto il confine observability ed entrambi i componenti del database documentale sotto data.
  • Non nominare alcun componente è la forma principale. Il confine data instrada il modulo di database documentale con un semplice documents: {}. Ogni componente al suo interno viene collocato e assume i propri valori predefiniti di schema; alla Release serve il nome del modulo e nient’altro su di esso.
  • Configurare un componente instradato tramite il suo nome locale. Una voce di instradamento può anche configurare singoli componenti del modulo che instrada, indirizzati tramite il nome locale che ciascuno porta all’interno di quel modulo — query, non metrics.query, perché all’interno del modulo è l’unico nome che ha. Nominare un componente non dice nulla sugli altri: qui query viene dimensionato e riceve una destinazione di scrape, mentre l’object store e lo store gateway vengono instradati con i loro valori predefiniti.
  • Un componente instradato è un componente di quel confine. Eredita la cascata di annotazioni del confine come qualsiasi altro, ed è questo che dà a ogni risorsa di un modulo instradato il valore aggrega.ai/namespace del confine — compresi i componenti che la voce di instradamento non menziona mai.
  • L’instradamento è collocazione, non un diverso tipo di appartenenza. Un componente instradato senza dire nulla su di esso viene renderizzato come lo stesso componente nominato direttamente in quel confine con un corpo vuoto. Le due grafie sono due modi di dire dove sta un componente, non due comportamenti.

Generare l’esempio

Puoi eseguire la build di questo esempio con i comandi qui sotto, oppure farla eseguire al tuo assistente IA.

Scrivi l’esempio in una nuova cartella che porta il suo nome:

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

Poi stampa i prossimi comandi da eseguire. Il primo ti porta nella nuova cartella:

Terminal window
cd module-boundary-routing

Build

Questo workspace non contiene alcun .aggrega-config.yaml, quindi le entità della libreria standard vengono risolte dal registry dell’hub, hub.aggrega.ai, e non serve alcun flag di catalogo; --auto-pull scrive durante il build il lockfile che manca a un clone appena creato:

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

Gli artefatti renderizzati finiscono sotto dist/. Il target Kubernetes renderizza manifest semplici offline — non è richiesto alcun pull di chart.

Con un assistente AI

Un assistente IA configurato con gli strumenti di Aggrega può fare lo stesso: incolla questo prompt nell’assistente.

Usa solo gli strumenti di Aggrega e non creare tu alcuna cartella. Se la cartella del workspace non contiene ancora una cartella `module-boundary-routing`, chiama una volta lo strumento `scaffold` con `example` impostato su `module-boundary-routing` e senza `dir`: scrive l’esempio in una nuova cartella `module-boundary-routing`. Poi chiama lo strumento `build` con `workspace_root` impostato su `module-boundary-routing`, `release` impostato su `release.yaml`, `auto_pull` impostato su true e `write` impostato su true. Dimmi quali file ha scritto la build; si trovano in `module-boundary-routing/dist/`.

Come appaiono gli stack collocati

La directory di ciascun confine è la radice degli artefatti per tutto ciò che vi viene collocato, quindi i componenti dei due moduli si separano su disco in base al confine che li ha instradati:

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

I nomi dei file portano l’identità di ciascun componente con il separatore di modulo scritto per esteso, perché un punto non è un carattere che ogni nome di risorsa può contenere — metrics.store nell’Aggregate è metrics-zdstore nel cluster. Comporre un modulo è l’unica cosa che mette un separatore in un’identità, quindi un componente che nomini direttamente si scrive allo stesso modo in entrambi i posti.

Ogni risorsa porta il namespace del confine che la instrada e registra quale confine l’ha collocata. Lo store gateway non viene mai nominato nella voce di instradamento e li eredita comunque entrambi:

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 stesso vale per i quattro Secret che la Feature di credenziale del modulo delle metriche emette per la coppia di chiavi dell’object store e per quella che lo store gateway gli presenta: ciascuno finisce sotto observability con quel namespace, accanto al carico di lavoro che lo legge.

La Feature di scrape associata al componente instradato query renderizza un proprio artefatto sotto quello stesso confine, con le impostazioni di scrape dell’operatore:

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