Stack de Thanos — un nivel de lectura de métricas sobre almacenamiento de objetos, compuesto como módulo
Este ejemplo compila un stack pequeño y real — el nivel de lectura/consulta de un sistema de métricas Thanos — a manifiestos de Kubernetes sintetizados a partir de un único Aggregate escrito por el desarrollador.
El nivel de lectura no es un único componente. Es un módulo: un subagregado reutilizable que compone tres componentes de una sola carga de trabajo —
- un almacén de objetos compatible con S3 que guarda bloques históricos de métricas en un volumen y los sirve a través de la API de S3,
- un Store Gateway que lee esos bloques del almacén de objetos y los sirve a los querier a través de su StoreAPI, manteniendo solo una caché local efímera, y
- un front end Query que responde a PromQL y distribuye las solicitudes sobre la StoreAPI del Store Gateway, sin estado propio.
El módulo cablea sus propias aristas internas — el Store Gateway hacia el almacén de objetos, y Query hacia el Store Gateway — y exporta Query como su endpoint público query. El Aggregate de nivel superior importa el módulo por nombre y renderiza el stack compuesto; el operador dimensiona los componentes internos del módulo en la Release.
Archivos
| Archivo | Rol |
|---|---|
aggregate.yaml | Intención del desarrollador: importa el módulo del nivel de lectura de Thanos (core/thanos). |
manifest-helm-synth.yaml | Asigna los tipos almacén de objetos, Store Gateway y Query a sus Recipes helm synth, y la Feature de credenciales que el módulo vincula a la realización que emite un Secret a partir de cada uno de los dos parámetros de clave del módulo. |
release-helm-synth.yaml | Documento del operador para el destino Kubernetes. Dimensiona los componentes internos del módulo por sus ID con ámbito de módulo; todo lo que queda en los valores predeterminados del esquema se renderiza de forma autónoma. |
Requisito previo en tiempo de ejecución
Este módulo es solo el nivel de lectura/consulta. El almacén de objetos crea el bucket thanos del que lee el Store Gateway antes de empezar a servir, así que lo único que hay que proporcionar en tiempo de ejecución, fuera de los manifiestos renderizados, es un componente de escritura que produzca bloques de métricas. El nivel de lectura sirve bloques; no los crea. Un componente de escritura — un nivel Thanos Receive o una instancia de Prometheus con el sidecar de Thanos — debe enviar bloques de métricas al mismo bucket. Hasta que un componente de escritura haya subido bloques, el Store Gateway sirve un conjunto de resultados vacío.
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:
aggrega scaffold --example thanos-stackDespués imprime los comandos que hay que ejecutar a continuación. El primero entra en la carpeta nueva:
cd thanos-stackCompilació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:
aggrega build --release release-helm-synth.yaml --auto-pullLos 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 ninguna carpeta por tu cuenta. Si la carpeta del espacio de trabajo aún no contiene una carpeta `thanos-stack`, llama una vez a la herramienta `scaffold` con `example` establecido en `thanos-stack` y sin `dir`: escribe el ejemplo en una nueva carpeta `thanos-stack`. Luego llama a la herramienta `build` con `workspace_root` establecido en `thanos-stack`, `release` establecido en `release-helm-synth.yaml`, `auto_pull` establecido en true y `write` establecido en true. Dime qué archivos escribió la compilación; están en `thanos-stack/dist/`.Cómo es el stack compuesto
El Store Gateway se renderiza como un Deployment sin estado más un Service ClusterIP que expone su puerto gRPC de StoreAPI y su puerto HTTP. Su contenedor se inicia con thanos store y un único flag en línea --objstore.config cuyo valor es la sección S3 construida a partir del endpoint que publica el almacén de objetos — el nombre de su Service dentro del clúster y su puerto, con insecure: true porque ese endpoint se sirve sobre HTTP simple. Esa configuración selecciona la cadena de credenciales del SDK de AWS, así que no lleva ningún secreto; las dos mitades de la clave de acceso llegan como variables de entorno leídas de Secrets:
args: - store - --grpc-address - 0.0.0.0:10901 - --http-address - 0.0.0.0:10902 - --data-dir - /var/thanos/store - |- --objstore.config=type: S3 config: bucket: thanos endpoint: metrics-zdobjstore-default:8333 insecure: true aws_sdk_auth: true[… omitted: the container ports for the two addresses named in the args]env: - name: AWS_ACCESS_KEY_ID valueFrom: secretKeyRef: name: metrics-zdstore-s3.credential-id key: s3-access-key - name: AWS_SECRET_ACCESS_KEY valueFrom: secretKeyRef: name: metrics-zdstore-s3.credential key: s3-secret-key[… omitted: the container's resources and its liveness and readiness probes]Query se renderiza como un Deployment sin estado más un Service ClusterIP en su puerto HTTP. Su contenedor se inicia con thanos query y se conecta a la StoreAPI del Store Gateway en el endpoint compuesto a partir de la arista store:
args: - query - --http-address - 0.0.0.0:10902 - --grpc-address - 0.0.0.0:10901 - --endpoint - metrics-zdstore-default:10901El almacén de objetos se renderiza como un StatefulSet de SeaweedFS de una réplica con una solicitud de volumen montada en /data, un Service ClusterIP en el puerto S3, 8333, y el Service headless que nombra el StatefulSet. Un contenedor init crea el bucket thanos antes de que el servidor empiece a servir. La cuenta del servidor es el mismo par de claves, leído de dos Secrets propios, metrics-zdobjstore-access-key-id y metrics-zdobjstore-secret-access-key. Los cuatro Secrets se emiten junto a las cargas de trabajo, dos para las ranuras de clave del almacén de objetos y dos para el par de claves que lleva la conexión s3 del Store Gateway, cada uno con el valor predeterminado de desarrollo del módulo.
Lo que demuestra
- Composición como módulo. Una capacidad de varias cargas de trabajo — un nivel de lectura de métricas que en realidad es un almacén de objetos más un Store Gateway más un front end de consultas — se empaqueta como un subagregado que compone tres componentes de una sola carga de trabajo, no como un único componente monolítico. El módulo se importa por nombre y se reutiliza dondequiera que se necesite un nivel de lectura de Thanos.
- Reutilización de un backend incluido. El almacén de objetos es el componente
core/storage/s3-object-storede la biblioteca estándar, reutilizado tal cual; el nivel de lectura no añade ninguna lógica de almacenamiento propia. El Manifest selecciona su realización SeaweedFS, así que el almacén se ejecuta en el clúster junto al nivel de lectura. - Aristas internas dentro del módulo. El Store Gateway declara un uso del almacén de objetos y Query declara un uso del Store Gateway; el
endpointpublicado por el almacén de objetos y el host y el puerto publicados por el Store Gateway se canalizan hacia el consumidor en cada arista, y la Recipe de cada consumidor construye su dirección a partir de ellos. El compilador enruta las cadenas sin interpretarlas. - Un endpoint público. El módulo exporta Query como
query, el nombre público estable al que se conecta un consumidor — desacoplado de los nombres de los componentes internos del módulo. - Configuración sin secretos. La configuración del almacén de objetos selecciona la cadena de credenciales del SDK de AWS, así que la configuración renderizada no lleva ningún secreto; las credenciales fluyen solo como variables de entorno.
- Un par de claves compartido, tomado por referencia. El Store Gateway se autentica ante el almacén de objetos con la propia cuenta del almacén, así que ambos comparten un único par de claves. El módulo toma cada mitad como parámetro,
s3_access_keyys3_secret_key, y vincula la Feature de credencialescore/referenced-secretcon cada una dos veces: a las ranurasaccess_key_idysecret_access_keydel almacén de objetos, y comocredential_idycredentialde la conexión del Store Gateway al almacén de objetos, la conexión en la que el gateway las presenta. Cada carga de trabajo lee ambas de Secrets en lugar de llevarlas en línea. Como el módulo vincula esa Feature, el Manifest la asigna. Este ejemplo deja los parámetros en los valores predeterminados de desarrollo del módulo y asigna la Feature ak8s-secret-from-parameter, que emite un Secret que lleva cada valor, así que el stack funciona de forma autónoma. Para una Release que lleva tráfico real, el Aggregate declara parámetros propios y los pasa hacia abajo a través deaggregates.metrics.parameters, la Release los satisface, y el Manifest asigna la Feature ak8s-existing-secret, que lee cada parámetro como el nombre de un Secret que ya existe en el namespace. - Imágenes reproducibles. Cada componente fija una etiqueta de imagen explícita, así que los manifiestos renderizados hacen referencia a imágenes estables.