Apenas catálogo — MariaDB + Adminer sem escrever nenhuma entidade de plataforma
Este exemplo implementa uma stack pequena e real — uma base de dados MariaDB com uma interface web Adminer à frente — referenciando apenas entidades do catálogo da biblioteca standard. Nenhum Component, Feature ou Recipe é escrito aqui: três ficheiros YAML curtos encaminham tudo para entidades que o catálogo já inclui.
É a menor superfície de autoria que o Aggrega oferece, e o primeiro contacto natural com a linguagem. O exemplo irmão do nível authoring implementa a mesma stack enquanto constrói a sua própria camada de catálogo — convém ler primeiro este exemplo para ver o que um catálogo acabado proporciona, e depois aquele para aprender como é feita a camada subjacente.
Os três ficheiros
aggregate.yaml— a intenção do programador: o que a stack é. Dois componentes escolhidos do catálogo portype:, uma credencial obrigatória como anexo que preenche um slot, e uma arestausesque liga a base de dados ao socketdatabasesdo Adminer.release.yaml— o cumprimento por ambiente do operador: que tamanho e onde. Os blocosinfra:(versão do motor, tamanho do armazenamento, porta publicada) pertencem ao operador; o Aggregate nunca os traz.manifest.yaml— o encaminhamento do operador: que Recipe realiza cada tipo neste destino. Mais abaixo explica-se porque é que as referências são qualificadas por fornecedor.
O que demonstra
- Os Components como referências de catálogo.
type: core/datastore/mariadbetype: core/devtool/adminersão toda a declaração de computação. O programador escreve apenas os valores que os esquemas dos Component expõem — cada campo omitido assume o valor predefinido do seu esquema (basta comparar 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 etiquetadocomponent.aggrega.ai/type=stateful-server. A aresta do Aggregate injeta oprovides.hostda Recipe da base de dados emADMINER_DEFAULT_SERVER. O compilador encaminha a string sem a interpretar — neste destino é um nome de serviço do compose; a mesma aresta num destino Kubernetes levaria o nome DNS de um Service. - O pilar dos anexos. O
featuresSchemado Component da base de dados exige um slotroot_password, preenchido com a Featurecore/secret-valuedo catálogo. O slot é caixa negra: a FeatureRecipe selecionada pelo Manifest controla a entrega, e o programador não a pode impor. - Encaminhamento de Recipe qualificado por Provider. O Manifest mapeia
core/datastore/mariadb:1.0.0paracompose/mariadb:1.0.0— qualificado por fornecedor — porque a biblioteca standard inclui uma Recipe mariadb sob mais de um fornecedor (entre eles compose e helm). É o mapeamento do operador que desfaz a ambiguidade do destino: uma referência simples, não qualificada, que corresponda à Recipe de mais de um fornecedor interrompe a compilação de forma explícita em vez de escolher uma em silêncio. Para mudar o destino da stack, basta reapontar estes mapeamentos; o Aggregate não muda.
Gerar o exemplo
É possível compilar este exemplo com os comandos abaixo, ou pedir ao assistente de IA que o compile.
Escreva o exemplo numa nova pasta com o nome dele:
aggrega scaffold --example catalog-onlyDepois, imprime os próximos comandos a executar. O primeiro entra na nova pasta:
cd catalog-onlyCompilação
A partir deste diretório, com as entidades do catálogo resolvidas a partir de hub.aggrega.ai, o registo predefinido que .aggrega-config.yaml nomeia:
aggrega pull --release release.yamlaggrega build --release release.yamlO comando pull resolve cada entidade referenciada e fixa-a em release.lock (identidade + digest do conteúdo; voltar a executá-lo regenera um lockfile desatualizado). Com um checkout do catálogo da biblioteca standard (onde obter um), indica-se o seu diretório aggrega-catalog com --catalog nos dois comandos para ler as entidades a partir daí. A compilação lê esse lockfile — sem ele, a compilação é interrompida 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:), pelo que o compilador os integra no âmbito predefinido 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-lhe este prompt.
Utilize apenas as ferramentas do Aggrega e não crie nenhuma pasta por si. Se a pasta do espaço de trabalho ainda não contiver uma pasta `catalog-only`, chame a ferramenta `scaffold` uma única vez com `example` definido como `catalog-only` e sem `dir`: esta escreve o exemplo numa 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 que ficheiros a compilação escreveu; encontram-se em `catalog-only/dist/`.Ler a saída
O ficheiro compose renderizado é onde a ligação se torna visível:
- o serviço
webtrazADMINER_DEFAULT_SERVER: db— oprovides.hostda Recipe da base de dados (o nome do serviço do compose) entregue através da 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 predefinidos 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 programador.
Execução
cd dist/composedocker compose up -dAo abrir http://localhost:8080, o campo do servidor aparece preenchido com db. Inicia-se sessão como root com a palavra-passe de desenvolvimento do anexo do Aggregate (dev-root-pw-change-me — um marcador de posição a substituir em qualquer utilização além do desenvolvimento local), base de dados appdb.
Próximos passos
O nível authoring leva a construir por conta própria esta mesma camada de plataforma — os Components, as Recipes e as FeatureRecipes de credencial que este exemplo consumiu já prontos — e compila um Aggregate para quatro destinos.