コンポジション
このページでは 1 つの考え方、つまり 1 つのコンポーネントより大きな部品からアプリケーションを構築する方法を説明します。このページは実行可能なワークスペースではありません。モジュールの境界へのルーティング — サブモジュール全体を境界に配置する では、自分でビルドするワークスペースでこれを示しています。次のコマンドで自分のフォルダーに書き出してください:
aggrega scaffold --example module-boundary-routingその後、次に実行するコマンドを表示します。
cd module-boundary-routingaggrega build --release release.yaml --auto-pullモジュール:別の Aggregate にインポートされる Aggregate
Aggregate は、別の Aggregate を aggregates: の下にモジュールとしてインポートできます。モジュールは自身のコンポーネントを構成し、自身のエッジを接続するため、その内部はインポートする側の Aggregate には一切現れません。この例では、標準ライブラリのカタログから 2 つのモジュールをインポートしています。aggregate.yaml から抜粋します:
spec: aggregates: metrics: type: core/thanos documents: type: core/ferretdbモジュールの exportedComponents ブロックは、そのパブリックインターフェイスです。モジュールの外部から接続できるコンポーネントを、それぞれエクスポートされる名前で示します。core/ferretdb は自身の proxy コンポーネントを mongo としてエクスポートするため、インポートする側の Aggregate のコンポーネントは、ドット区切りのパス documents.mongo でそれに到達します:
uses: database: main: target: documents.mongoモジュールは独自のパラメーターを宣言でき、インポートする側の Aggregate がインポートの parameters: でそれを満たします。
モジュールの配置
Release は、モジュール名をキーとする aggregates: エントリによってモジュール全体を境界に配置し、モジュールに含まれるすべてのコンポーネントがそれとともに配置されます。Release はモジュールのコンポーネントを構成することもでき、その際はそれぞれモジュール内での名前で指定します。release.yaml から、コメントを除いて抜粋します:
spec: boundaries: observability: directory: observability annotations: aggrega.ai/namespace: observability aggregates: metrics: components: query: infra: compute: cpu: 500m memory: 1Gi data: directory: data annotations: aggrega.ai/namespace: data aggregates: documents: {}モジュール自身のアノテーションは、Aggregate のアノテーションがそれ自身のコンポーネントに届くのとまったく同じように、モジュール自身のコンポーネントに届きます。そのため、モジュールは自身が宣言する名前空間にコンポーネントを配置できます。インポートする側の Aggregate は、モジュールの内部に届くものを何も宣言しません。それを行うのは Release であり、同じキーでは Release の値が優先されます。
ビルドがプロビジョニングしないサービス
すでに存在するサーバーも、グラフのノードであることに変わりはありません。接続、ポリシー、そしてそのコンシューマーが受け取るものに関与し、それに対しては何もプロビジョニングされません。その Manifest は何もプロビジョニングしない Recipe をバインドし、Release がアドレスを指定します。1 つのコントラクト、3 つの実現 では、manifest-external.yaml の Manifest が core/datastore/postgres を、ExternalName Service のみを出力する helm/postgres-external にバインドし、Release がアドレスを提供します。release-external.yaml から抜粋します:
db: infra: overrides: host: postgres.data.example.netアドレスはポインター文字列です。ビルドはそれを解決せずにそのまま渡し、アプリケーションの実行時にその名前で応答するものが、アプリケーションの到達先になります。Aggregate は、この例の 3 つの Releases すべてで同じファイルです。
サブシステム:1 つの Aggregate 内でのグループ化
サブシステムは Aggregate 内のコンポーネントをグループ化します。サブシステムで宣言されたアノテーションは、そこに含まれるすべてのコンポーネントに届き、サブシステムにアタッチされた Feature はその各コンポーネントにアタッチされます:
spec: subsystems: billing: annotations: team.aggrega.ai/owner: billing-squad aggrega.ai/namespace: billing features: metrics: type: core/prometheus-exporter components: invoice-api: type: core/compute/server payment-worker: type: core/compute/workerビルドはサブシステムのツリーをフラット化します。invoice-api と payment-worker はそれぞれ metrics のアタッチメントと両方のアノテーションを持ち、Recipe はそれを {{ index .context.annotations.aggregate "team.aggrega.ai/owner" }} として読み取ります。aggrega.ai/namespace はプロバイダーのアノテーションであるため、両方のコンポーネントを billing 名前空間にも配置します。Release は、サブシステムが付けた名前によって、各コンポーネントのエントリの下でアタッチメントの infra を構成します。また、Release が設定した名前空間は、対象となるコンポーネントについてサブシステムの名前空間を上書きします。
独自の接続先を持つアタッチメント
アタッチメントは独自の uses: ブロックを持つことができ、アタッチ先のコンポーネントではなくアタッチメント自体からエッジを引きます。あらゆるターゲットでバックアップされるデータストア では、オペレーターが core/backup をデータベースにアタッチし、そのアタッチメントをバックアップの保存先バケットに接続します。release-helm-velero.yaml から抜粋します:
spec: components: db: features: backup: type: core/backup infra: schedule: "30 2 * * *" retention_days: 14 uses: store: bucket: target: backupsデータベース自身の接続は変わりません。backups へのエッジはアタッチメントに属し、アタッチメントが引いたものとして記録され、他のエッジと同様にポリシーによってチェックされます。運用系の Feature と認証情報系の Feature も同じ方法でアタッチされ、どちらも uses: ブロックを持つことができます。