MySQL — un Aggregate, dos destinos
Este ejemplo mínimo compila una única base de datos MySQL a partir de Aggregate escritos por el desarrollador a dos destinos:
- Kubernetes mediante la síntesis de Workload del proveedor helm (un StatefulSet renderizado directamente sobre la imagen oficial
mysql, sin chart externo), y - Docker Compose para el desarrollo local.
La misma intención del desarrollador impulsa cada destino. Solo cambia por destino la capa de Recipe que selecciona el Manifest.
Archivos
| Archivo | Rol |
|---|---|
aggregate-helm-synth.yaml | Intención del desarrollador para la variante Kubernetes base: un componente db de tipo core/datastore/mysql, sus valores y solo la credencial obligatoria root_password. |
aggregate-helm-synth-auth.yaml | Intención del desarrollador para la variante Kubernetes completa: los dos slots de credencial, root_password y user_password. |
manifest-helm-synth.yaml | Asigna el tipo MySQL a la Recipe helm sintetizada (helm/mysql) y cada credencial a su FeatureRecipe (env-secret, k8s-secret-from-parameter). |
release-helm-synth.yaml | Documento del operador para la variante Kubernetes base, con el dimensionamiento operativo (engine_version, storage). |
release-helm-synth-auth.yaml | Documento del operador para la variante Kubernetes completa. |
aggregate.yaml | Intención del desarrollador para el destino Compose local: el mismo componente db con los dos slots de credencial entregados como credenciales inject-value. |
manifest-compose.yaml | Asigna el tipo MySQL a la Recipe de Compose (mysql) y la credencial a dotenv-secret. |
release-compose.yaml | Documento del operador para el destino Compose local, que incluye una entrada infra.overrides específica del proveedor que fija la imagen exacta del contenedor. |
Lo que demuestra
- Una única superficie de autoría, muchos destinos. Un Aggregate es la fuente de verdad sobre qué es el stack. Cada Manifest dice cómo realizarlo.
- Síntesis de Workload en Kubernetes (preferida). La Recipe
helm/mysqldeclara unWorkloadagnóstico respecto a las capacidades conform: stateful; el proveedor helm sintetiza un StatefulSet, un Service ClusterIP, un Service headless (la identidad de red estable del StatefulSet) y un volumeClaimTemplate para el directorio de datos. El entorno del contenedor llevaMYSQL_DATABASE,MYSQL_USER,MYSQL_ROOT_PASSWORDyMYSQL_PASSWORD. El juego de caracteres y la intercalación se respetan como argumentos de línea de comandos del servidormysqld(--character-set-server,--collation-server), porque la imagen oficialmysqllos acepta como flags del servidor en lugar de como variables de entorno. - Síntesis de Workload en Compose. La Recipe de Compose declara un
Workloadagnóstico respecto a las capacidades; el proveedor compose sintetiza un servicio dedocker-compose.yamlcon la imagen de MySQL, su entorno, un volumen de datos con nombre y una comprobación de estado. - Una vía de escape para el operador. La release de Compose establece
infra.overrides.image, el pilar abierto para los datos específicos del proveedor que el esquema propio del Component no nombra, y el servicio renderizado ejecuta exactamente esa referencia de imagen. Consulta Sobrescrituras específicas del Provider. - Modelo de credenciales de dos slots. Las contraseñas son vinculaciones en el pilar
features:del componente, cada una una Feature etiquetadafeature.aggrega.ai/kind: secret, separadas de losvaluesde la aplicación. ElfeaturesSchemadel Component declara un slot Black-Boxroot_passwordy un slot transparenteuser_password.
Entrega de credenciales en Kubernetes
root_password es un slot Black-Box (inject: []): la Recipe controla la entrega. La credencial inject-value vinculada pone el valor en el canal de inyección del componente, y la Recipe lo lee como .context.inject.env.MYSQL_ROOT_PASSWORD, emitiendo una variable de entorno simple del contenedor. No se genera ningún Secret de Kubernetes para él.
user_password es un slot transparente (inject: [env, file]). La variante completa vincula una credencial referenciable, que materializa un Secret de Kubernetes y publica su identidad; 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. Dejar user_password sin vincular (la variante base) también es válido: la Recipe recurre a un valor predeterminado de desarrollo escrito en línea (MYSQL_PASSWORD: apppass) y no se genera ningún Secret, así que un despliegue mínimo igualmente se renderiza y se ejecuta.
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 mysql-standaloneDespués imprime los comandos que hay que ejecutar a continuación. El primero entra en la carpeta nueva:
cd mysql-standaloneCompilación
Este workspace no lleva ningún .aggrega-config.yaml, así que las entidades de la biblioteca estándar se resuelven desde el registro del hub, hub.aggrega.ai, y no se necesita ningún flag de catálogo; --auto-pull escribe durante la compilación el lockfile que le falta a un clon recién creado:
# Kubernetes — synthesized helm StatefulSet (base: root credential only)aggrega build --release release-helm-synth.yaml --auto-pull
# Kubernetes — synthesized helm StatefulSet (full: both credential slots)aggrega build --release release-helm-synth-auth.yaml --auto-pull
# Local development (Docker Compose)aggrega build --release release-compose.yaml --auto-pullLos artefactos renderizados quedan en dist/.
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 `mysql-standalone`, llama una vez a la herramienta `scaffold` con `example` establecido en `mysql-standalone` y sin `dir`: escribe el ejemplo en una nueva carpeta `mysql-standalone`. Después llama a la herramienta `build` una vez por cada Release, en este orden — `release-helm-synth.yaml`, `release-helm-synth-auth.yaml` y `release-compose.yaml` —, cada vez con `workspace_root` establecido en `mysql-standalone`, `release` establecido en ese archivo, `auto_pull` establecido en true y `write` establecido en true. Dime qué archivos escribió cada compilación; están en `mysql-standalone/dist/`.Dimensionamiento por parte del operador
Las releases de Kubernetes cumplen el pilar del dimensionamiento por parte del operador para cada entorno: el tag de imagen del contenedor viene de infra.engine_version (mysql:8.4), y la solicitud y la clase de almacenamiento del volumeClaimTemplate vienen de infra.storage. El Aggregate del desarrollador nunca lleva estos campos.
Sobrescrituras específicas del Provider
Los pilares de dimensionamiento son campos con nombre: el Component declara engine_version y storage, así que un operador que establece cualquiera de ellos está rellenando un campo que el Component previó. infra.overrides es el pilar para lo que un Component no puede prever — se declara como un objeto que acepta cualquier estructura anidada, y cada Recipe documenta qué claves lee.
release-compose.yaml lo usa. La Recipe de Compose lee una clave, image, y cuando está establecida el contenedor ejecuta exactamente esa referencia en lugar de la que la Recipe compone a partir de engine_version:
infra: engine_version: "8.4" overrides: image: "registry.internal.example/library/mysql:8.4"El servicio renderizado lleva la sobrescritura tal cual:
services: db: image: registry.internal.example/library/mysql:8.4 [… omitted: the service's environment, labels, volume, network and health check]Esta es la ruta hacia una compilación de la misma versión del servidor replicada en un registro o fijada por digest — un dato de despliegue que pertenece al entorno de destino, no al contrato del Component. Como el conjunto de claves es por Recipe en lugar de por Component, la Recipe es el lugar donde mirar qué claves se aplican: aquí la Recipe de Compose lee image, y una Recipe que no lee ninguna lo indica.