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

役割別のエンティティ

どのエンティティ種別にも、通常それを作成する役割があります。このページはその完全な対応表です。関心事はわかっているものの、それがどのファイルに属するかがまだわからないときに参照してください。役割の割り当ては指針であり、コンパイラが強制するものではありません(ペルソナを参照)。よく整理された構成において、ある種別を通常誰が所有するかを示しています。

対応表の概要

役割エンティティ種別関心事
開発者Aggregateアプリケーションの意図:アプリが何であり、何を必要とするか
プラットフォームアーキテクトComponent、Feature再利用可能でバージョン管理されたカタログ契約
プラットフォーム運用Recipe、FeatureRecipe、プロバイダーレンダリング用の PluginProvider 固有の、レンダリングされたインフラストラクチャへの変換
プラットフォームオペレーターManifest、Releaseルーティングとデプロイの配線
横断的なサポートSchemaLibrary、MappingLibrary、WorkloadLibrary、ArtifactLibrary、Plugin、Workload共有される形状、拡張コード、プラットフォームが所有するコンパイラ種別

開発者

Aggregate — 開発者にとって唯一の作成対象であり、アプリケーショントポロジーの唯一の信頼できる情報源です。アプリケーションを構成するコンポーネント、それぞれが受け取る values、振る舞いがアプリケーションの意図である Features(その values を含む)、環境ごとの差異のために公開される parameters、そしてコンポーネント同士を配線する uses エッジを宣言します。意図的に物理インフラストラクチャに依存しない設計になっており、Aggregate のどこにもクラウド、クラスター、プロバイダーの名前は現れません。この機能非依存性こそが、1 つの Aggregate をどこにでもデプロイできるようにしています。

プラットフォームアーキテクト

Component — ある種類の構成要素のための、再利用可能でバージョン管理された契約です。JSON Schema によって、開発者が指定できる values、利用者に渡す provides 出力、配線のために公開する usesSchema ソケットを宣言します。Components は、ポリシーとレンダリングを駆動するセマンティックラベルを持ちます。アーキテクトは Component の契約を安定に保ち、開発者が依存できるようにします。

Feature — 開発者またはオペレーターがコンポーネントに追加できる、付加可能な機能です。たとえばメトリクスエクスポーター、AI ゲートウェイでの機密テキストのマスキング、認証情報のバインディングなどです。Feature は、自身が必要とするものと非互換なものを宣言します。どのように実現されるか(生成するリソース、またはそのコンポーネントがすでにレンダリングするものに書き込む設定)は、その FeatureRecipe に記述されます。

プラットフォーム運用

Recipe — Component のプロバイダー固有の実現です。Component が宣言した値を、テンプレートを通じて具体的なプロバイダーの出力(Helm リリース、Compose サービス、Terraform モジュールなど)にマッピングし、provides の値を利用者に渡します。Recipe は、Component が宣言する開発者向けの値を変更することはありません。それらをどのようにレンダリングするかを決めるだけです。

FeatureRecipe — Feature のプロバイダー固有の実現で、バインディング時に適用されます。Feature の付加が特定のプロバイダーに対して意味するリソースを生成するか、それが意味する設定を、付加先のコンポーネントがすでにレンダリングするものに書き込みます。

Provider-rendering Plugin — プロバイダーとは、Recipe の入力をプロバイダーネイティブなマニフェストに変換する Wasm ゲストです。これは pluginType: provider を持つ Plugin として提供され、レンダリングするプロバイダー名と、そのプロバイダーソケットの契約を宣言します。運用担当(またはプラグイン作成者)がプロバイダーを提供することで、Recipes はレンダリング先のプロバイダーを得られます。同梱されているプロバイダーとその契約については、Providers Overviewを参照してください。

Recipe で認証情報を安全に読み取る

認証情報は inject パイプ .context.inject.env を通じて、作成者が選んだ任意のテキストとして Recipe に届きます。そのため、テンプレートがそのままでは YAML に書き込めない文字を含むことがあります。二重引用符で囲まれたスカラーの中では、二重引用符は値を途中で終わらせ、バックスラッシュはエスケープを開始します。その結果、ビルドが停止するか、バックスラッシュが暗黙のうちに失われます。値を書き込む箇所で両方をエスケープします:

variables:
{{- $env := optional (default dict .context.inject) "env" dict }}
DB_PASSWORD: "{{ optional $env "DB_PASSWORD" "" | replace "\\" "\\\\" | replace "\"" "\\\"" }}"

optional は空のフォールバック付きでパイプのマップからキーを読み取るため、何も配信されなかったパスワードは空のテキストとしてレンダリングされます。2 つの replace 呼び出しは、まずバックスラッシュを、次に引用符をエスケープします。この順序にすることで引用符自身のエスケープが再度エスケープされることはなく、それ以外の文字はすべて元のまま残ります。キーがない場合に停止する index で読み取った値にも、同じ 2 つの replace 呼び出しをそのまま適用します。

この形式で運べない文字の 1 つが改行です。YAML は二重引用符で囲まれたスカラー内の改行を空白に折りたたむため、改行を含む認証情報は、改行のあった位置が空白になった状態で配信されます。認証情報を injectMapping に書き込む FeatureRecipe は、代わりに toJson を通じて書き込みます。FeatureRecipe リファレンスに示すとおり、こちらは引用符、バックスラッシュ、改行をいずれも同様に運べます。

その FeatureRecipe は、Recipe が認証情報を読み取るのと同じ仕組みの下に認証情報を書き込みます。すなわち、.context.inject.env 用の env:、file:、arg:、またはコンポーネント独自の仕組みであればその仕組み自身の名前の下です。.context.inject.all はそれらの仕組みから組み立てられ、マッピングの出力から組み立てられることはありません。そのため、all: の下に書き込むマッピングは何も配信しないことになります。ビルドは代わりにその時点で停止し、アタッチメント、キー、FeatureRecipe を示します。

プラットフォームオペレーター

Manifest — ルーティング層です。特定のターゲットに対して、どの Recipe が各 Component を実現するかをコンパイラに指示します。これにより、同じ Aggregate を環境ごとに異なる実装(本番環境にはクラウド用の Recipe、ローカルテストには Compose 用の Recipe など)に向けることができ、開発者のファイルを変更する必要はありません。

Release — 唯一のコンパイル入力であり、1 つの環境が何をビルドするかを記録します。Aggregate と Manifest を参照し、開発者が公開した parameters を満たし、入力が運用上のものである Features を付加し、開発者が付加したものを infra でサイズ設定し、アーキテクトが宣言したソケットの範囲内で独自のエッジを配線します。Release は公開された変動点を満たすものであり、新しいアプリケーションの values や新しいコンピュートを導入することはできません。それらは Aggregate からのみもたらされます。

横断的なサポート種別

これらの種別は、特定の役割に属するのではなく、役割をまたいで作成者を支えます。

SchemaLibrary — 多くの Components や Features にわたって繰り返し現れるスキーマ形状の共有ライブラリです。同じ構造(たとえば pod リソースのブロック)が多くのエンティティに現れる場合、アーキテクトはそれを SchemaLibrary のエントリに切り出し、定義と更新を一度で済ませます。

MappingLibrary — Recipes と FeatureRecipes が利用する、再利用可能なマッピングロジックの共有ライブラリです。共通の変換パターンをコピーせず、単一の情報源で管理できます。

WorkloadLibrary — 再利用可能な Workload コンテンツの共有ライブラリです。多くの Recipes にわたって繰り返し現れるデプロイ形状を一度だけ宣言し、各 workload: ブロックにインポートできます。

ArtifactLibrary — 再利用可能なアーティファクトバンドルの共有ライブラリです。バンドルとは、CRD とその RBAC のように、まとまって扱われる補助出力ファイルの名前付きセットです。Recipe または FeatureRecipe は 1 つの artifacts: エントリでバンドルをインポートし、その中のすべてのファイルを出力します。

Plugin — 拡張用の種別です。プロバイダーレンダリング以外にも、Plugins はドメイン固有の知能を提供する WebAssembly コードをパッケージ化します。ポリシー検証、ミューテーション、リンティング、その他のソケットなどです。Plugin の作成はプラットフォームチームの関心事であり、他のすべての役割を支えます。

Workload — プラットフォームが所有するコンパイラ種別であり、開発者やオペレーターがトップレベルのエンティティとして手書きするファイルではありません。Recipe の workload: ブロック内で使用され、そこで Recipe がレンダリングに使うプロバイダーが、正規化されたワークロード形状をそのネイティブな形式に変換します。Recipe の作成者はそのブロックを通じてこれを扱います。形状については Workload リファレンスに記載されています。

次へ