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

Credenciais com várias chaves num Deployment helm sintetizado

Uma única aplicação sem estado renderizada no Kubernetes pela síntese de Workload do fornecedor helm — sem chart externo. A aplicação lê duas chaves de dados de um único segredo: um nome de utilizador e uma palavra-passe. Um único slot de credencial suporta ambas, preenchido por uma credencial referenciável com várias chaves.

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 multikey-secret-synth

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

Terminal window
cd multikey-secret-synth

Compilação

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 registo do hub (a Feature de credencial com várias chaves, a sua FeatureRecipe e o Provider helm). --auto-pull escreve durante a compilação o lockfile que falta a um clone acabado de criar. 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-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 `multikey-secret-synth`, chame uma vez a ferramenta `scaffold` com `example` definido como `multikey-secret-synth` e sem `dir`: esta escreve o exemplo numa nova pasta `multikey-secret-synth`. Em seguida, 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. Indique quais os ficheiros que a compilação escreveu; encontram-se em `multikey-secret-synth/dist/`.

Um slot, duas chaves

O Component declara um slot de credencial transparente, app_credentials (inject: [env]). O Aggregate preenche-o com core/referenced-secret-set — uma credencial referenciável com várias chaves que materializa um único Secret do Kubernetes com 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 com ambas as 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ê através 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, 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 como uma chave.

Dimensionamento pelo operador

release.yaml satisfaz o pilar de dimensionamento do operador por ambiente: a tag da imagem do contentor vem de infra.image_tag (myapp:1.2). O Aggregate do programador nunca traz este campo.