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

Memcached — um Aggregate, dois destinos e uma palavra-passe que é recusada

Este exemplo enxuto compila uma única cache em memória Memcached a partir de um único Aggregate escrito pelo programador em 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: 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, de realização para realização, a camada de Recipe selecionada pelo Manifest. Mais dois Aggregates anexam uma palavra-passe à cache, e as suas Releases são exemplos negativos: a compilação é interrompida, porque nenhuma realização consegue impor uma palavra-passe do Memcached.

Ficheiros

FicheiroPapel
aggregate.yamlIntenção do programador: um componente cache do tipo core/datastore/memcached, sem credencial — a cache funciona sem autenticação.
aggregate-auth.yamlA mesma cache com uma credencial de palavra-passe inject-value anexada ao slot opcional password do componente (caminho do Compose). A sua compilação é interrompida.
aggregate-helm-synth-auth.yamlA mesma cache com uma credencial de palavra-passe referenciável anexada para o caminho helm sintetizado. A sua compilação é interrompida.
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 palavra-passe. Espera-se que cada compilação falhe.

O que demonstra

  • Uma única superfície de autoria, muitos destinos. Um único Aggregate é a fonte de verdade sobre o que a stack é. Cada Manifest diz como realizá-la.
  • Um armazenamento de dados sem estado. O Memcached guarda entradas em memória e não armazena nada de forma duradoura, pelo que 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 pede 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 fornecedor 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 como por uma helm sintetizada, os Manifests referenciam-nas com âmbito de fornecedor 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 palavra-passe: os seus dois modos de autenticação são o SASL, falado apenas sobre o protocolo binário, e um ficheiro de autenticação ASCII, e os clientes Memcached do catálogo não usam nenhum dos dois. Uma Recipe que aceitasse o anexo renderizaria uma cache que responde a qualquer cliente enquanto o Aggregate diz que está protegida, pelo que cada Recipe interrompe antes a compilação, nomeando o slot.

Gerar o exemplo

É possível compilar este exemplo com os comandos abaixo, ou pedir ao assistente de IA que o compile.

Escreva o exemplo numa nova pasta com o nome dele:

Terminal window
aggrega scaffold --example memcached-cache

Depois, imprime os próximos comandos a executar. O primeiro entra na nova pasta:

Terminal window
cd memcached-cache

Compilação

Este workspace não contém nenhum .aggrega-config.yaml, pelo que as entidades da biblioteca standard são resolvidas a partir do registo do hub, hub.aggrega.ai, e não é necessária nenhuma flag de catálogo; --auto-pull escreve durante a compilação o lockfile que falta a um clone acabado de criar:

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 artefactos renderizados ficam em dist/.

Com um assistente de IA

Um assistente de IA configurado com as ferramentas do Aggrega pode fazer o mesmo: cole-lhe este prompt.

Utilize apenas as ferramentas do Aggrega e não crie nenhuma pasta por conta própria. Se a pasta da área de trabalho ainda não contiver uma pasta `memcached-cache`, chame uma vez a ferramenta `scaffold` com `example` definido como `memcached-cache` e sem `dir`: esta escreve o exemplo numa nova pasta `memcached-cache`. Em seguida, chame a ferramenta `build` uma vez para cada Release, por esta ordem — `release-compose.yaml` e `release-helm-synth.yaml` —, de cada vez com `workspace_root` definido como `memcached-cache`, `release` definido como esse ficheiro, `auto_pull` definido como true e `write` definido como true. Indique quais os ficheiros que cada compilação escreveu; encontram-se em `memcached-cache/dist/`.

O controlo: uma palavra-passe que a cache não consegue impor

As duas Releases negativas compilam os Aggregates com palavra-passe, e espera-se que cada compilação 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 de qualquer coisa ser 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 do próprio anexo, não da forma como a credencial é entregue, pelo que qualquer Feature que possa preencher o slot é interrompida da mesma forma. As realizações geridas comportam-se da mesma maneira: o Amazon ElastiCache não oferece nenhuma autenticação do Memcached, e as suas Recipes também são interrompidas no anexo. Uma cache Memcached é, portanto, protegida por quem a consegue alcançar — a rede em que está colocada — e o aggregate.yaml de base é a forma a compilar.