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

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:

Terminal window
aggrega scaffold --example multikey-secret-synth

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

Terminal window
cd multikey-secret-synth

Build

Terminal window
aggrega build --release release.yaml --auto-pull

O 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:

aggregate.yaml
features:
app_credentials:
type: core/referenced-secret-set
values:
entries:
- key: db_username
value: appuser
- key: db_password
value: dev-pw-change-me

O Manifest mapeia core/referenced-secret-set para a FeatureRecipe k8s-secret-set, que renderiza um único Secret que traz as duas chaves:

app--app-zucredentials--app-secret-app-app-credentials.yaml
[… 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 workload
attachments:
APP_DB_USER:
from: app_credentials
as: env
key: db_username
APP_DB_PASSWORD:
from: app_credentials
as: env
key: db_password

O 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.