データモデル
このページでは 1 つの考え方、つまり誰がコンポーネントのどのデータを書くかを説明します。実行可能なワークスペースではありません。1 つの契約、3 つの実現では、ビルドするワークスペースでこれを示しています。次のコマンドで自分のフォルダーに書き出せます:
aggrega scaffold --example postgres-three-realizationsその後、次に実行するコマンドを表示します。
cd postgres-three-realizationsaggrega build --release release-selfhosted.yaml --auto-pullaggrega build --release release-managed.yaml --auto-pullaggrega build --release release-managed-dns.yaml --auto-pullaggrega build --release release-external.yaml --auto-pullvalues と infra:2 つの名前空間、2 人の作成者
Component は 2 つの独立した設定のセットを宣言します。その values は開発者のもので、Aggregate に書かれます。アプリケーションが必要とするもので、どの環境でも同じです。その infra はオペレーターのもので、Release に書かれます。サイジングと配置で、環境ごとに異なります。スキーマはこの 2 つを分離しています。Aggregate のスキーマにはコンポーネント上の infra がなく、Release のスキーマには values がありません。そのため、どちらの作成者も相手のフィールドを設定できません。Recipe は両方を、.values と .infra という 2 つの独立したオブジェクトとして受け取ります。
例では、開発者がデータベースとそのログインロールに名前を付けています。aggregate.yaml から示します:
spec: components: db: type: core/datastore/postgres values: database: appdb user: appuserそしてマネージドインスタンスをビルドする Release がそのサイズを決めます。コメントを省いて release-managed.yaml から示します:
spec: boundaries: stack: directory: stack components: db: infra: engine_version: "16" storage: size: 100Gi type: gp3 ha: enabled: true read_replicas: 0この例の他の 2 つの Releases は、同じ Aggregate をクラスター内で、また既に存在するサーバーに対してビルドし、それぞれが独自の infra を持ちます。Aggregate は変わりません。
それでも環境によって変えるべき値は引き上げます。Aggregate がパラメーターを宣言して値に書き込み、各 Release がそのパラメーターを満たします(ビルドのファイルを参照)。
別の Release の上に構築する Release
Release は extends: で別の Release をベースとして指定し、異なる部分だけを変更できます。子はベースの境界、配置、パラメーターを継承します。extends: と並べて aggregate: を宣言すると Release のスキーマによって拒否されます。子はベースと同じ Aggregate をビルドしなければならないからです。子は独自の Manifest を指定することも、manifest: を省いてベースのものを継承することもできます。
# release-prod.yaml: the base gives every other settingspec: extends: ./release-base.yaml boundaries: stack: components: db: infra: storage: size: 500Gi境界の directory: は他の設定と同様に継承されるため、リテラルのディレクトリを継承した子は、ベースと同じ場所にレンダリングされます。ディレクトリをパラメーターを使って書くことで、各 Release の出力をそれぞれ別の場所に送れます。複合 Release と extends による継承を参照してください。
別の Manifest の上に構築する Manifest
Manifest も同じ方法で別の Manifest を拡張でき、そのエントリは同じキーについてベースのエントリを置き換えます。開発用の Manifest は、本番用のもののバインディングをすべて保持したまま、認証情報の実現方法を変更できます。ここでは、core/referenced-secret のアタッチメントは、本番ではシークレットストアから取得され、開発では作成者が指定した値から Secret に書き込まれます。
spec: mappings: components: type: core/datastore/postgres:1.0.0: helm/postgres:1.0.0 features: type: core/referenced-secret:1.0.0: helm/k8s-external-secret:1.0.0---# manifest-dev.yamlspec: extends: ./manifest-prod.yaml mappings: features: type: core/referenced-secret:1.0.0: helm/k8s-secret-from-parameter:1.0.02 つの実現は Secret の名前を同じ方法で公開するため、認証情報を読み取るコンポーネントは、どちらの Manifest の下でも同じ参照をレンダリングします。1 つの開発者の意図、2 つの認証情報の受け渡し形態では、両方をビルドして比較しています。
2 つのラベル:型とカテゴリ
すべての Component は、予約済みラベル component.aggrega.ai/type に、閉じた集合から 1 つの値を持ちます。server は長時間稼働するエンドポイント、worker はバックグラウンドのコンシューマー、stateful-server は独自の永続データを保持するもの、task は完了まで実行されるもの、function はイベント駆動の関数、そして resource は独自のコンピュートを実行しないマネージドクラウドリソースです。この値はカタログのエンティティ上にあり、Aggregate 内のインスタンス上には決してありません。
型は、インフラストラクチャがコンポーネントをどう扱うべきかを示すものであり、コンポーネントが何のためにあるかを示すものではありません。独自のディスクを持つメッセージブローカーは、データベースとまったく同じく stateful-server です。core/messaging/kafka と core/datastore/postgres は同じ型を持ちます。読者が閲覧に使うのはもう一方のラベル component.aggrega.ai/category で、ブローカーは messaging、データベースは datastore です。これはエンティティが置かれているカタログのディレクトリでもあります。一方のラベルに対して書かれたセレクターが、もう一方のラベルに一致することはありません。