Visão geral do vocabulário
Um pequeno conjunto de palavras-chave se repete nas entidades do Aggrega. Em vez de explicá-las novamente em cada página de entidade, os capítulos do vocabulário concentram a explicação em um único lugar por família de palavras-chave. Toda entidade que aceita uma dessas palavras-chave o faz com a mesma semântica que este conjunto de capítulos especifica.
O vocabulário se divide em quatro famílias: a tríade topológica (provides, inject, uses), que conecta arestas topológicas explícitas entre nós e carrega o contrato de injeção que o compilador encaminha; os pilares de dados (values, infra, parameters, locals), que separam as quatro responsabilidades sobre dados — intenção do desenvolvedor, dimensionamento físico, ajustes por ambiente e estado privado da Recipe; as palavras-chave de herança e interface (extends, implements), que compõem entidades de catálogo e declaram qual Component uma Recipe implementa; e o sistema de modificadores (appliesTo, appliesToAnyOf), que determina a quais nós uma Feature se anexa por meio de seletores de labels. O enquadramento conceitual de como os pilares separam responsabilidades está em ../architecture/06-data-taxonomy-and-composition.md; a mecânica de resolução da topologia está em ../architecture/07-dependency-resolution.md.
Referência por tópico
- Tríade topológica:
provides,inject,uses— o contrato de injeção e as declarações explícitas de arestas topológicas. Aborda a sintaxe de inject compacta e a detalhada, as formas de pipe.context.inject/.context.usesque os templates leem e o contexto de duplo estado que protege Ops de panics de ponteiro nil. - Pilares de dados:
values,infra,parameters,locals— os quatro pilares de dados e a quem pertencem.valueseparametersdo desenvolvedor,infrade Ops,localsprivados da Recipe e o padrão de elevação de parâmetros para variação por ambiente. - Herança e interface:
extends,implements— herança de entidades de catálogo viaextends(o deep-merge do envelope YAML comum a Components e Features, os pilares de dados que um Component que estende outro herda integralmente da sua base e a composição JSON Schema 2020-12 a que o schema de uma Feature é submetido) e a declaração de Recipe para Componentimplements(formas exata, com intervalo de versões e sem versão), em relação à qual o mapeamento do Manifest é verificado —implementsnunca seleciona uma Recipe. - Sistema de modificadores:
appliesToe seletores — seletores de attachment de Feature, o mecanismo nativo em Go de correspondência de labels, a gramática de seletores em forma de string e a varianteappliesToAnyOfque compõe com OR. - Fora das quatro famílias: a escrita em forma compacta, as referências entre documentos, os labels e anotações, a superfície de publicação, os contratos sociais, a superfície de validação, a composição da saída, a gramática de URI e a resolução de versões.