Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Brasil)
Esta página foi traduzida automaticamente. Leia o original em inglês.

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 por type:, uma credencial obrigatória como vinculação que preenche um slot, e uma aresta uses que conecta o banco de dados ao socket databases do Adminer.
  • release.yaml — o atendimento por ambiente do operador: qual tamanho e onde. Os blocos infra: (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/mariadb e type: core/devtool/adminer sã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 bloco values: de uma linha que as produziu).
  • O String Pipe. O Component de catálogo do Adminer declara um uses-socket databases que aceita qualquer componente rotulado component.aggrega.ai/type=stateful-server. A aresta do Aggregate injeta o provides.host da Recipe do banco de dados em ADMINER_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 featuresSchema do Component do banco de dados exige um slot root_password, preenchido com a Feature core/secret-value do 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.0 para compose/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:

Terminal window
aggrega scaffold --example catalog-only

Em seguida ele imprime os próximos comandos a executar. O primeiro entra na pasta nova:

Terminal window
cd catalog-only

Build

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:

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

O 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 web traz ADMINER_DEFAULT_SERVER: db — o provides.host da 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_SERVER e MARIADB_COLLATION_SERVER do serviço db vêm de valores padrão do esquema que o Aggregate nunca menciona;
  • image: mariadb:11.4 e o mapeamento de porta 8080:8080 vêm dos blocos infra: da Release — o pilar do operador, renderizado ao lado do pilar do desenvolvedor.

Execução

Terminal window
cd dist/compose
docker compose up -d

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