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

Como usar esta referência

A referência da linguagem especifica a superfície de criação de Aggrega — os esquemas YAML, o vocabulário de palavras-chave compartilhado, o sistema de templates Go, os contratos dos providers, os comandos da CLI, o catálogo de erros do compilador e exemplos completos de ponta a ponta. Leia os capítulos abaixo em ordem para uma primeira orientação, ou vá direto a um subdiretório ao procurar uma entidade, palavra-chave, provider, comando da CLI ou erro específico.

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

Antes de ler a referência, familiarize-se com o modelo mental que os capítulos de arquitetura estabelecem. O capítulo Os quatro domínios e Team Topologies explica como Aggrega separa as preocupações de Developer Intent, Platform Catalog, Platform Ops e Platform Operator em superfícies de criação distintas; o capítulo Taxonomia de entidades nomeia as entidades (Aggregate, Component, Feature, Recipe, FeatureRecipe, Plugin, Manifest, Release, SchemaLibrary, MappingLibrary, WorkloadLibrary, ArtifactLibrary) e suas funções nesses domínios. Cada capítulo da referência após este pressupõe que o leitor tenha essa visão.

Use esta referência de dois modos. Para a integração inicial, leia em sequência: comece por Convenções de nomenclatura para o padrão de nomes de instância e as regras de maiúsculas e minúsculas, depois percorra os capítulos de entidades e vocabulário para construir o contrato de criação completo. Para consulta, vá direto ao 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 Recipe, providers/ para os contratos de despacho de cada provider, plugins/ para os sockets de plugins e a criação de plugins, schema/ para o JSON Schema de cada tipo, cli/ para o uso da linha de comando, errors/ para diagnósticos e examples/ para padrões completos.