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

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 por type:, uma credencial obrigatória como anexo que preenche um slot, e uma aresta uses que liga a base de dados ao socket databases do Adminer.
  • release.yaml — o cumprimento por ambiente do operador: que tamanho e onde. Os blocos infra: (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/mariadb e type: core/devtool/adminer sã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 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 etiquetado component.aggrega.ai/type=stateful-server. A aresta do Aggregate injeta o provides.host da Recipe da base de dados em ADMINER_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 featuresSchema do Component da base de dados exige um slot root_password, preenchido com a Feature core/secret-value do 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.0 para compose/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:

Terminal window
aggrega scaffold --example catalog-only

Depois, imprime os próximos comandos a executar. O primeiro entra na nova pasta:

Terminal window
cd catalog-only

Compilaçã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:

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

O 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 web traz ADMINER_DEFAULT_SERVER: db — o provides.host da 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_SERVER e MARIADB_COLLATION_SERVER do serviço db vêm de valores predefinidos 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 programador.

Execução

Terminal window
cd dist/compose
docker compose up -d

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