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

Roteiro do Aggrega

De onde vem o Aggrega e para onde vai, em grandes passos. Os marcos 0 a 3 descrevem o que o compilador e o seu catálogo fazem hoje; o marco 4 e as direções que se lhe seguem descrevem o trabalho que há pela frente. Esta página não indica datas. O que funciona hoje, superfície a superfície, encontra-se em Estado da linguagem.

Marco 0 — Um protótipo

Um primeiro protótipo compilava documentos YAML, através de um grafo intermédio, em saída Helm e mostrou que a abordagem se sustenta. O compilador que se seguiu foi escrito em torno do modelo de entidades descrito abaixo.

Marco 1 — O núcleo do compilador

  • O modelo de entidades. Os programadores descrevem uma aplicação num Aggregate. As equipas de plataforma fornecem os Components e as Features que este utiliza e as Recipes e FeatureRecipes que os concretizam num destino; um Manifest associa cada tipo à sua Recipe, e uma Release coloca o Aggregate num ambiente.
  • O pipeline de compilação. A resolução, a construção da topologia, a finalização do grafo, a análise estática e a renderização transformam os documentos num grafo intermédio de componentes e das ligações uses entre eles, e depois em ficheiros.
  • O contrato de injeção. Um componente publica os seus valores de ligação através de provides, e o compilador encaminha-os para cada consumidor através de inject, entre namespaces, sem que o programador escreva um nome de anfitrião.
  • Parâmetros por ambiente. Um Aggregate expõe parâmetros, e cada Release preenche-os para o seu ambiente.
  • Manifestos do Kubernetes e charts do Helm, escritos por fronteira, com aggrega build e aggrega inspect.

Marco 2 — Um pipeline completo

  • Features que renderizam recursos, e credenciais como Features. Uma Feature anexada pode renderizar recursos próprios, e uma credencial é uma Feature como qualquer outra, entregue ao seu componente como variável de ambiente ou como ficheiro.
  • Docker Compose, com uma ponte que retransmite ligações entre redes do Compose.
  • Três formas de escrever uma Recipe, que se combinam: encapsular um chart, módulo ou ficheiro existente (source:), descrever um contentor uma única vez como um Workload que o destino sintetiza (workload:), ou emitir ficheiros próprios (artifacts:).
  • Saída determinística. A ordem do autor é mantida em todo o lado, pelo que uma entrada idêntica produz uma saída idêntica byte a byte.
  • Uma única linguagem de esquema. JSON Schema 2020-12, com uma notação abreviada compacta em YAML, bibliotecas reutilizáveis de esquemas e de mapeamentos, contratos de parâmetros tipados e asserções entre campos.
  • Features anexadas por anotação. Uma Release ou um Aggregate anexa uma Feature escrevendo uma anotação que o Manifest associa, com a mesma saída que anexá-la explicitamente.
  • aggrega build --trace, que escreve o estado intermédio de cada componente para depuração.

Marco 3 — A versão 0.9.0

O que a 0.9.0 acrescenta:

  • Cinco destinos, renderizados por plugins. Os manifestos do Kubernetes, os charts do Helm, o Docker Compose, o Terraform e o CloudFormation são escritos, cada um, por um plugin de fornecedor WebAssembly incorporado no binário, pelo que uma instalação nova renderiza offline; o compilador escreve os ficheiros e nunca executa as ferramentas. O form de um Workload escolhe o controlador em que este se transforma: sem estado, com estado, daemon, agendado ou uma tarefa pontual.
  • Plugins para tudo o que é específico de um domínio. Providers, políticas, importadores, passos de pipeline e extensões da linha de comandos são plugins WebAssembly, escritos com os kits de plugins para Go, Rust e TypeScript. O anfitrião e o plugin trocam dados através de uma única interface versionada codificada em CBOR, gerada a partir de um único esquema para as três linguagens.
  • Governação. Um plugin de políticas anexado a um espaço de trabalho verifica cada build: rejeita um grafo ou um ficheiro renderizado que viole uma regra, indicando o que corrigir, ou fornece etiquetas e anotações que um programador nunca escreve.
  • Registos, ficheiros de bloqueio e assinatura. As entidades do catálogo, Aggregates incluídos, são publicadas em registos OCI e obtidas a partir deles por nome e versão; aggrega pull fixa cada dependência num ficheiro de bloqueio, e os artefactos são assinados na publicação e verificados na obtenção.
  • O catálogo da biblioteca padrão e o seu hub público. Components para agentes, modelos, gateways, armazenamentos de dados, mensagens, observabilidade, segurança e armazenamento, organizados por etiquetas de tipo, categoria e capacidade e servidos a partir de hub.aggrega.ai.
  • aggrega import. Os plugins de importação elaboram rascunhos de ficheiros Aggrega a partir de projetos Langflow, Flowise, n8n, Dify, CrewAI, LangGraph, Google ADK, Microsoft Agent Framework, MCP e Docker Compose, pontuando cada mapeamento em relação ao catálogo; --sync mantém os rascunhos sincronizados com a sua origem.
  • Um início suave. Uma Release ou um Aggregate com um único âmbito não precisa de fronteiras nem de subsistemas, e aggrega scaffold, aggrega edit-document, aggrega validate, aggrega lint e aggrega explain apoiam o ciclo de criação.
  • O editor e o assistente. A extensão para Visual Studio Code traz validação, navegação, hover, preenchimento automático e um grafo de topologia ao YAML do Aggrega através de aggrega serve; aggrega mcp e a skill do Aggrega dão as mesmas ferramentas a um assistente de IA.
  • Instalação com um único comando no Linux, no macOS e no Windows, ou através do Homebrew, do Scoop e do winget.

Marco 4 — Adoção pelos utilizadores, mais nuvens e um catálogo maior

  • Adoção pelos utilizadores. O que os utilizadores nos dizem decide a ordem do trabalho: o que facilitar a sua adoção vem primeiro.
  • Fornecedores para Azure e Google Cloud.
  • Um catálogo maior. Mais componentes, e Recipes para todos os destinos, incluindo concretizações em Terraform e CloudFormation dos componentes base.
  • Um núcleo formalmente verificado. As propriedades centrais do compilador demonstradas como teoremas em Lean: uma entrada idêntica produz uma saída idêntica, nada é emitido que não tenha sido declarado, e cada valor de ligação chega exatamente aos consumidores que as suas ligações uses nomeiam. Testes baseados em propriedades cobrem os plugins incorporados.

Outras direções

  • Uma vista em tempo real da sua arquitetura. O grafo de topologia do editor e --ir-graph já mostram o grafo que o compilador resolveu; um modo de streaming enviaria esse grafo à medida que muda, para que um frontend acompanhe cada edição no momento em que acontece.
  • Workloads em serviços de contentores geridos. Um Workload descrito uma única vez é sintetizado para os serviços de contentores geridos dos destinos na nuvem, como Amazon ECS e Fargate, Google Cloud Run e Azure Container Apps.
  • Mais formatos a importar. Especificações OpenAPI, para uma API que uma aplicação chama ou serve, e ficheiros de workload do Score.
  • Uma Recipe esboçada a partir do seu Component. Uma Recipe inicial que já lê os valores do Component e entrega os seus valores de ligação, para a equipa de plataforma completar.
  • Templates que alteram a forma de um documento por ambiente. Uma chave presente num ambiente e ausente noutro, avaliando os templates antes de um documento ser analisado.
  • Resultados de políticas no editor. Os resultados de um plugin de governação apresentados no editor à medida que os ficheiros mudam, ao lado da validação que este apresenta hoje.