MariaDB no Kubernetes — helm sintetizado (StatefulSet), credenciais com dois slots
Um único banco de dados MariaDB renderizado no Kubernetes pela síntese de Workload do provedor helm — sem chart externo. O Component core/datastore/mariadb se associa à Recipe helm/mariadb, que declara um Workload form: stateful; o provedor helm o traduz em um StatefulSet, um Service ClusterIP, um Service headless (a identidade de rede estável do StatefulSet) e um 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 senha são entregues por mecanismos diferentes porque o Component os declara de forma diferente, e a Recipe liga cada um da maneira que o seu slot exige.
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:
aggrega scaffold --example mariadb-helm-synthEm seguida ele imprime os próximos comandos a executar. O primeiro entra na pasta nova:
cd mariadb-helm-synthBuild
aggrega build --release release.yaml --auto-pullO catálogo se resolve a partir do registro do hub nomeado em .aggrega-config.yaml, então nenhum flag --catalog é necessário, e --auto-pull grava durante o build o arquivo de bloqueio que falta a um clone recém-criado. Quatro manifestos são gerados em 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 `mariadb-helm-synth`, chame a ferramenta `scaffold` uma vez com `example` definido como `mariadb-helm-synth` e sem `dir`: ela grava o exemplo em uma nova pasta `mariadb-helm-synth`. Depois 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. Diga-me quais arquivos o build gravou; eles ficam 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: [], então a Recipe controla a entrega e o desenvolvedor não pode ditá-la. O Aggregate vincula 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 o lê como .context.inject.env.MARIADB_ROOT_PASSWORD, emitindo uma variável de ambiente simples do contêiner:
# 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 contêiner da carga de trabalho, e nenhum recurso Secret do Kubernetes é gerado para ele — o valor chega ao contêiner diretamente pelo canal de injeção.
user_password — transparente, entregue como Secret + secretKeyRef
user_password é um slot transparente (inject: [env, file]). O Aggregate vincula 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 por meio de containers.attachments, que o sintetizador renderiza como um secretKeyRef de env. O Secret gerado e a referência do contêiner nomeiam o mesmo recurso porque ambos leem .features.user_password.provides.name — não há nenhuma rederivação nem nenhuma convenção sobre a qual os dois lados precisem concordar. O nome publicado normaliza os sublinhados do nome do slot para hífens, então user_password se torna o nome de recurso válido do Kubernetes db-user-password. O nome de arquivo que o contém é uma derivação separada e se lê de outra forma: ele prefixa o componente e o nome do slot como as coordenadas próprias da vinculação, codificadas para um alfabeto de nomes de arquivo que admite apenas letras minúsculas e dígitos, então o sublinhado aparece ali 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 sem vínculo também é válido: a Recipe recorre a um valor padrão de desenvolvimento escrito inline (MARIADB_PASSWORD: apppass) e nenhum Secret é gerado, então uma implantação mínima ainda é renderizada e executada.
Dimensionamento pelo operador
release.yaml preenche o pilar do dimensionamento pelo operador por ambiente: a tag da imagem do contêiner vem de infra.engine_version (mariadb:11.4), e a solicitação e a classe de armazenamento do volumeClaimTemplate vêm de infra.storage (5Gi, standard). O Aggregate do desenvolvedor nunca contém esses campos.