Somente catálogo — MariaDB + Adminer sem escrever nenhuma entidade de plataforma
Este exemplo implanta um stack pequeno e real — um banco de dados MariaDB com uma interface web Adminer na frente — referenciando apenas entidades do catálogo da biblioteca padrão. Nenhum Component, Feature ou Recipe é escrito aqui: três arquivos YAML curtos encaminham tudo para entidades que o catálogo já traz.
É a menor superfície de autoria que o Aggrega oferece, e o primeiro contato natural com a linguagem. O exemplo irmão do nível authoring implanta o mesmo stack enquanto constrói a sua própria camada de catálogo — leia primeiro este exemplo para ver o que um catálogo pronto oferece a você, e depois aquele para aprender como a camada de baixo é feita.
Os três arquivos
aggregate.yaml— a intenção do desenvolvedor: o que o stack é. Dois componentes escolhidos do catálogo portype:, uma credencial obrigatória como vinculação que preenche um slot, e uma arestausesque conecta o banco de dados ao socketdatabasesdo Adminer.release.yaml— o atendimento por ambiente do operador: qual tamanho e onde. Os blocosinfra:(versão do mecanismo, tamanho do armazenamento, porta publicada) pertencem ao operador; o Aggregate nunca os traz.manifest.yaml— o roteamento do operador: qual Recipe realiza cada tipo neste destino. Veja abaixo por que as referências são qualificadas por provedor.
O que ele demonstra
- Components como referências de catálogo.
type: core/datastore/mariadbetype: core/devtool/adminersão toda a declaração de computação. O desenvolvedor escreve apenas os valores que os esquemas dos Component expõem — cada campo omitido recebe o valor padrão do seu esquema (compare as variáveis de ambiente de charset e collation da saída renderizada com o blocovalues:de uma linha que as produziu). - O String Pipe. O Component de catálogo do Adminer declara um uses-socket
databasesque aceita qualquer componente rotuladocomponent.aggrega.ai/type=stateful-server. A aresta do Aggregate injeta oprovides.hostda Recipe do banco de dados emADMINER_DEFAULT_SERVER. O compilador encaminha a string sem interpretá-la — neste destino ela é um nome de serviço do compose; a mesma aresta em um destino Kubernetes levaria o nome DNS de um Service. - O pilar das vinculações. O
featuresSchemado Component do banco de dados exige um slotroot_password, preenchido com a Featurecore/secret-valuedo catálogo. O slot é caixa-preta: a FeatureRecipe selecionada pelo Manifest controla a entrega, e o desenvolvedor não pode impô-la. - Roteamento de Recipe qualificado por Provider. O Manifest mapeia
core/datastore/mariadb:1.0.0paracompose/mariadb:1.0.0— qualificado por provedor — porque a biblioteca padrão traz uma Recipe mariadb sob mais de um provedor (entre eles compose e helm). É o mapeamento do operador que desfaz a ambiguidade do destino: uma referência simples, não qualificada, que corresponde à Recipe de mais de um provedor interrompe o build de forma explícita em vez de escolher uma silenciosamente. Mude o destino do stack reapontando esses mapeamentos; o Aggregate não muda.
Gerar o exemplo
Você pode fazer o build deste exemplo com os comandos abaixo, ou pedir ao seu assistente de IA que faça o build por você.
Escreva o exemplo em uma nova pasta com o nome dele:
aggrega scaffold --example catalog-onlyEm seguida ele imprime os próximos comandos a executar. O primeiro entra na pasta nova:
cd catalog-onlyBuild
A partir deste diretório, com as entidades do catálogo resolvidas a partir de hub.aggrega.ai, o registro padrão que .aggrega-config.yaml nomeia:
aggrega pull --release release.yamlaggrega build --release release.yamlO comando pull resolve cada entidade referenciada e a fixa em release.lock (identidade + digest do conteúdo; execute-o novamente para regenerar um lockfile desatualizado). Com um checkout do catálogo da biblioteca padrão (onde obter um), nomeie o seu diretório aggrega-catalog com --catalog nos dois comandos para ler as entidades de lá. O build lê esse lockfile — sem ele, o build é interrompido e nomeia os dois caminhos possíveis, o comando pull ou --auto-pull — e renderiza dist/compose/docker-compose.yaml. A Release escreve os seus componentes diretamente (sem bloco boundaries:), então o compilador os incorpora no escopo padrão sintetizado e emite de forma plana em dist/ — uma única fronteira, nenhum segmento de nome de fronteira no caminho.
Com um assistente de IA
Um assistente de IA configurado com as ferramentas do Aggrega pode fazer o mesmo: cole este prompt nele.
Use apenas as ferramentas do Aggrega e não crie nenhuma pasta você mesmo. Se a pasta do workspace ainda não contiver uma pasta `catalog-only`, chame a ferramenta `scaffold` uma única vez com `example` definido como `catalog-only` e sem `dir`: ela escreve o exemplo em uma nova pasta `catalog-only`. Em seguida, chame a ferramenta `build` com `workspace_root` definido como `catalog-only`, `release` definido como `release.yaml`, `auto_pull` definido como true e `write` definido como true. Diga-me quais arquivos o build escreveu; eles ficam em `catalog-only/dist/`.Leia a saída
O arquivo compose renderizado é onde a conexão se torna visível:
- o serviço
webtrazADMINER_DEFAULT_SERVER: db— oprovides.hostda Recipe do banco de dados (o nome do serviço do compose) entregue pela aresta uses; - a mesma aresta produziu
depends_on: [db]— topologia, não apenas strings; MARIADB_CHARACTER_SET_SERVEReMARIADB_COLLATION_SERVERdo serviçodbvêm de valores padrão do esquema que o Aggregate nunca menciona;image: mariadb:11.4e o mapeamento de porta8080:8080vêm dos blocosinfra:da Release — o pilar do operador, renderizado ao lado do pilar do desenvolvedor.
Execução
cd dist/composedocker compose up -dAbra http://localhost:8080: o campo do servidor vem preenchido com db. Faça login como root com a senha de desenvolvimento da vinculação do Aggregate (dev-root-pw-change-me — um placeholder a substituir em qualquer uso além do desenvolvimento local), banco de dados appdb.
Próximos passos
O nível authoring faz você construir por conta própria esta mesma camada de plataforma — os Components, as Recipes e as FeatureRecipes de credencial que este exemplo consumiu prontos — e compila um Aggregate para quatro destinos.