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

Solo catálogo — MariaDB + Adminer sin escribir ninguna entidad de plataforma

Este ejemplo despliega un stack pequeño y real — una base de datos MariaDB con una interfaz web Adminer delante — haciendo referencia solo a entidades del catálogo de la biblioteca estándar. Aquí no se escribe ningún Component, Feature ni Recipe: tres archivos YAML breves dirigen todo a entidades que el catálogo ya incluye.

Es la superficie de autoría más pequeña que ofrece Aggrega, y el primer contacto natural con el lenguaje. El ejemplo hermano del nivel authoring despliega el mismo stack mientras construye su propia capa de catálogo — lee primero este ejemplo para ver lo que te aporta un catálogo terminado, y luego aquel para aprender cómo está hecha la capa de debajo.

Los tres archivos

  • aggregate.yaml — la intención del desarrollador: qué es el stack. Dos componentes elegidos del catálogo por type:, una credencial obligatoria como vinculación que llena un slot, y una arista uses que conecta la base de datos al socket databases de Adminer.
  • release.yaml — el cumplimiento por entorno del operador: qué tamaño y dónde. Los bloques infra: (versión del motor, tamaño del almacenamiento, puerto publicado) pertenecen al operador; el Aggregate nunca los lleva.
  • manifest.yaml — el enrutamiento del operador: qué Recipe realiza cada tipo en este destino. Más abajo se explica por qué las referencias están calificadas por proveedor.

Lo que demuestra

  • Los Components como referencias al catálogo. type: core/datastore/mariadb y type: core/devtool/adminer son toda la declaración de cómputo. El desarrollador escribe solo los valores que exponen los esquemas de los Component — cada campo omitido toma el valor predeterminado de su esquema (compara las variables de entorno de charset y collation de la salida renderizada con el bloque values: de una sola línea que las produjo).
  • El String Pipe. El Component de catálogo de Adminer declara un uses-socket databases que acepta cualquier componente etiquetado component.aggrega.ai/type=stateful-server. La arista del Aggregate inyecta el provides.host de la Recipe de la base de datos en ADMINER_DEFAULT_SERVER. El compilador enruta la cadena sin interpretarla — en este destino es un nombre de servicio de compose; la misma arista en un destino Kubernetes llevaría el nombre DNS de un Service.
  • El pilar de las vinculaciones. El featuresSchema del Component de la base de datos requiere un slot root_password, llenado con la Feature core/secret-value del catálogo. El slot es de caja negra: la FeatureRecipe que selecciona el Manifest controla la entrega, y el desarrollador no puede imponerla.
  • Enrutamiento de Recipe calificado por Provider. El Manifest asigna core/datastore/mariadb:1.0.0 a compose/mariadb:1.0.0 — calificado por proveedor — porque la biblioteca estándar incluye una Recipe mariadb bajo más de un proveedor (entre ellos compose y helm). Es la asignación del operador la que desambigua el destino: una referencia simple, sin calificar, que coincide con la Recipe de más de un proveedor detiene la compilación de forma explícita en lugar de elegir una en silencio. Cambia el destino del stack redirigiendo estas asignaciones; el Aggregate no cambia.

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 catalog-only

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

Terminal window
cd catalog-only

Compilación

Desde este directorio, con las entidades del catálogo resueltas desde hub.aggrega.ai, el registro predeterminado que nombra .aggrega-config.yaml:

Terminal window
aggrega pull --release release.yaml
aggrega build --release release.yaml

El comando pull resuelve cada entidad referenciada y la fija en release.lock (identidad + digest del contenido; ejecútalo de nuevo para regenerar un lockfile desactualizado). Con un checkout del catálogo de la biblioteca estándar (dónde conseguir uno), nombra su directorio aggrega-catalog con --catalog en ambos comandos para leer las entidades desde ahí. La compilación lee ese lockfile — sin él, la compilación se detiene y nombra las dos vías posibles, el comando pull o --auto-pull — y renderiza dist/compose/docker-compose.yaml. La Release escribe sus componentes directamente (sin bloque boundaries:), así que el compilador los integra en el ámbito predeterminado sintetizado y emite en plano bajo dist/ — un solo límite, sin segmento de nombre de límite en la ruta.

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 ninguna carpeta tú mismo. Si la carpeta del espacio de trabajo aún no contiene una carpeta `catalog-only`, llama una sola vez a la herramienta `scaffold` con `example` establecido en `catalog-only` y sin `dir`: escribe el ejemplo en una nueva carpeta `catalog-only`. Después llama a la herramienta `build` con `workspace_root` establecido en `catalog-only`, `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 `catalog-only/dist/`.

Leer la salida

El archivo compose renderizado es donde el cableado se vuelve visible:

  • el servicio web lleva ADMINER_DEFAULT_SERVER: db — el provides.host de la Recipe de la base de datos (el nombre del servicio de compose) entregado a través de la arista uses;
  • la misma arista produjo depends_on: [db] — topología, no solo cadenas;
  • MARIADB_CHARACTER_SET_SERVER y MARIADB_COLLATION_SERVER del servicio db provienen de valores predeterminados del esquema que el Aggregate nunca menciona;
  • image: mariadb:11.4 y el enlace de puerto 8080:8080 provienen de los bloques infra: de la Release — el pilar del operador, renderizado junto al del desarrollador.

Ejecución

Terminal window
cd dist/compose
docker compose up -d

Abre http://localhost:8080: el campo del servidor viene rellenado con db. Inicia sesión como root con la contraseña de desarrollo de la vinculación del Aggregate (dev-root-pw-change-me — un marcador de posición que hay que sustituir en cualquier uso más allá del desarrollo local), base de datos appdb.

Adónde ir después

El nivel authoring te hace construir tú mismo esta misma capa de plataforma — los Components, las Recipes y las FeatureRecipes de credenciales que este ejemplo consumió ya hechos — y compila un Aggregate para cuatro destinos.