Stack Thanos — uma camada de leitura de métricas sobre armazenamento de objetos, composta como módulo
Este exemplo compila um stack pequeno e real — a camada de leitura/consulta de um sistema de métricas Thanos — para manifestos do Kubernetes sintetizados a partir de um único Aggregate escrito pelo desenvolvedor.
A camada de leitura não é um componente único. É um módulo: um subagregado reutilizável que compõe três componentes de carga de trabalho única —
- um armazenamento de objetos compatível com S3 que guarda blocos históricos de métricas em um volume e os serve pela API S3,
- um Store Gateway que lê esses blocos do armazenamento de objetos e os serve aos querier pela sua StoreAPI, mantendo apenas um cache local efêmero, e
- um front-end Query que responde a PromQL e distribui as requisições pela StoreAPI do Store Gateway, sem estado próprio.
O módulo conecta as suas próprias arestas internas — o Store Gateway ao armazenamento de objetos, e Query ao Store Gateway — e exporta Query como o seu endpoint público query. O Aggregate de nível superior importa o módulo pelo nome e renderiza o stack composto; o operador dimensiona os componentes internos do módulo na Release.
Arquivos
| Arquivo | Papel |
|---|---|
aggregate.yaml | Intenção do desenvolvedor: importa o módulo da camada de leitura do Thanos (core/thanos). |
manifest-helm-synth.yaml | Mapeia os tipos armazenamento de objetos, Store Gateway e Query para as suas Recipes helm synth, e a Feature de credencial que o módulo vincula para a realização que emite um Secret a partir de cada um dos dois parâmetros de chave do módulo. |
release-helm-synth.yaml | Documento do operador para o destino Kubernetes. Dimensiona os componentes internos do módulo pelos seus IDs com escopo de módulo; tudo o que fica com os valores padrão do esquema é renderizado de forma autônoma. |
Pré-requisito em tempo de execução
Este módulo é apenas a camada de leitura/consulta. O armazenamento de objetos cria o bucket thanos do qual o Store Gateway lê antes de começar a servir, então a única coisa a fornecer em tempo de execução, fora dos manifestos renderizados, é um componente de escrita que produza blocos de métricas. A camada de leitura serve blocos; ela não os cria. Um componente de escrita — uma camada Thanos Receive ou uma instância do Prometheus com o sidecar do Thanos — precisa enviar blocos de métricas para o mesmo bucket. Até que um componente de escrita tenha enviado blocos, o Store Gateway serve um conjunto de resultados vazio.
Gerar o exemplo
Você pode fazer o build deste exemplo com os comandos abaixo, ou pedir ao seu assistente de IA que faça o build por você.
Escreva o exemplo em uma nova pasta com o nome dele:
aggrega scaffold --example thanos-stackEm seguida ele imprime os próximos comandos a executar. O primeiro entra na pasta nova:
cd thanos-stackBuild
Este workspace não traz nenhum .aggrega-config.yaml, então as entidades da biblioteca padrão são resolvidas a partir do registro do hub, hub.aggrega.ai, e nenhuma flag de catálogo é necessária; --auto-pull escreve durante o build o lockfile que falta a um clone novo:
aggrega build --release release-helm-synth.yaml --auto-pullOs artefatos renderizados ficam em dist/. O destino Kubernetes renderiza manifestos simples offline — nenhum pull de chart é necessário.
Com um assistente de IA
Um assistente de IA configurado com as ferramentas do Aggrega pode fazer o mesmo: cole este prompt nele.
Use somente as ferramentas do Aggrega e não crie nenhuma pasta por conta própria. Se a pasta do espaço de trabalho ainda não contiver uma pasta `thanos-stack`, chame uma vez a ferramenta `scaffold` com `example` definido como `thanos-stack` e sem `dir`: ela grava o exemplo em uma nova pasta `thanos-stack`. Em seguida, chame a ferramenta `build` com `workspace_root` definido como `thanos-stack`, `release` definido como `release-helm-synth.yaml`, `auto_pull` definido como true e `write` definido como true. Diga-me quais arquivos o build gravou; eles ficam em `thanos-stack/dist/`.Como fica o stack composto
O Store Gateway é renderizado como um Deployment sem estado mais um Service ClusterIP que expõe a sua porta gRPC da StoreAPI e a sua porta HTTP. O seu contêiner é iniciado com thanos store e um único flag inline --objstore.config cujo valor é a seção S3 construída a partir do endpoint que o armazenamento de objetos publica — o nome do seu Service interno ao cluster e a sua porta, com insecure: true porque esse endpoint é servido por HTTP simples. Essa configuração seleciona a cadeia de credenciais do SDK da AWS, então não traz nenhum segredo; as duas metades da chave de acesso chegam como variáveis de ambiente lidas 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 é renderizado como um Deployment sem estado mais um Service ClusterIP na sua porta HTTP. O seu contêiner é iniciado com thanos query e se conecta à StoreAPI do Store Gateway no endpoint composto a partir da aresta store:
args: - query - --http-address - 0.0.0.0:10902 - --grpc-address - 0.0.0.0:10901 - --endpoint - metrics-zdstore-default:10901O armazenamento de objetos é renderizado como um StatefulSet do SeaweedFS de uma réplica com uma solicitação de volume montada em /data, um Service ClusterIP na porta S3, 8333, e o Service headless que o StatefulSet nomeia. Um contêiner init cria o bucket thanos antes que o servidor comece a servir. A conta do servidor é o mesmo par de chaves, lido de dois Secrets próprios, metrics-zdobjstore-access-key-id e metrics-zdobjstore-secret-access-key. Os quatro Secrets são emitidos ao lado das cargas de trabalho, dois para os slots de chave do armazenamento de objetos e dois para o par de chaves que a conexão s3 do Store Gateway traz, cada um com o valor padrão de desenvolvimento do módulo.
O que ele demonstra
- Composição como módulo. Uma capacidade com várias cargas de trabalho — uma camada de leitura de métricas que na verdade é um armazenamento de objetos mais um Store Gateway mais um front-end de consultas — é empacotada como um subagregado que compõe três componentes de carga de trabalho única, e não como um único componente monolítico. O módulo é importado pelo nome e reutilizado onde quer que uma camada de leitura do Thanos seja necessária.
- Reutilização de um backend já incluído. O armazenamento de objetos é o componente
core/storage/s3-object-storeda biblioteca padrão, reutilizado tal como está; a camada de leitura não acrescenta nenhuma lógica de armazenamento própria. O Manifest seleciona a sua realização SeaweedFS, então o armazenamento roda no cluster ao lado da camada de leitura. - Arestas internas dentro do módulo. O Store Gateway declara um uso do armazenamento de objetos e Query declara um uso do Store Gateway; o
endpointpublicado pelo armazenamento de objetos e o host e a porta publicados pelo Store Gateway são repassados ao consumidor em cada aresta, e a Recipe de cada consumidor constrói o seu endereço a partir deles. O compilador roteia as strings sem interpretá-las. - Um endpoint público. O módulo exporta Query como
query, o nome público estável ao qual um consumidor se conecta — desacoplado dos nomes dos componentes internos do módulo. - Configuração sem segredos. A configuração do armazenamento de objetos seleciona a cadeia de credenciais do SDK da AWS, então a configuração renderizada não traz nenhum segredo; as credenciais fluem apenas como variáveis de ambiente.
- Um par de chaves compartilhado, tomado por referência. O Store Gateway se autentica no armazenamento de objetos com a própria conta do armazenamento, então os dois compartilham um único par de chaves. O módulo recebe cada metade como parâmetro,
s3_access_keyes3_secret_key, e vincula a Feature de credencialcore/referenced-secretcom cada uma duas vezes: aos slotsaccess_key_idesecret_access_keydo armazenamento de objetos, e comocredential_idecredentialda conexão do Store Gateway ao armazenamento de objetos, a conexão na qual o gateway as apresenta. Cada carga de trabalho lê ambas de Secrets em vez de trazê-las inline. Como o módulo vincula essa Feature, o Manifest a mapeia. Este exemplo deixa os parâmetros nos valores padrão de desenvolvimento do módulo e mapeia a Feature parak8s-secret-from-parameter, que emite um Secret que traz cada valor, então o stack roda de forma autônoma. Para uma Release que traz tráfego real, o Aggregate declara parâmetros próprios e os repassa para baixo viaaggregates.metrics.parameters, a Release os satisfaz, e o Manifest mapeia a Feature parak8s-existing-secret, que lê cada parâmetro como o nome de um Secret que já existe no namespace. - Imagens reproduzíveis. Cada componente fixa uma tag de imagem explícita, então os manifestos renderizados referenciam imagens estáveis.