MariaDB en Kubernetes — helm sintetizado (StatefulSet), credenciales de dos slots
Una única base de datos MariaDB renderizada en Kubernetes por la síntesis de Workload del proveedor helm — sin chart externo. El Component core/datastore/mariadb se enlaza con la Recipe helm/mariadb, que declara un Workload form: stateful; el proveedor helm lo traduce en un StatefulSet, un Service ClusterIP, un Service headless (la identidad de red estable del StatefulSet) y un volumeClaimTemplate para el directorio de datos.
El propósito del ejemplo es el modelo de credenciales de dos slots de MariaDB en el destino helm sintetizado. Los dos slots de contraseña se entregan mediante mecanismos distintos porque el Component los declara de forma distinta, y la Recipe conecta cada uno como su slot exige.
Generar el ejemplo
Puedes compilar este ejemplo con los comandos de abajo, o hacer que tu asistente de IA lo compile por ti.
Escribe el ejemplo en una carpeta nueva con su nombre:
aggrega scaffold --example mariadb-helm-synthDespués imprime los comandos que hay que ejecutar a continuación. El primero entra en la carpeta nueva:
cd mariadb-helm-synthCompilación
aggrega build --release release.yaml --auto-pullEl catálogo se resuelve desde el registro del hub nombrado en .aggrega-config.yaml, así que no hace falta ningún flag --catalog, y --auto-pull escribe durante la compilación el archivo de bloqueo que le falta a un clon nuevo. Cuatro manifiestos quedan en dist/helm/helm/.
Con un asistente de IA
Un asistente de IA configurado con las herramientas de Aggrega puede hacer lo mismo: pégale este prompt.
Usa solo las herramientas de Aggrega y no crees tú ninguna carpeta. Si la carpeta del espacio de trabajo aún no contiene una carpeta `mariadb-helm-synth`, llama una vez a la herramienta `scaffold` con `example` establecido en `mariadb-helm-synth` y sin `dir`: escribe el ejemplo en una nueva carpeta `mariadb-helm-synth`. Después llama a la herramienta `build` con `workspace_root` establecido en `mariadb-helm-synth`, `release` establecido en `release.yaml`, `auto_pull` establecido en true y `write` establecido en true. Dime qué archivos escribió la compilación; están en `mariadb-helm-synth/dist/`.root_password — Black-Box, entregada por el canal de inyección
root_password es un slot Black-Box: el featuresSchema del Component declara inject: [], así que la Recipe controla la entrega y el desarrollador no puede imponerla. El Aggregate vincula core/secret-value, que el Manifest asigna a env-secret. Esa FeatureRecipe pone el valor en el canal de inyección del componente bajo la clave elegida, y la Recipe lo lee como .context.inject.env.MARIADB_ROOT_PASSWORD, emitiendo una variable de entorno simple del contenedor:
# db-statefulset.yaml (container env)- name: MARIADB_ROOT_PASSWORD value: dev-root-pw-change-meUn slot Black-Box nunca se referencia desde el bloque attachments: de un contenedor de la carga de trabajo, y no se genera ningún recurso Secret de Kubernetes para él — el valor llega al contenedor directamente a través del canal de inyección.
user_password — transparente, entregada como Secret + secretKeyRef
user_password es un slot transparente (inject: [env, file]). El Aggregate vincula core/referenced-secret, que el Manifest asigna a k8s-secret-from-parameter. Esa FeatureRecipe materializa un Secret de Kubernetes y publica la identidad del Secret como provides {name, key}. La Recipe referencia el slot mediante containers.attachments, que el sintetizador renderiza como un secretKeyRef de env. El Secret generado y la referencia del contenedor nombran el mismo recurso porque ambos leen .features.user_password.provides.name — no hay rederivación ni convención alguna en la que las dos partes deban ponerse de acuerdo. El nombre publicado normaliza los guiones bajos del nombre del slot a guiones, así que user_password se convierte en el nombre de recurso de Kubernetes válido db-user-password. El nombre de archivo que lo lleva es una derivación separada y se lee de otra forma: antepone el componente y el nombre del slot como coordenadas propias de la vinculación, codificadas para un alfabeto de nombres de archivo que solo admite letras minúsculas y dígitos, así que el guion bajo aparece ahí como un escape en lugar de como un guion.
[… 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 keyDejar user_password sin vincular también es válido: la Recipe recurre a un valor predeterminado de desarrollo escrito en línea (MARIADB_PASSWORD: apppass) y no se genera ningún Secret, así que un despliegue mínimo igualmente se renderiza y se ejecuta.
Dimensionamiento por parte del operador
release.yaml cumple el pilar del dimensionamiento por parte del operador para cada entorno: el tag de imagen del contenedor viene de infra.engine_version (mariadb:11.4), y la solicitud y la clase de almacenamiento del volumeClaimTemplate vienen de infra.storage (5Gi, standard). El Aggregate del desarrollador nunca lleva estos campos.