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

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

Uma única base de dados MariaDB realizada pelo chart Helm da Bitnami, cujas palavras-passe são fornecidas por um único segredo referenciável com várias chaves (core/referenced-secret-set).

O chart da Bitnami autentica-se 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 é definido um utilizador personalizado, mariadb-password (uma implementação com replicação acrescenta mariadb-replication-password). Não existe nenhum ajuste para mudar o nome dessas chaves; são fixadas pelo chart.

Em vez de deixar a Recipe da base de dados adivinhar o nome do Secret, o programador anexa 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á qualquer rederivação nem qualquer convenção sobre a qual os dois lados tenham de concordar.

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

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

Terminal window
cd mariadb-bitnami-credential-set

Compilação

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

--auto-pull escreve durante a compilação o ficheiro de bloqueio que falta a um clone acabado de criar.

A Recipe mariadb-bitnami resolve-se 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 registo predefinido que .aggrega-config.yaml nomeia; o catalog/ local está aí listado em catalog_dirs. O chart da Bitnami é transferido da sua origem OCI.

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 `mariadb-bitnami-credential-set`, chame uma vez a ferramenta `scaffold` com `example` definido como `mariadb-bitnami-credential-set` e sem `dir`: esta escreve o exemplo numa nova pasta `mariadb-bitnami-credential-set`. Em seguida, 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. Indique quais os ficheiros que a compilação escreveu; encontram-se em `mariadb-bitnami-credential-set/dist/`.

O que a credencial produz

O componente db anexa 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, pelo 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 na compilação é o que a credencial produziu.

A variante de chave única

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