MariaDB no Kubernetes — helm sintetizado (StatefulSet), credenciais com dois slots
Uma única base de dados MariaDB renderizada no Kubernetes pela síntese de Workload do fornecedor helm — sem chart externo. O Component core/datastore/mariadb associa-se à Recipe helm/mariadb, que declara um Workload form: stateful; o fornecedor helm tradu-lo num StatefulSet, num Service ClusterIP, num Service headless (a identidade de rede estável do StatefulSet) e num volumeClaimTemplate para o diretório de dados.
O objetivo do exemplo é o modelo de credenciais com dois slots do MariaDB no destino helm sintetizado. Os dois slots de palavra-passe são entregues por mecanismos diferentes porque o Component os declara de forma diferente, e a Recipe liga cada um da forma que o seu slot exige.
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:
aggrega scaffold --example mariadb-helm-synthDepois, imprime os próximos comandos a executar. O primeiro entra na nova pasta:
cd mariadb-helm-synthCompilação
aggrega build --release release.yaml --auto-pullO catálogo resolve-se a partir do registo do hub nomeado em .aggrega-config.yaml, pelo que não é necessária nenhuma flag --catalog, e --auto-pull escreve durante a compilação o ficheiro de bloqueio que falta a um clone acabado de criar. São gerados quatro manifestos em 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 `mariadb-helm-synth`, chame uma vez a ferramenta `scaffold` com `example` definido como `mariadb-helm-synth` e sem `dir`: esta escreve o exemplo numa nova pasta `mariadb-helm-synth`. Em seguida, chame a ferramenta `build` com `workspace_root` definido como `mariadb-helm-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 `mariadb-helm-synth/dist/`.root_password — Black-Box, entregue pelo canal de injeção
root_password é um slot Black-Box: o featuresSchema do Component declara inject: [], pelo que a Recipe controla a entrega e o programador não a pode ditar. O Aggregate anexa core/secret-value, que o Manifest mapeia para env-secret. Essa FeatureRecipe coloca o valor no canal de injeção do componente sob a chave escolhida, e a Recipe lê-o como .context.inject.env.MARIADB_ROOT_PASSWORD, emitindo uma variável de ambiente simples do contentor:
# db-statefulset.yaml (container env)- name: MARIADB_ROOT_PASSWORD value: dev-root-pw-change-meUm slot Black-Box nunca é referenciado a partir do bloco attachments: de um contentor da carga de trabalho, e não é gerado nenhum recurso Secret do Kubernetes para ele — o valor chega ao contentor diretamente pelo canal de injeção.
user_password — transparente, entregue como Secret + secretKeyRef
user_password é um slot transparente (inject: [env, file]). O Aggregate anexa core/referenced-secret, que o Manifest mapeia para k8s-secret-from-parameter. Essa FeatureRecipe materializa um Secret do Kubernetes e publica a identidade do Secret como provides {name, key}. A Recipe referencia o slot através de containers.attachments, que o sintetizador renderiza como um secretKeyRef de env. O Secret gerado e a referência do contentor nomeiam o mesmo recurso porque ambos leem .features.user_password.provides.name — não há qualquer rederivação nem qualquer convenção sobre a qual os dois lados tenham de concordar. O nome publicado normaliza os carateres de sublinhado do nome do slot para hífenes, pelo que user_password se torna o nome de recurso válido do Kubernetes db-user-password. O nome do ficheiro que o contém é uma derivação separada e lê-se de outra forma: prefixa o componente e o nome do slot como as coordenadas próprias do anexo, codificadas para um alfabeto de nomes de ficheiro que admite apenas letras minúsculas e algarismos, pelo que o sublinhado aí aparece como um escape em vez de um hífen.
[… omitted: the apiVersion and the Secret kind]metadata: name: db-user-password [… omitted: the labels and annotations every rendered document carries]stringData: MARIADB_PASSWORD: "dev-user-pw-change-me"
# db-statefulset.yaml (container env)- name: MARIADB_PASSWORD valueFrom: secretKeyRef: name: db-user-password # == the Secret's metadata.name key: MARIADB_PASSWORD # == the Secret's data keyDeixar user_password por anexar também é válido: a Recipe recorre a um valor predefinido de desenvolvimento escrito inline (MARIADB_PASSWORD: apppass) e não é gerado nenhum Secret, pelo que uma implementação mínima continua a ser renderizada e executada.
Dimensionamento pelo operador
release.yaml satisfaz o pilar do dimensionamento pelo operador por ambiente: a tag da imagem do contentor vem de infra.engine_version (mariadb:11.4), e o pedido e a classe de armazenamento do volumeClaimTemplate vêm de infra.storage (5Gi, standard). O Aggregate do programador nunca contém estes campos.