Redis — um Aggregate, dois destinos, autenticação opcional
Este exemplo enxuto compila uma única cache em memória Redis (protocolo de rede do Redis) 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
redisdiretamente no Kubernetes (sem chart externo).
A Recipe helm sintetizada é o caminho 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. Um segundo Aggregate, aggregate-auth.yaml, mostra a mesma cache com uma credencial de palavra-passe opcional anexada para o caminho do Compose; aggregate-helm-synth-auth.yaml anexa uma credencial referenciável para o caminho helm sintetizado.
As Recipes do Redis do catálogo que este exemplo mapeia, compose/redis e helm/redis, declaram a licença AGPL-3.0. O exemplo valkey-cache implementa o Valkey, que fala o mesmo protocolo de rede; a sua Recipe helm/valkey declara BSD-3-Clause.
Ficheiros
| Ficheiro | Papel |
|---|---|
aggregate.yaml | Intenção do programador: um componente cache do tipo core/datastore/redis, sem credencial — a cache é executada sem autenticação. |
aggregate-auth.yaml | A mesma cache com uma credencial de palavra-passe anexada à ranhura opcional password do componente (caminho do Compose). |
aggregate-helm-synth-auth.yaml | A mesma cache com uma credencial referenciável anexada para o caminho helm sintetizado — o valor é materializado como um Secret do Kubernetes que o Deployment referencia. |
manifest-compose.yaml | Mapeia o tipo Redis para a Recipe do Compose (compose/redis) e a credencial para dotenv-secret. |
manifest-helm-synth.yaml | Mapeia o tipo Redis para a Recipe helm sintetizada (helm/redis) e a credencial para k8s-secret-from-parameter. |
release-compose.yaml / release-helm-synth.yaml | Documentos do operador para as duas realizações, sem autenticação. |
release-compose-auth.yaml / release-helm-synth-auth.yaml | Documentos do operador que ativam a autenticação. |
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 datastore no papel de cache. Aqui o Redis é usado como cache em memória e não guarda nada de forma durável, pelo que o componente é tipado como um simples
serverem vez de umstateful-server. No Kubernetes, a Recipe sintetizada 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
redis— 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 nomeredisé usado tanto por uma Recipe do Compose como por uma helm sintetizada, os Manifests referenciam-nas com âmbito de fornecedor comocompose/redisehelm/redis. - Autenticação opcional através de uma ranhura de credencial. O componente declara uma ranhura opcional
passwordno seufeaturesSchema. Quando nenhuma credencial está anexada (o Aggregate de base), a Recipe renderiza a cache com a autenticação desativada — de forma idêntica byte a byte a uma Recipe sem ranhura. Quando uma credencial está anexada, ambos os destinos iniciam o Redis com--requirepass, pelo que o servidor exige a palavra-passe: no Compose (aggregate-auth.yaml) o valor é passado ao servidor como esse argumento; no caminho sintetizado do Kubernetes (aggregate-helm-synth-auth.yaml) é materializado como um Secret que o Deployment referencia.
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:
aggrega scaffold --example redis-cacheDepois, imprime os próximos comandos a executar. O primeiro entra na nova pasta:
cd redis-cacheCompilaçã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:
# Local development (Docker Compose), no authenticationaggrega build --release release-compose.yaml --auto-pull
# Kubernetes (synthesized helm Recipe, official image), no authenticationaggrega build --release release-helm-synth.yaml --auto-pull
# The same realizations with authentication enabledaggrega build --release release-compose-auth.yaml --auto-pullaggrega build --release release-helm-synth-auth.yaml --auto-pullOs 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.
Use apenas as ferramentas do Aggrega e não crie nenhuma pasta por iniciativa própria. Se a pasta Workspace ainda não contiver uma pasta `redis-cache`, chame uma vez a ferramenta `scaffold` com `example` definido como `redis-cache` e sem `dir`: esta escreve o exemplo numa nova pasta `redis-cache`. Em seguida, chame a ferramenta `build` uma vez para cada Release, por esta ordem — `release-compose.yaml`, `release-helm-synth.yaml`, `release-compose-auth.yaml` e `release-helm-synth-auth.yaml` — de cada vez com `workspace_root` definido como `redis-cache`, `release` definido como esse ficheiro, `auto_pull` definido como true e `write` definido como true. Indique-me que ficheiros cada compilação escreveu; encontram-se em `redis-cache/dist/`.Nota sobre a entrega da credencial
No caminho do Compose, a credencial é um segredo inject-value (aggregate-auth.yaml): o seu valor é entregue no pipe de ambiente do componente sob a variável que o seu values.key nomeia, REDIS_PASSWORD, e a Recipe passa-o ao servidor como --requirepass. A imagem oficial redis não lê nenhuma variável de palavra-passe, pelo que o valor é passado como argumento e aparece no comando do serviço. Um anexo cujo valor não chega à Recipe sob nenhuma variável que ela leia interrompe a compilação, nomeando a ranhura, em vez de deixar a cache aberta.
O caminho helm sintetizado usa uma credencial referenciável (aggregate-helm-synth-auth.yaml): o valor é materializado como um Secret do Kubernetes, o Deployment referencia-o através de um secretKeyRef de ambiente, e o Redis é iniciado com --requirepass a ler essa variável de ambiente. Por isso, a palavra-passe em texto simples nunca aparece no manifesto do Deployment — apenas no Secret. É isto que ativa realmente a autenticação na imagem oficial redis, que por si só não lê uma palavra-passe do ambiente.
O valor origin nos Aggregates autenticados é um marcador de posição de desenvolvimento; forneça um valor real através da sua fonte de credenciais em qualquer implementação real.