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 portype:, una credencial obligatoria como vinculación que llena un slot, y una aristausesque conecta la base de datos al socketdatabasesde Adminer.release.yaml— el cumplimiento por entorno del operador: qué tamaño y dónde. Los bloquesinfra:(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/mariadbytype: core/devtool/adminerson 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 bloquevalues:de una sola línea que las produjo). - El String Pipe. El Component de catálogo de Adminer declara un uses-socket
databasesque acepta cualquier componente etiquetadocomponent.aggrega.ai/type=stateful-server. La arista del Aggregate inyecta elprovides.hostde la Recipe de la base de datos enADMINER_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
featuresSchemadel Component de la base de datos requiere un slotroot_password, llenado con la Featurecore/secret-valuedel 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.0acompose/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:
aggrega scaffold --example catalog-onlyDespués imprime los comandos que hay que ejecutar a continuación. El primero entra en la carpeta nueva:
cd catalog-onlyCompilación
Desde este directorio, con las entidades del catálogo resueltas desde hub.aggrega.ai, el registro predeterminado que nombra .aggrega-config.yaml:
aggrega pull --release release.yamlaggrega build --release release.yamlEl 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
webllevaADMINER_DEFAULT_SERVER: db— elprovides.hostde 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_SERVERyMARIADB_COLLATION_SERVERdel serviciodbprovienen de valores predeterminados del esquema que el Aggregate nunca menciona;image: mariadb:11.4y el enlace de puerto8080:8080provienen de los bloquesinfra:de la Release — el pilar del operador, renderizado junto al del desarrollador.
Ejecución
cd dist/composedocker compose up -dAbre 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.