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

Como utilizar esta referência

A Referência da linguagem especifica a superfície de autoria do Aggrega — os esquemas YAML, o vocabulário partilhado de palavras-chave, o sistema de templates Go, os contratos dos providers, os comandos da CLI, o catálogo de erros do compilador e exemplos trabalhados de ponta a ponta. Os capítulos abaixo leem-se por ordem para uma primeira orientação; para consultar uma entidade, palavra-chave, provider, comando da CLI ou erro específico, pode saltar-se diretamente para um subdiretório.

Para instalar primeiro o binário aggrega, siga Instalar o binário; para que um assistente de IA o instale e configure, cole o prompt de Configurar o Aggrega com o seu assistente de IA. Antes de construir scripts ou um catálogo sobre o Aggrega, leia Compatibilidade para saber o que uma atualização pode e não pode alterar.

Antes de ler a Referência, convém assentar no modelo mental que os capítulos de arquitetura estabelecem. O capítulo Os quatro domínios e as topologias de equipa explica como o Aggrega separa as preocupações de intenção do programador, catálogo da plataforma, Platform Ops e operador da plataforma em superfícies de autoria distintas; o capítulo Taxonomia de entidades nomeia as entidades (Aggregate, Component, Feature, Recipe, FeatureRecipe, Plugin, Manifest, Release, SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary) e os seus papéis nesses domínios. Todos os capítulos da Referência a seguir a este pressupõem que o leitor tem essa forma em mente.

Esta Referência usa-se de dois modos. Para a integração inicial, a leitura é sequencial: começar por Convenções de nomenclatura para o padrão de nomes de instância e as regras de capitalização e, em seguida, percorrer os capítulos de entidades e de vocabulário para construir o contrato de autoria completo. Para consulta, salta-se diretamente para o subdiretório que corresponde à pergunta — entities/ para a semântica dos campos de cada entidade, vocabulary/ para palavras-chave comuns a várias entidades, templates/ para a superfície de templates Go disponível aos autores de Recipes, providers/ para os contratos de despacho de cada provider, plugins/ para os sockets de plugins e a autoria de plugins, schema/ para o JSON Schema de cada tipo, cli/ para a utilização da linha de comandos, errors/ para diagnósticos e examples/ para padrões trabalhados.