Visão geral do vocabulário
Um pequeno conjunto de palavras-chave repete-se nas entidades do Aggrega. Em vez de as explicar de novo em cada página de entidade, os capítulos de Vocabulário concentram o ensino num único sítio por família de palavras-chave. Todas as entidades que aceitam uma destas palavras-chave fazem-no com a mesma semântica que este conjunto de capítulos especifica.
O vocabulário divide-se em quatro famílias: a tríade de topologia (provides, inject, uses), que liga arestas topológicas explícitas entre nós e transporta o contrato de injeção que o compilador encaminha; os pilares de dados (values, infra, parameters, locals), que separam as quatro preocupações de dados — intenção do programador, dimensionamento físico, parâmetros 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 que Component uma Recipe implementa; e o sistema de modificadores (appliesTo, appliesToAnyOf), que rege a que nós uma Feature se associa através de seletores de etiquetas. O enquadramento conceptual de como os pilares separam preocupações 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 tema
- Tríade de topologia:
provides,inject,uses— o contrato de injeção e as declarações explícitas de arestas topológicas. Aborda a sintaxe de inject compacta vs. verbosa, as formas de pipe.context.inject/.context.usesque os templates leem e o contexto de estado duplo que protege a equipa de Ops de pânicos de ponteiro nulo. - Pilares de dados:
values,infra,parameters,locals— os quatro pilares de dados e a quem pertencem.valueseparametersdetidos pelo programador,infradetido pela equipa de 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 entre entidades de catálogo através deextends(a fusão profunda do envelope YAML comum a Components e Features, os pilares de dados que um Component que estende herda inteiros da sua base e a composição JSON Schema 2020-12 a que o esquema de uma Feature é sujeito) e a declaração de Recipe para Componentimplements(formas exata, de intervalo versionado e não versionada), face à qual o mapeamento do Manifest é verificado —implementsnunca seleciona uma Recipe. - Sistema de modificadores:
appliesToe seletores — seletores de associação de Feature, o motor nativo de correspondência de etiquetas em Go, a gramática de seletores em forma de cadeia e a varianteappliesToAnyOf, que compõe por OU. - Fora das quatro famílias: a autoria em forma compacta, as referências entre documentos, as etiquetas 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 URIs e a resolução de versões.