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

出力の合成

1 回の Aggrega ビルドは、6 つの異なるメカニズム(ソース指定レンダリング、ワークロード合成、FeatureRecipe Resource Generation、FeatureRecipe プラグインパイプラインのパッチ、Release レベルの合成、アーティファクトの直接出力)によって、dist/ 配下の境界ごとのディレクトリに出力ファイルを生成します。各メカニズムは定められた順序で実行されます。2 つのメカニズムが同じ境界ディレクトリ内で同じ名前のファイルを生成すると、出力は決定的に衝突します。衝突が検出されると、ビルドは出力の前に、その衝突ルールが示すカテゴリで停止し、すべての寄与元を示します。

このページでは、6 つのメカニズムを 1 か所にまとめて説明し、それらの間のレンダリング順序を示します。各章および各エンティティのリファレンスはそれぞれの対象範囲を扱い、6 つすべてにまたがる衝突検出のルールはここで扱います。

出力を生成する 6 つのメカニズム

各メカニズムは特定の Recipe / FeatureRecipe のオーサリング面に存在し、特定の命名の慣例に従ってファイルを生成します。メカニズムはノードごとに累積します。単一のコンポーネントインスタンスが複数のメカニズムを同時に駆動できます(ソース付きのベース Recipe + Workload で合成された付随ファイル + FeatureRecipe が出力する ExternalSecret CRD + 合成された Deployment に適用されるプラグインパイプラインのパッチ)。

1 — Recipe のソース付きレンダリング(source: + valuesMapping:)

オーサリング面。 Recipe は source: <path> と valuesMapping: を宣言します(このフィールドはインラインの Go テンプレート、ファイルの $import:、または MappingLibrary エントリへのライブラリ $import: を受け付けます。entities/recipe.md の「The valuesMapping field — three authoring modes」を参照してください)。ソースはディスク上の Helm チャート、docker-compose の YAML ファイル、またはその他のプロバイダーネイティブな成果物を指します。

パイプライン上の位置。 ベースレンダリング。Recipe の locals と provides が解決された後です。

出力の形。 Provider ごとに異なります:

  • helm プロバイダー — フラットな Kubernetes YAML ファイルで、コンポーネントの識別子、次にリソース自体にちなんで <component-id>-<kind>[-<namespace>]-<name>.yaml と命名されます。kind または name を持たないドキュメントは、代わりにテンプレートのパスにちなんで命名されます。名前はテンプレートではなくリソースから取られるため、異なるサブディレクトリにあるファイル名が同じ 2 つのテンプレートは 2 つのファイルのままです。Helm SDK はマージされた値でチャートをレンダリングし、Aggrega はレンダリング後に来歴のラベルとアノテーションを注入します。
  • helm-chart provider — charts/<instance_id>/ 配下にコピーされるサブチャートファイル。チャート自身の name を除いてそのままコピーされます。この名前はアンブレラがインスタンスのエンコード済み識別子に設定するため、同じ名前を宣言するチャートをベンダリングする 2 つのコンポーネントも区別できます(providers/helm-chart.md を参照)。境界ごとのアンブレラ Chart.yaml + values.yaml が併せて出力されます。
  • compose プロバイダー — Release レベルのコンポジション(メカニズム 5)に流れ込む中間ファイル <nodeID>.compose-fragment.yaml です。

2 — Recipe の Workload 合成(workload:)

オーサリング面。 Recipe は Workload ドキュメントを持つ workload: を宣言します。このフィールドは、インラインのコンテンツ(ブロックスカラー)または $import:(ファイルパス)を受け付けます。

パイプライン上の位置。 ベースレンダリング。Recipe の valuesMapping が解決された後です(Workload の本体自体が、完全なテンプレートコンテキストで評価される Go テンプレートの文字列です)。

出力の形。 Provider ごとに異なります:

  • helm プロバイダー — Workload の form によって選ばれる 1 つのコントローラーオブジェクト(stateless には Deployment、stateful には StatefulSet、daemon には DaemonSet、task には Job、scheduled には CronJob)+ サービスごとの Service + persistent ボリュームごとに 1 つの PVC です。命名の形は 2 つあり、同じではありません: コントローラーオブジェクトはノードの release 名とその kind にちなんで <release name>-deployment.yaml、<release name>-statefulset.yaml、<release name>-daemonset.yaml、<release name>-job.yaml、<release name>-cronjob.yaml と命名されます。一方、リソースごとのファイルは それが持つリソース にちなんで kind を末尾にして <release name>-<svcName>-service.yaml および <release name>-<volName>-pvc.yaml と命名されます。それぞれがそのリソース自身の metadata.name から命名されるためです。release 名は、ノードの ID を Kubernetes の名前が許容するアルファベットで書いたものなので、ノード ID にアンダースコアも大文字も含まれない場合はノード ID と等しくなります。ノード my_api は my-zuapi-deployment.yaml を書き出します(entities/workload.md の「Synthesized-name convention」を参照)。公開が外部名のみの Workload は、持つべきサービスキーがないため、代わりに <release name>-service.yaml を出力します。
  • compose プロバイダー — Release レベルのコンポジションに流れ込む中間ファイル <nodeID>.compose-fragment.yaml です。
  • helm-chart プロバイダー — サポートされていません。helm-chart の役割はソース付きモードのチャートコンポジションのみです。workload: を持ち helm-chart をターゲットとする Recipe は、レンダリング時に拒否されます(helm-chart プロバイダーは合成の機能を持たないと報告します)。

3 — FeatureRecipe のリソース生成(FeatureRecipes のソース付きモード)

オーサリング面。 FeatureRecipe は source: と valuesMapping:(またはそれと同等のもの)を宣言します。Recipe のソース付きレンダリングと同じパターンですが、主たる Components ではなく Feature のアタッチメントが対象です。

パイプライン上の位置。 ベースレンダリング。親 Component のベース Recipe レンダリングと並行します。各 Feature アタッチメントは、それぞれ独自の FeatureRecipe レンダリングパスを実行します。

出力の形。 親 Component のプロバイダーによって決まります。アタッチメントの出力は独自のアセンブリグループではなく、その Component のアセンブリグループに加わるためです。そして、出力の形はそのプロバイダーがグループをどのように結合するかから導かれます。アタッチメントを置く場所がそもそもあるかどうかを決めるのはそれだからです。結合の方法ごとに 1 つ、計 3 つの形があります。

  • 各コントリビューターに 独自の位置 を与えるプロバイダー(コントリビューターごとに 1 つのチャートを保持する 1 つのチャート、コントリビューターごとに 1 つのモジュールを保持する 1 つのルート設定)は、アタッチメントにも独自の位置を与えます。その位置は、アタッチ先のコンポーネントの内側ではなく 隣 です。2 つの座標がその位置の単一のディレクトリセグメント <component-id>--<feature-instance-id> を構成するため、アタッチメント aux を持つコンポーネント api は、そのプロバイダーがコントリビューター用に指定するディレクトリの下で、api の隣の api--aux に置かれます。内側ではなく隣なのは、そのようなプロバイダーのターゲットが、自らが与えた位置 において コントリビューターを検出するためです。それらの位置の 1 階層下にあるディレクトリは、独立したコントリビューターではなくそのコントリビューターに属するコンテンツであり、何からも参照されず、何からも読まれません。境界 に宣言されたアタッチメントには名前とすべきホストコンポーネントがないため、そのセグメントはインスタンス名のみです。各座標は結合前にエンコードされるため、結合シーケンスそのものを含む座標が結合と取り違えられることはありません。
  • 各ドキュメントを 境界ディレクトリ直下 に書き出すプロバイダーには、そのような場所がありません。それこそがそのプロバイダーがターゲットについて宣言している内容、すなわちディレクトリ直下にあるファイルのみが読まれるということだからです。そのため、同じ 2 つの座標はディレクトリセグメントからファイル名へと移り、アタッチメントのファイルはコンポーネント自身のファイルの隣に <component-id>--<feature-instance-id>--<file> として配置されます。ファイル名には頼れる区切りがないため 2 つの座標はエンコードされ、エンコードされた座標が決して含み得ない 2 文字の境界でファイル自身の名前と結合されます。これにより、同じファイル名を出力する 2 つのアタッチメントが 2 つの別々のファイルに保たれます。
  • グループのコントリビューターを 1 つのドキュメントに畳み込む プロバイダーは、アタッチメントの出力もそのドキュメントに畳み込みます。各リソースはアタッチメント自身の識別子を持つため、何がどこから来たかを読み取れる状態が保たれます。そのようなプロバイダーが 別の ターゲット向けにレンダリングされたアタッチメントを持つ場合、そのコンテンツは属していないドキュメントに畳み込むことができないため、同じ理由により、上述のファイル名プレフィックスの形で、組み立てられたドキュメントの隣に書き出されます。

よくある形:

  • 資格情報用 FeatureRecipe の Fetcher が生成する ExternalSecret / VaultSecret CRD。
  • オブザーバビリティ用 Feature が生成する ServiceMonitor / PrometheusRule CRD。
  • ルーティング用 Feature が生成する HTTPRoute / Gateway CRD。

4 — FeatureRecipe プラグインパイプライン(RFC 6902 パッチ + リソース出力)

記述箇所。 FeatureRecipe は pipeline: を宣言します。これは Wasm プラグインステップの配列です(Two-Part Plugin Principle:認証情報の Features では Fetcher + Injector、認証情報以外の Features では任意のプラグインパイプライン)。

パイプライン上の位置。 プラグインパイプライン。ベースレンダリングと FeatureRecipe のソース付きレンダリングが完了した後です。

出力の形。 Plugin ごとに異なります。ステップは 2 種類の出力を返します。

  • RFC 6902 パッチ。適用エンジンがレンダリング済みセット内の対象ドキュメントに適用します(例:合成された Deployment へのサイドカーコンテナの追加、シークレットボリュームのマウント、環境変数の書き換え)。
  • 副作用 — ステップの side_effects を通じてパッチと並べて出力される、完全な新規リソースです(典型的には、Fetcher の vault-fetch CRD で、Injector がそれを参照します)。

現在の状況: Status of the Language → Compilation pipeline phases のとおり 利用可能 です。宣言された各ステップは aggrega build の実行中に動作します。ホストはレンダリング済みセットに対してステップの Wasm プラグインを呼び出し、返されたパッチを適用し、ステップの副作用を出力します。プラグイン契約のインターフェースについては plugins/plugin-contract.md を参照してください。

5 — Release レベルの合成(provider ごとのバウンダリ組み立て)

記述箇所。 Release の形によって決まり、Recipe ごとの記述はありません。バウンダリを組み立てるケイパビリティは、そのバウンダリ内のすべてのノードのレンダリングが終わった後に一度だけ組み立てを行います。compose ケイパビリティはノードごとのフラグメントをすべてバウンダリごとに 1 つの docker-compose.yaml にまとめ、helm-chart ケイパビリティはノードごとのサブチャートのコピーをバウンダリごとに 1 つのアンブレラチャートにまとめます。

パイプライン上の位置。 ベースレンダリングの後、バウンダリについてすべてのノードの Recipe ごとの出力が揃った時点です。

出力の形。 provider ごとに異なります。

  • compose provider — バウンダリのルートに 1 つの docker-compose.yaml を置き、寄与するすべてのノードのサービス、ボリューム、ネットワークを集約します。中間ファイル <nodeID>.compose-fragment.yaml(メカニズム 1 + 2)は単一の出力にマージされ、フラグメントは最終的なバウンダリディレクトリには現れません。
  • helm-chart provider — バウンダリのルートに 1 つのアンブレラ Chart.yaml + values.yaml を置き、加えて charts/<instance_id>/ 配下にノードごとのサブチャートディレクトリを置きます。

6 — Recipe による成果物の直接出力(artifacts:)

記述箇所。 Recipe は artifacts: を名前付きエントリのマップとして宣言します。各エントリはインラインの内容(ファイル本体を持つテンプレート文字列)か、テンプレートファイルのパスへの $import: 参照のいずれかです。provider を経由しない直接のファイル出力です。

パイプライン上の位置。 ベースレンダリング内の成果物評価です。

出力の形。 成果物エントリごとに 1 ファイルで、artifacts: マップ内のエントリのキーに従って命名されます。ファイル名と内容は Recipe の作成者が直接決めます。

現在の状況: Status of the Language → Recipe input kinds のとおり 利用可能 です。各エントリはワークロード合成とソース解決の後に完全なテンプレートコンテキストで評価され、生成されたファイルはエントリのキーで出力されます。出力された成果物をターゲットがどう扱うかはケイパビリティによって異なります。単独の成果物を受け付ける provider はそれを独立したファイルとして出力しますが、他の入力種別と併せてのみ成果物を受け付けるものは、そのエントリを組み立て対象に取り込みます。そのため、本体がその組み立て側の想定する形でない場合は、そのまま出力されるのではなく TRANSLATION_ERROR カテゴリで停止します。ケイパビリティ向けに成果物を記述する前に、architecture/16-recipe-input-composition.md のケイパビリティ別一覧を確認してください。

レンダリング順序

6 つのメカニズムは、下流のメカニズムが上流の出力を読み取れるよう、定められた順序で実行されます。順序は次のとおりです。

  1. provides の評価 — ノードごとに、まず Recipe の locals: ブロックが作成者の記述順に解決され、各エントリはその上にあるエントリを読み取ります。続いてノードの provides: テンプレートが評価されます。これらの間の順序は任意です(自己完結しており、.context.instance_id、ノードの provider が報告する場合は .context.rendered_name、.values、.infra、解決済みの .locals、静的テキストを使用します)。locals を provides より先に評価するこの順序により、provides: エントリはローカルを読み取って解決済みの値を受け取ることができます。
  2. locals の公開とソースの解決 — それらの locals が .locals に公開され、Recipe の source: URI テンプレートがそれらに対して評価されます(テンプレート化されている場合はソースポインタを解決します)。ソースのサーフェスは locals のコンテキストを共有するため、.provides ではなく .locals を読み取ります。
  3. inject マッピング — FeatureRecipe の injectMapping: ブロックが評価されます(inject パイプは Recipe のレンダリングより前にインターセプトされます)。
  4. values マッピング — Recipe の valuesMapping: が評価されます(sourced モードと sourceless モードが values 辞書を生成します)。
  5. Workload の合成 — Recipe の Workload 合成(メカニズム 2 が synthesized モード向けにマニフェストを出力します)。
  6. アーティファクトの評価 — Recipe の artifacts: の評価(メカニズム 6)。
  7. Provider render — provider がレンダリングを行います(メカニズム 1 — sourced モードはフラットなマニフェストを生成し、sourceless モードは生成的なマニフェストを生成します)。
  8. Feature のレンダリング — ノード上のすべての Feature アタッチメントに対する FeatureRecipe のレンダリング(メカニズム 3 と 4 — リソース生成はここで実行され、プラグインパイプラインは後のステップ 9 で実行されます)。
  9. プラグインパイプライン — レンダリング後の変更。FeatureRecipe の pipeline: プラグインステップが RFC 6902 パッチを適用し、追加のリソースを出力します(メカニズム 4)。
  10. Release レベルのコンポジション — capability の境界アセンブリが、ノードごとのフラグメントを境界ごとの出力にまとめます(メカニズム 5)。

この順序が重要なのは、下流のメカニズムが上流の出力を読み取れるためです。たとえば、プラグインパイプラインのステップは provider がレンダリングした Deployment にパッチを適用でき、Release レベルのコンポーザーは provider のレンダリング、feature のレンダリング、プラグインパイプラインが出力したフラグメントをマージできます。

衝突検出ルールセット

2 つのメカニズムが同じ boundary ディレクトリ内に同じ名前のファイルを生成すると、ビルドは以下の各ルールが示すカテゴリで停止し、すべての寄与元を示します。ルールセットは次のとおりです。

Recipe の形状ルール: artifacts: エントリキーの衝突

Recipe が artifacts: の下に同じキーを持つ 2 つのエントリを宣言する場合です(キーは出力されるファイル名を決定します。エントリの本体がインラインで記述されているか、$import: で読み込まれているかは問いません)。errors/fatal-halts.md の「artifacts: entry keys must be unique(エントリのキーは一意でなければなりません)」に従い、Recipe の読み込み時に検出されます。

Recipe の形状ルール: 入力種別をまたぐ出力時の衝突

Recipe の 3 つの入力種別(sourced、synthesized、artifacts)は、それぞれ同じ boundary ディレクトリにファイルを出力します。ソースからレンダリングされた出力、Workload から合成された出力、または artifact として出力されたものが、別の入力種別も生成した名前のファイルを生成すると、ビルドは出力時に停止します。errors/fatal-halts.md の「Emission-time filename collision across input kinds(入力種別をまたぐ出力時のファイル名の衝突)」に従い、出力時に検出されます。

Compose のサービス名の衝突(Release レベル)

2 つの異なるノード(boundary の組み合わせは問いません)が、マージされた compose 出力に同じ名前のサービスを寄与すると、compose プロバイダは boundary を合成する時点で TRANSLATION_ERROR カテゴリで停止し、寄与しているすべての (boundary, node, serviceName) タプルを示します。providers/compose.md の Release レベル出力のセクションに従い、Release レベルの合成時に検出されます。

サービスは名前だけで拒否され、2 つのノードが宣言した内容は比較されません。compose のサービスは単一の実行中コンテナであるため、それぞれが 1 つを求めた 2 つのノードは 2 つで 1 つを得ることになり、2 つの定義がどれほど同一であっても、寄与元の意図は失われます。

Compose のボリューム名と config 名の競合(Release レベル)

2 つの異なるノードが、マージされた compose 出力に同じ名前のトップレベルの volumes: または configs: エントリを寄与し、その 2 つの宣言が異なる場合、compose プロバイダは TRANSLATION_ERROR カテゴリで停止し、そのエントリと寄与しているすべての (boundary, node) タプルを示します。providers/compose.md の Release レベル出力のセクションに従い、Release レベルの合成時に検出されます。

上記のサービスのルールとは異なり、このルールは宣言を比較し、寄与元の内容が一致する場合は名前の共有が正当なものとなります。名前付きのボリュームや config は 1 つのオブジェクトであるため、それを同一に宣言する 2 つのノードは、どちらもマージ後のドキュメントに最終的に含まれるエントリそのものを求めたことになり、何も失われません。異なる宣言をする 2 つのノードはその 1 つのオブジェクトについて食い違っており、どちらかの宣言を残すと、本来なら成功するはずのビルドからもう一方を捨てることになります。2 つの宣言は、組み立てられたファイル内で同じエントリを記述している場合に一致するとみなされるため、空のマッピングとして書かれた本体と、完全に省略された本体は一致します。

helm-chart のサブチャートのエイリアスとディレクトリ

helm-chart のサブチャートは charts/<instance_id>/ に配置され、その values はエイリアスの下にスコープされます。エイリアスは、エイリアスの位置向けにエンコードされたインスタンス ID です。エンコードはエイリアスが受け付けない文字を置き換えるのではなく書き出すため、2 つのインスタンスのインスタンス ID が同じ文字列でない限り、同じエイリアスに行き着くことはありません。したがって、エイリアスはちょうど 1 つのサブチャートを識別し、その下に書かれた values はそのサブチャートにのみ届きます。さらに、インスタンス ID は Aggregate のフラット化ルールにより boundary ごとに一意であるため、ディレクトリも衝突しません。どちらも構造的なものであり、チェックには依存しません。

Helm のレンダリング済みリソース名の衝突

boundary 内で、同じ Kubernetes リソース名にレンダリングされる 2 つのノードは、metadata.name フィールドが重複する 2 つの YAML ファイルを生成します。ファイル名はそれぞれ固有の命名ベースが接頭辞として付くため異なりますが、内部の metadata.name は一致する可能性があります。そのため、ビルドはレンダリングされたリソースが持つ名前を検査し、2 つの寄与元が 1 つの名前空間で 1 つの kind に対して同じ名前を導出した場合、何かを書き出す前に TRANSLATION_ERROR カテゴリで停止し、その名前と、それを導出した各コンポーネントおよび各アタッチメントを示します(errors/fatal-halts.md を参照)。

最も大きなケースは、チェックではなく構造によって排除されています。 リソースに release 名に基づく名前を付ける sourced チャートは、2 つのコンポーネント間でこの衝突を生じさせることはもうありません。少しでも異なる 2 つの命名ベースは 2 つの異なる release 名に行き着くためです。providers/helm.md の「How the release name is derived」を参照してください。残るケースは 2 つで、上記のチェックが報告するのはこれらです。1 つは、テンプレートにリソース名をリテラルで書き込むチャートであり、どのような導出もそのような名前を他のリテラルと区別できません。もう 1 つは、1 つのコンポーネント上の 2 つの Feature アタッチメントが、それぞれの作成者が書いたチャートを提供する場合です。どちらも設計上そのコンポーネントの release 名に対してレンダリングされるため、リソースに .Release.Name に基づく名前を付ける 2 つのチャートはそこで衝突します。2 つのチャートのリソースに異なる名前を付けるか、別々のコンポーネントにアタッチしてください。

合成されるすべての名前は、ノード自身の ID で始まります。コントローラオブジェクトの名前も、合成される Service 名の慣例 <release name>-<svcName>(entities/workload.md の「Synthesized-name convention」による)を通じたリソースごとの名前もそうであり、これによりノード間の衝突は構造上起こり得ません。Deployment / Service の名前でビルドが停止した場合は、まず 2 つの異なる Recipes が異なるレンダリング経路を通じて同名のリソースを出力していないか(例: sourced チャートの templates/deployment.yaml が、Workload から合成された Deployment の metadata.name と衝突している)を確認してください。

メカニズム間の相互作用パターン

Workload 合成 + プラグインパイプラインのパッチ

標準的なパターン: メカニズム 2(workload 合成)がベースとなる Deployment を出力し、メカニズム 4(Injector プラグイン)が Deployment にシークレットボリュームをマウントする RFC 6902 パッチを適用します。2 つのメカニズムは組み合わさります。Deployment は同一の K8s リソースであり、パッチが合成されたベースの上に ConfigMap / Secret の参照を重ねます。

これは、合成された workload への認証情報注入における主要なパターンです。Fetcher(メカニズム 3、リソース生成)はクラスタが実行時に取得する ExternalSecret CRD を出力し、Injector(メカニズム 4、プラグインパイプラインのパッチ)は、その結果生成される K8s Secret をマウントするよう Deployment を変更します。

異なるバウンダリ上でのソース + Workload 合成

1 つの Aggregate の中で、ある component をバウンダリ A 上のソース型 helm Recipe(メカニズム 1)にバインドし、兄弟 component をバウンダリ B 上の Workload 合成型 helm Recipe(メカニズム 2)にバインドできます。各バウンダリのディレクトリはそれぞれに適した出力形状を持ちます。バウンダリごとの dist/ ディレクトリは兄弟間で分離されているため、バウンダリをまたぐファイル名は衝突しません。

出力ディレクトリごとの Compose の Release レベルのマージ

compose ケイパビリティのアセンブリは、ディレクトリが同じパスに評価されるすべてのバウンダリのノードごとのフラグメントを、そのパスにある 1 つの docker-compose.yaml にまとめます。1 つの Release 内の compose を対象とする 2 つのバウンダリは、ディレクトリが異なる場合は 2 つのファイルを書き出し、ディレクトリを共有する場合はマージされた 1 つのファイルを書き出します。

したがって、サービス名の衝突は前述のルールに従い、ファイルごとに、その Release レベルのマージ時に検出されます。api という名前のサービスをそれぞれ宣言する、異なるディレクトリにある compose を対象とする 2 つのバウンダリは衝突しません。各バウンダリのファイルがそれぞれ自分のサービスを持つためです。ディレクトリを共有する 2 つのバウンダリは 1 つのファイルを書き出し、ビルドは両方の寄与元を示して停止します。

相互参照

  • entities/recipe.md — Recipe のオーサリングサーフェス(メカニズム 1 + 2 + 6 は Recipe の内容から出力します)。
  • entities/featurerecipe.md — FeatureRecipe のオーサリングサーフェス(メカニズム 3 + 4 は FeatureRecipe の内容から出力します)。
  • providers/helm.md — helm プロバイダーのメカニズムごとの出力形状と命名の慣例。
  • providers/helm-chart.md — helm-chart プロバイダーのアンブレラ + サブチャートの合成(メカニズム 5)。
  • providers/compose.md — compose プロバイダーのノードごとの断片化 + Release レベルの合成(メカニズム 5)。
  • errors/fatal-halts.md — artifacts: のエントリキーの一意性と、入力種別をまたぐファイル名の衝突に関する Recipe の形状ルール。
  • templates/expansion-matrix.md — レンダリング順序におけるテンプレート箇所ごとの評価タイミング。
  • plugins/plugin-contract.md — プラグインパイプラインの契約サーフェス(メカニズム 4)。
  • 10-status.md — メカニズム 6(artifacts:)とメカニズム 4 のプラグインパイプラインランタイムの現在の準備状況。
  • architecture/10-compilation-pipeline.md — レンダリングステージの順序を含む、コンパイルパイプライン全体。
  • architecture/16-recipe-input-composition.md — 3 種類の Recipe 入力種別(メカニズム 1 + 2 + 6 の上流の枠組み)。