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
memcacheddiretamente 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
| Arquivo | Papel |
|---|---|
aggregate.yaml | Intenção do desenvolvedor: um componente cache do tipo core/datastore/memcached, sem credencial — o cache roda sem autenticação. |
aggregate-auth.yaml | O 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.yaml | O mesmo cache com uma credencial de senha referenciável vinculada para o caminho helm sintetizado. O build dele é interrompido. |
manifest-compose.yaml | Mapeia o tipo Memcached para a Recipe do Compose (compose/memcached) e a credencial para dotenv-secret. |
manifest-helm-synth.yaml | Mapeia o tipo Memcached para a Recipe helm sintetizada (helm/memcached) e a credencial para k8s-secret-from-parameter. |
release-compose.yaml / release-helm-synth.yaml | Documentos do operador para as duas realizações. |
release-negative-compose-auth.yaml / release-negative-helm-synth-auth.yaml | Documentos 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
serverem vez de umstateful-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 nomememcachedé usado tanto por uma Recipe do Compose quanto por uma helm sintetizada, os Manifests as referenciam com escopo de provedor comocompose/memcachedehelm/memcached. - Uma proteção que uma realização não pode dar é recusada, não descartada. O componente declara um slot opcional
password. A imagemmemcachednã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:
aggrega scaffold --example memcached-cacheEm seguida ele imprime os próximos comandos a executar. O primeiro entra na pasta nova:
cd memcached-cacheBuild
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:
# 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-pullOs 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:
aggrega build --release release-negative-compose-auth.yaml --auto-pullaggrega build --release release-negative-helm-synth-auth.yaml --auto-pullCada 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 memcachedimage this Recipe runs cannot enforce a password: it authenticates only throughSASL over the binary protocol or an ASCII authentication file, which thecatalog's Memcached clients do not use, so the cache would accept every clientanyway; remove the attachment, and restrict who can reach the cache through itsnetworkA 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.