ペルソナ
Aggrega のオーサリング対象は、協働する 4 つのロールに分かれています。各ロールには固有の関心事、固有の変更頻度、そして通常オーサリングする固有のエンティティ種別があります。自分がどのロールを担っているかを理解すれば、どのファイルを開き、どの柱を埋めればよいかがわかります。
この分割はガイダンスであり、コンパイラが強制する規則ではありません。コアコンパイラは数学的に主張を持たず、スキーマ検証を通過するあらゆるオーサリングパターンを受け入れます。ロールをまとめることも自由ですし(単独の作成者は日常的に 4 つすべての役割を担います)、状況に応じて境界を越えることもできます。ロールは認知負荷を低く保ち、関心事を明確にするためにあるのであって、縛り付けるためのものではありません。この分離のアーキテクチャ上の扱いについては、チームトポロジーと 4 つのドメインを参照してください。
4 つのロール
開発者
アプリケーションの意図
Aggregate
プラットフォームアーキテクト
カタログの契約
Components
Features
プラットフォーム運用
インフラストラクチャのレシピ
Recipes
FeatureRecipes
Plugins
プロバイダー別のレンダリング用
プラットフォームオペレーター
環境ごとの接続
Manifests
Releases
通常、誰がどのファイルを書くか。この分担はガイダンスであり、コンパイラが強制する規則ではありません。小規模なチームや個人のプロジェクトでは、1 人がすべてを書きます。
開発者 — アプリケーションの意図
開発者は Aggregate をオーサリングします。これは、アプリケーションが何であり何を必要とするかを意図として表現したものです。開発者は「AWS RDS インスタンスをこのサブネットにプロビジョニングする」ではなく、「このサイズのデータベースと、それを使うサービスが必要だ」と記述します。物理インフラストラクチャは意図的にカタログと運用に委ねられるため、Aggregate はケイパビリティに依存しないままです。同じ意図が、開発者のファイルを変更することなく、ラップトップ、クラウド、エンタープライズクラスタのいずれにもコンパイルされます。
開発者が所有するもの:Aggregate が宣言するコンポーネント、それが提供する values、振る舞いがアプリケーションの意図である Features(とその values)、環境ごとの差異のために公開する parameters、そしてコンポーネント同士を結び付ける uses エッジです。
プラットフォームアーキテクト — カタログの契約
アーキテクトは Components と Features をオーサリングします。これらは開発者が利用する、再利用可能でバージョン管理された契約です。Component は、開発者が指定できる値(JSON Schema として)、利用者に提供する出力、そして配線のために公開するソケットを宣言します。Feature は、アタッチ可能なケイパビリティを宣言します。アーキテクトは「舗装された道」、つまり開発者が注文する自動販売機を構築し、そこから提供されるものが適切な形をしていることを保証します。
アーキテクトが所有するもの:開発者の値を検証する schema:、provides の出力、usesSchema のソケット、そしてセマンティックな識別情報を担うラベルです。アーキテクトは物理インフラストラクチャを記述せず、それへのインターフェースを定義します。
プラットフォーム運用 — インフラストラクチャのレシピ
運用は Recipes、FeatureRecipes、およびプロバイダーをレンダリングする Plugins をオーサリングします。これらは、カタログの契約をレンダリングされたインフラストラクチャへと変換する、プロバイダー固有の変換です。Recipe は、Component が宣言する開発者向けの値を変更することなく、Component の宣言された値を Helm、Docker Compose、Terraform といった具体的なプロバイダーにマッピングします。FeatureRecipe は、バインド時に Feature に対して同じことを行います。
運用が所有するもの:開発者の values とオペレーターの infra のサイジングからプロバイダーネイティブな出力をレンダリングするテンプレート、そして Recipe が利用者に渡す provides の値です。運用エンジニアは既存のインフラストラクチャコードを Recipes としてパッケージ化することで再利用でき、カタログ固有のポリシー言語を習得する必要はありません。
プラットフォームオペレーター — デプロイの配線
オペレーターは Manifests と Releases をオーサリングします。これらはルーティング層と、環境ごとのコンパイル入力です。Manifest は、特定のターゲットに対して各 Component をどの Recipe が実現するかをコンパイラに伝えるため、同じ Aggregate が環境ごとに異なる実装に到達できます。Release は単一のコンパイル入力です。Aggregate と Manifest を指し、開発者が公開したパラメーターを充足し、入力が運用上のものである Features をアタッチし、開発者がアタッチしたものを infra でサイジングし、アーキテクトが宣言したソケットの範囲内で独自のエッジを配線します。
オペレーターが所有するもの:Manifest のルーティングマップ、Release のパラメーター充足、各コンポーネントに割り当てられる infra のサイジング、入力が運用上のものである Features のアタッチ、そして Release が接続に記述するエッジごとの infra です。オペレーターは開発者が公開した変動点を充足します。Release が新しいアプリケーションの値や新しいコンピュートを導入することはできず、それらは Aggregate からのみもたらされます。
ロールは役割であり、人数ではない
大企業では、これら 4 つのロールは専門知識も変更頻度も異なる別々の部門です。カタログはプラットフォームチームが新しいケイパビリティをリリースしたときに進化し、Recipes はインフラストラクチャが変わったときに進化し、Releases はデプロイごとに変わります。小規模チームや個人プロジェクトでは、1 人がすべての役割を担います。Components と Recipes は共有可能でバージョン管理されたアーティファクトであるため、作成者は多くの場合、純粋に開発者ロールにとどまり、それ以外のすべてについては構築済みのカタログを利用できます。
次にロール別エンティティを読み、4 つのロールすべてを支えるライブラリとプラグインの種別を含む、種別とロールの完全な対応表を確認してください。