Credenciais com várias chaves em um Deployment helm sintetizado
Um único app sem estado renderizado no Kubernetes pela síntese de Workload do provedor helm — sem chart externo. O app lê duas chaves de dados de um único segredo: um nome de usuário e uma senha. Um único slot de credencial sustenta as duas, preenchido por uma credencial referenciável com várias chaves.
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 multikey-secret-synthEm seguida ele imprime os próximos comandos a executar. O primeiro entra na pasta nova:
cd multikey-secret-synthBuild
aggrega build --release release.yaml --auto-pullO catálogo é resolvido a partir de duas origens nomeadas em .aggrega-config.yaml: o próprio ./catalog do exemplo (o Component local/compute/app e a sua Recipe synth helm/app) e o registro do hub (a Feature de credencial com várias chaves, a sua FeatureRecipe e o Provider helm). --auto-pull grava durante o build o lockfile que falta em um clone novo. Três manifestos ficam sob dist/helm/helm/.
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 `multikey-secret-synth`, chame a ferramenta `scaffold` uma vez com `example` definido como `multikey-secret-synth` e sem `dir`: ela grava o exemplo em uma nova pasta `multikey-secret-synth`. Depois chame a ferramenta `build` com `workspace_root` definido como `multikey-secret-synth`, `release` definido como `release.yaml`, `auto_pull` definido como true e `write` definido como true. Diga-me quais arquivos o build gravou; eles ficam em `multikey-secret-synth/dist/`.Um slot, duas chaves
O Component declara um slot de credencial transparente, app_credentials (inject: [env]). O Aggregate o preenche com core/referenced-secret-set — uma credencial referenciável com várias chaves que materializa um único Secret do Kubernetes que traz um conjunto de chaves de dados fornecido pelo chamador e publica apenas o localizador do Secret (provides.name). Aqui o chamador fornece duas chaves:
features: app_credentials: type: core/referenced-secret-set values: entries: - key: db_username value: appuser - key: db_password value: dev-pw-change-meO Manifest mapeia core/referenced-secret-set para a FeatureRecipe k8s-secret-set, que renderiza um único Secret que traz as duas chaves:
[… omitted: the apiVersion and the Secret kind]metadata: name: app-app-credentials [… omitted: the labels and annotations every rendered document carries]stringData: db_username: "appuser" db_password: "dev-pw-change-me"Referenciar um slot por cada chave
A Recipe synth referencia o mesmo slot duas vezes — uma por chave de dados. Cada entrada nomeia a chave de dados que lê por meio do campo key; a chave de mapa da entrada é o nome da variável de ambiente:
# helm/app recipe workloadattachments: APP_DB_USER: from: app_credentials as: env key: db_username APP_DB_PASSWORD: from: app_credentials as: env key: db_passwordO sintetizador renderiza um secretKeyRef de env por entrada. Ambos referenciam o mesmo Secret (provides.name), cada um com a sua própria chave de dados:
# app-deployment.yaml (container env)- name: APP_DB_USER valueFrom: secretKeyRef: name: app-app-credentials # == the Secret's metadata.name key: db_username- name: APP_DB_PASSWORD valueFrom: secretKeyRef: name: app-app-credentials # same Secret key: db_password # different data key[… omitted: the GREETING variable, set from the Aggregate's greeting value]O campo key é o que torna um segredo com várias chaves consumível a partir de um Workload sintetizado. Quando uma entrada omite key, ela lê em vez disso a única chave de dados publicada do slot — a forma que uma credencial de chave única (core/referenced-secret) usa, que publica tanto um localizador quanto uma chave.
Dimensionamento pelo operador
release.yaml preenche o pilar de dimensionamento do operador por ambiente: a tag da imagem do contêiner vem de infra.image_tag (myapp:1.2). O Aggregate do desenvolvedor nunca traz este campo.