このページは機械翻訳されています。英語の原文を読む。
語彙の概要
Aggrega のエンティティ全体には、少数のキーワードが繰り返し登場します。各エンティティのページで毎回説明し直すのではなく、Vocabulary の各章ではキーワードのファミリーごとに 1 か所で説明をまとめています。これらのキーワードのいずれかを受け付けるエンティティはすべて、この一連の章が規定するのと同じセマンティクスでそれを扱います。
語彙は 4 つのファミリーに分かれます。ノード間の明示的なトポロジーのエッジを結び、コンパイラが受け渡す注入の契約を担うトポロジーの三つ組(provides、inject、uses)、開発者の意図、物理的なサイジング、環境ごとの調整項目、Recipe のプライベートな状態という 4 つのデータの関心事を分離するデータの柱(values、infra、parameters、locals)、カタログのエンティティを合成し、Recipe がどの Component を実装するかを宣言する継承とインターフェースのキーワード(extends、implements)、そしてラベルセレクターによって Feature がどのノードにアタッチされるかを制御する修飾子システム(appliesTo、appliesToAnyOf)です。データの柱がどのように関心事を分離するかの概念的な説明は ../architecture/06-data-taxonomy-and-composition.md に、トポロジー解決の仕組みは ../architecture/07-dependency-resolution.md にあります。
トピック別リファレンス
- トポロジーの三つ組:
provides、inject、uses— 注入の契約と、明示的なトポロジーのエッジの宣言。inject の簡潔な構文と冗長な構文の違い、テンプレートが読み取る.context.inject/.context.usesのパイプの形、そして Ops を nil ポインターによるパニックから守る二状態のコンテキストを扱います。 - データの柱:
values、infra、parameters、locals— 4 つのデータの柱とその所有者。開発者が所有するvaluesとparameters、Ops が所有するinfra、Recipe にプライベートなlocals、そして環境ごとの差異に対応するパラメーターの巻き上げパターンを扱います。 - 継承とインターフェース:
extends、implements—extendsによるカタログのエンティティの継承(Components と Features に共通する YAML エンベロープのディープマージ、拡張する Component がベースからそのまま継承するデータの柱、Feature のスキーマに適用される JSON Schema 2020-12 の合成)と、Recipe から Component への宣言であるimplements(厳密な形式、バージョン範囲の形式、バージョンなしの形式)を扱います。Manifest のマッピングはこの宣言に照らして検査されますが、implementsが Recipe を選ぶことはありません。 - 修飾子システム:
appliesToとセレクター — Feature のアタッチ用セレクター、ネイティブの Go によるラベルマッチングエンジン、文字列形式のセレクターの文法、そして OR で合成するappliesToAnyOfバリアントを扱います。 - 4 つのファミリー以外: コンパクト形式のオーサリング、ドキュメント間の参照、ラベルとアノテーション、公開のサーフェス、社会契約、検証のサーフェス、出力の合成、URI 文法、バージョン解決。