Ir al contenido
AggregaAggrega
Seleccionar idioma: Español
Esta página se tradujo automáticamente. Lee el original en inglés.

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

ArchivoRol
aggregate-helm-synth.yamlIntenció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.yamlIntención del desarrollador para la variante Kubernetes completa: los dos slots de credencial, root_password y user_password.
manifest-helm-synth.yamlAsigna 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.yamlDocumento del operador para la variante Kubernetes base, con el dimensionamiento operativo (engine_version, storage).
release-helm-synth-auth.yamlDocumento del operador para la variante Kubernetes completa.
aggregate.yamlIntenció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.yamlAsigna el tipo MySQL a la Recipe de Compose (mysql) y la credencial a dotenv-secret.
release-compose.yamlDocumento 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/mysql declara un Workload agnóstico respecto a las capacidades con form: 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 lleva MYSQL_DATABASE, MYSQL_USER, MYSQL_ROOT_PASSWORD y MYSQL_PASSWORD. El juego de caracteres y la intercalación se respetan como argumentos de línea de comandos del servidor mysqld (--character-set-server, --collation-server), porque la imagen oficial mysql los acepta como flags del servidor en lugar de como variables de entorno.
  • Síntesis de Workload en Compose. La Recipe de Compose declara un Workload agnóstico respecto a las capacidades; el proveedor compose sintetiza un servicio de docker-compose.yaml con 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 etiquetada feature.aggrega.ai/kind: secret, separadas de los values de la aplicación. El featuresSchema del Component declara un slot Black-Box root_password y un slot transparente user_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:

Terminal window
aggrega scaffold --example mysql-standalone

Después imprime los comandos que hay que ejecutar a continuación. El primero entra en la carpeta nueva:

Terminal window
cd mysql-standalone

Compilació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:

Terminal window
# 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-pull

Los 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.