コンテンツにスキップ
AggregaAggrega
言語の選択: 日本語
このページは機械翻訳されています。英語の原文を読む。

このリファレンスの使い方

言語リファレンスは、Aggrega のオーサリング面を規定します。YAML スキーマ、共通のキーワード語彙、Go テンプレートシステム、プロバイダーの契約、CLI コマンド、コンパイラのエラーカタログ、そしてエンドツーエンドの実例です。初めて読む場合は以下の章を順に読み、特定のエンティティ、キーワード、プロバイダー、CLI コマンド、エラーを調べる場合はサブディレクトリに直接移動してください。

先に aggrega バイナリをインストールするには、バイナリのインストールの手順に従ってください。AI アシスタントにインストールとセットアップを任せるには、AI アシスタントで Aggrega をセットアップするのプロンプトを貼り付けます。Aggrega の上にスクリプトやカタログを構築する前に、アップグレードで何が変わりうるか、何が変わらないかについて 互換性 を読んでください。

リファレンスを読む前に、アーキテクチャの章で確立されるメンタルモデルを把握してください。4 つのドメインとチームトポロジーの章では、Aggrega が Developer Intent、Platform Catalog、Platform Ops、Platform Operator の関心事を別々のオーサリング面にどのように分離するかを説明しています。エンティティ分類の章では、各エンティティ(Aggregate、Component、Feature、Recipe、FeatureRecipe、Plugin、Manifest、Release、SchemaLibrary、MappingLibrary、WorkloadLibrary、ArtifactLibrary)と、それらのドメインにおける役割を示しています。この章以降のリファレンスの各章は、読者がその全体像を把握していることを前提としています。

このリファレンスは 2 つの使い方ができます。導入時には順に読んでください。まずインスタンス名のパターンと大文字・小文字の規則について命名の慣例から始め、続いてエンティティと語彙の章を読み進めて、オーサリングの契約全体を把握します。調べものをする場合は、疑問に対応するサブディレクトリに直接移動してください。エンティティごとのフィールドの意味は entities/、エンティティ横断のキーワードは vocabulary/、Recipe の作成者が利用できる Go テンプレートの機能は templates/、プロバイダーごとのディスパッチ契約は providers/、プラグインのソケットとプラグインの作成は plugins/、各 kind の JSON Schema は schema/、コマンドラインの使い方は cli/、診断は errors/、実例のパターンは examples/ を参照してください。