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

MariaDB (chart Bitnami) — um único Secret de credenciais com várias chaves

Um único banco de dados MariaDB realizado pelo chart Helm da Bitnami, cujas senhas são fornecidas por um único segredo referenciável com várias chaves (core/referenced-secret-set).

O chart da Bitnami se autentica a partir de um único Secret do Kubernetes nomeado por auth.existingSecret, e espera que esse Secret contenha chaves de dados fixas — mariadb-root-password e, quando um usuário personalizado é definido, mariadb-password (uma implantação com replicação adiciona mariadb-replication-password). Não há nenhum ajuste para renomear essas chaves; elas são fixadas pelo chart.

Em vez de deixar a Recipe do banco de dados adivinhar o nome do Secret, o desenvolvedor vincula uma credencial com várias chaves que contém exatamente essas chaves fixas, e a Recipe lê o nome do Secret produzido em .features.root_password.provides.name. O nome da referência e o metadata.name do Secret gerado são um único valor — não há nenhuma rederivação nem nenhuma convenção sobre a qual os dois lados precisem concordar.

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 mariadb-bitnami-credential-set

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

Terminal window
cd mariadb-bitnami-credential-set

Build

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

--auto-pull grava durante o build o arquivo de bloqueio que falta a um clone recém-criado.

A Recipe mariadb-bitnami se resolve a partir da cópia local de catalog/ deste próprio exemplo — uma Recipe local com origem escrita pela empresa — enquanto o Component core/datastore/mariadb e as funcionalidades de credenciais se resolvem a partir de hub.aggrega.ai, o registro padrão que .aggrega-config.yaml nomeia; o catalog/ local está listado ali em catalog_dirs. O chart da Bitnami é baixado da sua origem OCI.

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 `mariadb-bitnami-credential-set`, chame a ferramenta `scaffold` uma vez com `example` definido como `mariadb-bitnami-credential-set` e sem `dir`: ela grava o exemplo em uma nova pasta `mariadb-bitnami-credential-set`. Depois chame a ferramenta `build` com `workspace_root` definido como `mariadb-bitnami-credential-set`, `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 `mariadb-bitnami-credential-set/dist/`.

O que a credencial produz

O componente db vincula core/referenced-secret-set ao seu slot obrigatório root_password, fornecendo como dados os nomes de chave fixos do chart. O Manifest mapeia essa credencial para k8s-secret-set, que materializa um único Secret do Kubernetes e publica o seu nome como provides.name:

dist/app/helm/db--root-zupassword--db-secret-db-root-password.yaml
[… omitted: the apiVersion and the Secret kind]
metadata:
name: db-root-password
[… omitted: the labels and annotations every rendered document carries]
stringData:
mariadb-root-password: "dev-root-pw-change-me"
mariadb-password: "dev-user-pw-change-me"

O que o chart referencia

A Recipe mariadb-bitnami liga auth.existingSecret a partir do nome publicado do slot, de modo que o StatefulSet renderizado monta o mesmo Secret que a credencial produziu — ambos os lados leem .features.root_password.provides.name:

# dist/app/helm/db-statefulset-default-db-mariadb.yaml (credential volume)
- name: mariadb-credentials
secret:
secretName: db-root-password # == the produced Secret's metadata.name
items:
- key: mariadb-root-password # a fixed key the chart reads
path: mariadb-root-password
- key: mariadb-password
path: mariadb-password

Como auth.existingSecret está definido, o chart não gera um Secret próprio — o único Secret no build é o que a credencial produziu.

A variante de chave única

core/referenced-secret (veja o exemplo credential-secretkeyref) é o membro de chave única da mesma família: ele encapsula uma chave de dados nomeada pelo chamador e publica tanto o nome do recurso quanto essa chave, para um consumidor que referencia uma chave por secretKeyRef. Use core/referenced-secret-set em vez dele quando o destino consumidor lê um conjunto fixo de chaves de um único Secret que ele nomeia como um todo, como faz o chart da Bitnami.