Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Brasil)
Esta página foi traduzida automaticamente. Leia o original em inglês.

Memcached — um Aggregate, dois destinos e uma senha que é recusada

Este exemplo enxuto compila um único cache em memória Memcached a partir de um único Aggregate escrito pelo desenvolvedor para duas realizações:

  • Docker Compose para o desenvolvimento local, e
  • a Recipe helm sintetizada que executa a imagem upstream oficial memcached diretamente no Kubernetes (sem chart externo).

A Recipe helm sintetizada é o caminho preferido do Kubernetes: ela depende apenas de uma tag de imagem oficial em vez de um chart de terceiros, e o seu conjunto de recursos renderizado é exatamente o que a carga de trabalho declara.

O mesmo aggregate.yaml conduz ambas. Só muda por realização a camada de Recipe selecionada pelo Manifest. Mais dois Aggregates vinculam uma senha ao cache, e as suas Releases são exemplos negativos: o build é interrompido, porque nenhuma realização consegue impor uma senha do Memcached.

Arquivos

ArquivoPapel
aggregate.yamlIntenção do desenvolvedor: um componente cache do tipo core/datastore/memcached, sem credencial — o cache roda sem autenticação.
aggregate-auth.yamlO mesmo cache com uma credencial de senha inject-value vinculada ao slot opcional password do componente (caminho do Compose). O build dele é interrompido.
aggregate-helm-synth-auth.yamlO mesmo cache com uma credencial de senha referenciável vinculada para o caminho helm sintetizado. O build dele é interrompido.
manifest-compose.yamlMapeia o tipo Memcached para a Recipe do Compose (compose/memcached) e a credencial para dotenv-secret.
manifest-helm-synth.yamlMapeia o tipo Memcached para a Recipe helm sintetizada (helm/memcached) e a credencial para k8s-secret-from-parameter.
release-compose.yaml / release-helm-synth.yamlDocumentos do operador para as duas realizações.
release-negative-compose-auth.yaml / release-negative-helm-synth-auth.yamlDocumentos do operador sobre os dois Aggregates com senha. Espera-se que cada build falhe.

O que ele demonstra

  • Uma única superfície de autoria, muitos destinos. Um único Aggregate é a fonte da verdade sobre o que o stack é. Cada Manifest diz como realizá-lo.
  • Um armazenamento de dados sem estado. O Memcached mantém entradas na memória e não armazena nada de forma durável, então o componente é tipado como um simples server em vez de um stateful-server. No Kubernetes, a Recipe renderiza um Deployment, não um StatefulSet, e não solicita nenhum volume persistente; no Compose, o serviço não declara nenhum volume de dados.
  • Síntese de Workload (Kubernetes). A Recipe helm sintetizada declara um Workload — um Deployment mais um Service ClusterIP que executa a imagem oficial memcached — que o provedor helm traduz em manifestos do Kubernetes sem nenhum chart externo. O conjunto de recursos renderizado é exatamente o que o Workload declara. Como o nome memcached é usado tanto por uma Recipe do Compose quanto por uma helm sintetizada, os Manifests as referenciam com escopo de provedor como compose/memcached e helm/memcached.
  • Uma proteção que uma realização não pode dar é recusada, não descartada. O componente declara um slot opcional password. A imagem memcached não impõe nenhuma senha: os seus dois modos de autenticação são SASL, falado apenas sobre o protocolo binário, e um arquivo de autenticação ASCII, e os clientes Memcached do catálogo não usam nenhum dos dois. Uma Recipe que aceitasse a vinculação renderizaria um cache que responde a qualquer cliente enquanto o Aggregate diz que ele está protegido, então cada Recipe interrompe o build em vez disso, nomeando o slot.

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:

Terminal window
aggrega scaffold --example memcached-cache

Em seguida ele imprime os próximos comandos a executar. O primeiro entra na pasta nova:

Terminal window
cd memcached-cache

Build

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:

Terminal window
# Local development (Docker Compose)
aggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official image)
aggrega build --release release-helm-synth.yaml --auto-pull

Os artefatos renderizados ficam em dist/.

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 você mesmo. Se a pasta do workspace ainda não contiver uma pasta `memcached-cache`, chame a ferramenta `scaffold` uma vez com `example` definido como `memcached-cache` e sem `dir`: ela grava o exemplo em uma nova pasta `memcached-cache`. Depois chame a ferramenta `build` uma vez para cada Release, nesta ordem — `release-compose.yaml` e `release-helm-synth.yaml` —, cada vez com `workspace_root` definido como `memcached-cache`, `release` definido como esse arquivo, `auto_pull` definido como true e `write` definido como true. Diga-me quais arquivos cada build gravou; eles ficam em `memcached-cache/dist/`.

O controle: uma senha que o cache não consegue impor

As duas Releases negativas fazem o build dos Aggregates com senha, e espera-se que cada build falhe:

Terminal window
aggrega build --release release-negative-compose-auth.yaml --auto-pull
aggrega build --release release-negative-helm-synth-auth.yaml --auto-pull

Cada uma é interrompida na Recipe do Memcached, antes que qualquer coisa seja escrita, e a interrupção termina com a mensagem da própria Recipe:

a password is attached to the password slot of "cache", but the memcached
image this Recipe runs cannot enforce a password: it authenticates only through
SASL over the binary protocol or an ASCII authentication file, which the
catalog's Memcached clients do not use, so the cache would accept every client
anyway; remove the attachment, and restrict who can reach the cache through its
network

A recusa depende da própria vinculação, não de como a credencial é entregue, então toda Feature que pode preencher o slot é interrompida da mesma forma. As realizações gerenciadas se comportam da mesma maneira: o Amazon ElastiCache não oferece nenhuma autenticação do Memcached, e as suas Recipes também são interrompidas na vinculação. Um cache Memcached é, portanto, protegido por quem consegue alcançá-lo — a rede em que ele está colocado — e o aggregate.yaml base é a forma para fazer o build.