ガバナンスとコンプライアンス
この章では、プラットフォームチームが、ガバナンスソケット、カタログのベースラインとスキーマ、そしてカタログ作成者が従う慣例を通じて、ポリシーをコンパイラにハードコードすることなく、すべてのビルドにわたって企業のコンプライアンスを適用する方法を定義します。Day-2 のライフサイクルイベントについては Day-2 Lifecycles で扱います。
エンタープライズのガバナンスとコンプライアンスのパターン
プラットフォームエンジニアリングにおける中心的な課題は、オープンソースのカタログを汚染することなく、企業のガバナンス(SOC 2 コンプライアンス、FinOps のコストセンター追跡、厳格なオーナーシップのマッピングなど)を適用することです。
Aggrega が公式のコンポーネントにドメイン固有のロジックをハードコードすれば、主張を持たないコンパイラではなくなり、主張を持つフレームワークへと堕してしまいます。逆に、コンプライアンスを完全に開発者に任せれば、重要なタグはスペルを誤られ、忘れられ、あるいは回避されます。
これを解決するため、Aggrega はコンプライアンスのための Wasm ソケットの仕組みを提供し、エンタープライズがポリシーを決定します。エンタープライズは、自らのエコシステム内で 2 つの異なる社会契約を採用することで、ゼロトラストのガバナンスを実現します。
1. 「Bring Your Own Baseline」(BYOB)+ Wasm 検証ゲート
開発者が提供する静的なデータ(チームのオーナーシップやデータ分類など)について、エンタープライズは生のオープンソースカタログに直接依存すべきではありません。代わりに、Platform Architect が企業ベースライン(すべての社内コンポーネントが持たなければならないフィールドで、SchemaLibrary のエントリで一度だけ宣言されます)を作成し、ガバナンスの判定ロールを使ってその使用を強制します。
カタログの契約: エンタープライズは、特定のタグを必須とするものの、インフラストラクチャを一切プロビジョニングしないベースラインを作成します。
apiVersion: aggrega.ai/v1beta1kind: SchemaLibrarymetadata: name: CorporateBaseline version: 1.0.0spec: schemas: Ownership: type: object properties: owner: { type: string } cost_center: { type: string } # The developer MUST provide these, or the schema validator halts the build required: [owner, cost_center]各社内コンポーネント(例: acme/datastore/postgres)は、自身の schema: からそのエントリを参照し、自身に固有の値を追加します。これにより、共有フィールドとコンポーネント自身のフィールドがまとめて検証されます。
apiVersion: aggrega.ai/v1beta1kind: Componentmetadata: name: acme/datastore/postgres version: 1.0.0 labels: component.aggrega.ai/type: stateful-serverspec: schema: values: $ref: "CorporateBaseline#/schemas/Ownership" properties: database: { type: string } required: [database]ベースラインがベースの Component ではなくライブラリのエントリであるのは、extends: を記述する Component はベースの schema: を丸ごと受け取り、自身の値を宣言しないためです(継承と公開の規律を参照)。
Wasm 検証のフェイルセーフ:
開発者が社内カタログを迂回し、公開ハブから素の core/postgres コンポーネントを直接取り込むことを防ぐため、エンタープライズはトポロジー検証プラグインを登録します。このプラグインは静的解析の間、つまりグラフが組み立てられた後、かつどのアーティファクトもレンダリングされる前に評価されます。そのため、一度に 1 つのコンポーネントではなくトポロジー全体を見ることができます。
# Evaluated by the governance ir-verdict role over the assembled graphpackage acme.governance
import rego.v1
deny contains msg if { some id, _ in input.graph.spec.nodes not input.graph.spec.values_mapping[id].owner msg := sprintf("node %v declares no owner; use a component whose schema references 'CorporateBaseline#/schemas/Ownership'.", [id])}ポリシーが deny キーの下に集めた判定は拒否であり、それによってビルドは停止します。
自由形式の接続の禁止:
開発者は、カタログが宣言していないソケット、つまりアドホックなソケットを通じてエッジを配線できます(dependency-resolution を参照)。この開放性は意図的なものであり、コンパイラがそれについて何の意見も持たないことも同様です。すべての接続を Architect が宣言したソケット経由にしたい組織は、コンパイラに頼るのではなく、それをポリシーとして表現します。グラフ内のすべてのエッジは socket_declaration を持ち、その値は declared または ad-hoc であるため、ルールは 1 行で済みます。
# Evaluated by the governance ir-verdict role over the assembled graphpackage acme.governance
import rego.v1
deny contains msg if { some e in input.graph.spec.edges e.socket_declaration == "ad-hoc" msg := sprintf("%v connects to %v through the free-form socket %v; declare the socket in the component type's usesSchema.", [e.source, e.target, e.socket])}この値は、エッジがどのように記述されたかにかかわらず、すべてのエッジに常に存在するため、ポリシーが欠落したフィールドを「declared」と解釈する必要はありません。また、これは独立した軸です。ソケットがどこから来たかを示すものであり、誰がエッジを引いたかを示すものではないため、origin_feature や origin_release と重複せずに組み合わせられます。ポリシーは、自由形式の接続を禁止しつつ、Release が宣言済みの接続を配線することは引き続き許可できます。
一元化されたエンタープライズガバナンス(完全な実態の評価): 帯域外の仕組み(git リポジトリの CODEOWNERS など)がレビューするのは変更されるファイルであり、それらがコンパイルされてできるアーキテクチャではありません。ガバナンス判定ロールはアーキテクチャそのものを判定します。AOT コンパイラは開発者の Aggregate と Platform Operator の Release の両方をフラット化して IR グラフを構築するため、ir-verdict ロールのポリシーは物理的なアーティファクトが生成される前に完全な実態を評価し、render-verdict ロールのポリシーはアーティファクトそのものを評価します。開発者が未承認の Component を要求した場合、あるいは、レンダリングされた各オブジェクトに刻印された aggrega.ai/recipe-uri の来歴を読み取ることで、Manifest がコンポーネントを未承認の Recipe にマッピングしていると判明した場合、ポリシーはビルドを致命的に停止できます。
2. Wasm ミューテーターゲート(動的コンプライアンス)
環境に関するコンプライアンスタグ(例: environment: production や soc2_in_scope: true)は GitOps のターゲットによって変わるため、開発者がそれらを自分の Aggregate に手入力することを強いられるべきではありません。
動的なメタデータについて、エンタープライズはミューテーションゲート、つまりガバナンスソケットの label-transform ロールを利用します。これはトポロジーの構築中に実行されます。グラフが展開された後、かつ静的解析がそれを評価する前に、コンパイラはエンタープライズがアタッチした Wasm プラグインを実行します。そのプラグインは Release の環境、ノードがすでに宣言しているラベル、各ノードのインスタンスが宣言する値を読み取り、ビルドのノードが持つべきラベルを指定します。これにより、開発者が入力しなくても必要なメタデータがコンポーネントに届きます(例: Release の環境から決定されるラベル compliance.aggrega.ai/data-class: restricted、またはデータベースが宣言する拡張機能から決定される datastore.aggrega.ai/engine: vector)。値は読み取り専用です。プラグインが決めるのはラベルだけです。
このロールのポリシーは、ビルドが適用する編集命令を記述するのではなく、ラベルを指定します。つまり、ノード、キー、そしてそのキーがとる値です。この理由は、ポリシーを作成する人にとって重要です。編集命令はラベルをパスで指定しますが、Aggrega のラベルキーには通常 / が含まれ、これはパスの区切り文字であるため、手書きのパスでは 1 つのラベルではなく入れ子になった場所を指してしまいます。ビルドは判定が指定したラベルを対象とします。また、このロールが受け取るノードの射影では、ノードの位置がグラフ全体に対する判定よりも 1 階層浅くなります。
# Evaluated by the governance label-transform role, during topology constructionpackage acme.tagging
import rego.v1
labels contains {"node": id, "key": "acme.com/soc2-scope", "value": "true"} if { input.compilation_context.environment == "production" some id, node in input.graph.nodes node.labels["component.aggrega.ai/type"] == "stateful-server"}これらのタグはレンダリングの開始前にメモリ上で標準のメタデータ辞書に注入されるため、Wasm レンダリングプラグインはそれらを読み取り、アーティファクトのレンダリング時に特定の物理的な設定(たとえば強化された AWS や Kubernetes のリソース)を条件に応じて生成できます。
ルールを一度だけ記述する: ガバナンスのアタッチメントはワークスペーススコープです。
上記の 2 つのパターンはコンポーネントごと、Feature ごとに記述されますが、それらを適用するガバナンスのアタッチメントはそうではありません。ガバナンスプラグインはワークスペース設定の plugins.governance キーでアタッチされ、そのアタッチメントはワークスペース内のすべてのビルドに適用されます。したがって、企業のルールはちょうど 1 か所で記述されます。プラットフォームチームがプラグインを一度アタッチすれば、それが適用されるためにコンポーネント、Aggregate、Release のいずれもオプトインしたり、言及したり、編集されたりする必要はありません。これにより、パターン 1 の検証フェイルセーフは、プロジェクトごとの慣例ではなく完全な解決策になります。社内カタログを迂回して素の core/postgres を要求した開発者も、ほかの全員と同じアタッチ済みのポリシーで評価されます。ポリシーは、開発者が選んだコンポーネントではなく、ワークスペースの属性だからです。
ワークスペースのルールは拒否するものであり、開発者の契約を書き換えるものではありません。 スコープは全体に及びますが、その効果は意図的に判定に限定されています。あらゆる場所に適用されるルールは、それに違反するビルドを停止させて修正すべき点を示しますが、違反しているコンポーネントを修正してコンプライアンスに適合させることはできません。この境界こそが、大規模な環境全体でもこの仕組みをデバッグ可能に保っています。ビルドは、ワークスペースが宣言するルールに適合するか、記述された行を指すメッセージとともに停止するかのいずれかであり、レンダリングされた出力には、どの記述ファイルも要求していない制約やリソースが含まれることはありません。エンタープライズが判定ではなくグラフの変更を望む場合は、変換ロール(上記のパターン 2)をアタッチします。その変更は、オペレーターがアタッチした目的の範囲に限定されます。そのため、それは目に見えない書き換えではなく、プラットフォームチームによる明示的な行為となります。
コンプライアンスの輪を閉じるプラットフォームチームにとっての実際的な帰結は次のとおりです。ペイロードが持つべき形は企業ベースラインのスキーマ制約として表現し、環境全体が必要とするエンティティ横断のルールはアタッチした判定ロールとして表現し、開発者が決して入力すべきでない派生メタデータはアタッチした変換ロールとして表現します。3 つとも一度だけ宣言され、すべてのビルドに適用され、いずれも開発者がその存在を知っている必要はありません。
3. ドメインインテリジェンスの保持(構成と安全性)
Aggrega コンパイラは主張を持たないため、AI フレームワーク、トークン予算、メモリ分割に関するハードコードされた知識を一切持ちません。代わりに、汎用的なクラウドネイティブスキーマが空の器として機能します。高度に専門化されたドメインインテリジェンスは、コンパイラのコアにハードコードされるのではなく、拡張可能な Aggrega エコシステム全体に分散されます。それは、専用の components、features、recipes を通じて Platform Catalog 内にカプセル化されます。開発者は、自身のアプリケーション固有の意図を values ブロックと uses ブロック内に保持します。これらは Architect の schema: 宣言(コンパクト形式または完全な JSON Schema 2020-12)と usesSchema ソケットによって厳密に管理されます。一方、そのインテリジェンスの物理的な変換は、ターゲット固有の WebAssembly プラグインによって実行されます。
A. ドメイン固有の実装のモデリング(分割スキーマによる検証)
Platform Architect は、分割スキーマのパイプラインを活用することで、コアコンパイラから完全に独立して、あらゆる複雑なアーキテクチャをモデル化できます。
- 不透明な実行ロジック(
values): エンタープライズが AI Gateway をデプロイする場合、開発者はゲートウェイ自体の動作を設定します。標準ライブラリの AI ゲートウェイでは、呼び出し元が要求できる各エイリアスと、それぞれが解決される先のアップストリームを公開するmodelsマップがこれにあたります。コアコンパイラはこれらの概念を解析しません。これらは不透明なvaluesペイロード内に安全に格納され、コンポーネントのschema:宣言によって厳密に検証されます。コンパイラは、ゲートウェイの設定を生成するために、このペイロードを Wasm プラグインに渡すだけです。フォールバックチェーン、リトライ回数、同じエイリアスを公開するエントリ間の選択など、複数のゲートウェイ製品に共通する制御は、ゲートウェイ上の値ではなくゲートウェイにアタッチされる Features であり、それぞれがそのゲートウェイ自身の用語でゲートウェイ向けに実現されます。 - トポロジー上の依存関係のマッピング(
uses): AI フレームワークがエージェントをそのツールやベクトルデータストアに接続する場合、その接続は誰が誰と通信するかを決定するため、usesの柱で宣言します。標準ライブラリのtools_allowedのようにvaluesに保持される名前のリストは慣例であり、エッジを描画しません。コンパイラは、これらの明示的なエッジを IR グラフにそのまま描画します。これにより、下流の Wasm レンダリングプラグインは、コンパイラが基盤となる AI フレームワークを理解することなく、接続を保護するために必要なネットワークポリシーと物理的な境界をプログラムで生成できます。 - 複雑なデータ構造(例:CoALA): Architect は、ターゲットの 1 つのフラットなリストに限定されず、構造が必要とするだけのソケットを
usesSchemaに宣言でき、各ソケットは独自のセレクターと独自のエッジごとのvalueSchemaを持ちます。たとえば CoALA フレームワークを実装するために、Architect はsemantic_memory、episodic_memory、working_memoryを個別のソケットとして宣言でき、各メモリストアが個別のトポロジー上のターゲットになります。汎用的なポリシーエンジンはこれらの構造化されたエッジを評価し、個々の認知ローブごとにきめ細かなアクセス制御のガードレールを必須にします。
B. コアのセキュリティと間接参照のメカニズム
ペイロードは主張を持ちませんが、汎用スキーマは安全なアーティファクト生成を支える厳密な構造上のメカニズムを強制します。
- 値ではなくアタッチメントとするパターン: 標準ライブラリの慣例では、認証情報は アタッチメント として要求され、コンパイラがそのまま運ぶインラインリテラルとなってしまう
valuesブロックに書き込まれることはありません。認証情報のアタッチメントは、認証情報の Featuretype(feature.aggrega.ai/kind: secretのラベルが付いたもの)を指定し、自身のvaluesを使用してシークレットストアに対するクエリを記述します。これにより、認証情報のルーティングはケイパビリティに依存しない遅延バインディングとなり、コアコンパイラがその内容を解決したり公開したりすることはありません。Ops の Recipe が提供したポインタを受け渡すだけです。これはカタログとスキーマが推奨する慣例であり、コンパイラによるチェックではありません。コンパイラはvaluesのリーフが何を意味するかを解釈しないため、作成者が内容をインラインで書けば、それはインラインのまま扱われます。スキーマが 実際に 保証するのは、アタッチメントの仕組みが存在し、型付けされていることです。 - 抽象的な信頼検証:
valuesブロックは幅広く拡張可能であるため、Architect はtls_pinningやrequired_signatures: 2(Quorum コンセンサス用)といった抽象的なディレクティブを必須にできます。コアコンパイラは、これらのスキーマ検証済みのオブジェクトをフラットな IR グラフにそのまま渡します。カスタムの Wasm レンダリングプラグインは、これらの値を読み取り、ハードウェアレベルの Human-in-the-Loop(HITL)承認ゲート用のアーティファクトを生成できます。アプリケーションがコンセンサスルールを回避しようとした場合、物理的にデプロイされたプロキシが、Webhook による承認を受け取るまで実行をブロックします。
C. 高度な運用上の安全性(spec.interoperability)
脆弱なワークロードを競合するインフラストラクチャの変更から保護するために、汎用の Feature スキーマは相互運用性の制御を定義しています。
spec.interoperability.conflictsWith— この Feature と同じコンポーネントに到達できない Features のリストです。1 つのコンポーネントが最終的に持つアタッチメント(コンポーネント自体、それを保持するサブシステムまたは境界、その Release のコンポーネントエントリ、アノテーション駆動の展開という、それに到達するすべてのスコープから収集されたもの)に、この Feature とそれが指定する Feature が含まれる場合、コンパイラはレンダリング前にビルドを停止します。これは Feature の作成者が宣言した名前と、コンポーネントが持つ Features とを比較するものであり、どちらにも意味を読み込みません。非互換性は作成者の判断であり、コンパイラはビルドをその判断に従わせます。宣言は片方だけで十分であり、名前はバージョンにかかわらず照合され、コンポーネントを共有しない兄弟の境界にアタッチされた 2 つの Features が出会うことはありません。
4. ネットワーク境界のガバナンス (デフォルト拒否の慣例)
開発者はネットワークポリシーを直接記述しません。必要なネットワーク境界はコンパイラの中間表現 (IR) グラフによってマッピングされ、このグラフは Aggregate で宣言されたコンポーネント間のすべてのトポロジカルなエッジを保持します。
- 内部境界。 コンパイラはフラットな IR グラフを描画するだけで、それ自体は何も制限しません。ポリシーがなければ、クラスタのネットワークが許可するすべての接続は到達可能なままです。慣例として、コンポーネントのために書かれたポリシーは、ポリシー自身のアタッチメントが指定するものに加えて、Aggregate がエッジを宣言している接続のみを許可し、そのポリシーが管理する方向の他のすべての接続を拒否します。
- 標準ライブラリによる実現。 標準ライブラリのカタログは、この慣例を、オペレーターが Release でコンポーネントにアタッチする 2 つの Features として実現します。接続の方向ごとに 1 つです。
core/caller-allowlistは、usesエッジがそのコンポーネントを指しているコンポーネントからの接続のみを受け入れ、core/egress-allowlistは、そのコンポーネント自身のエッジが指すコンポーネントとクラスタの DNS にのみ接続を許可します。helm ターゲットでは、それぞれが FeatureRecipe によって実現されます。この FeatureRecipe は、コンパイラから渡されたエッジから Kubernetes NetworkPolicy を書き出し、各コンポーネントの Pod を、そのコンポーネント自身のレンダリングが出力したもの、すなわちそのワークロードが持つセレクタとラベル、出力先の名前空間、コンテナが宣言するポートから指定します。そのため、ラベルやポートを手作業で再記述することはありません。それぞれはまた、コンポーネント自身の Pod と、Release がアタッチメントで指定するものも受け入れます。受信側では Aggregate 外部のソース、送信側ではクラスタが実行しないターゲットのアドレス範囲です。そうしたターゲットは選択する Pod をレンダリングしないため、範囲によってのみ、任意のポートで受け入れられます。コンパイラはクラスタを検査できないため、それぞれは、クラスタのネットワークプラグインがネットワークポリシーを強制することを Release が明示するまでビルドを停止します。compose にはネットワークポリシーがなく、そこでいずれかをアタッチするビルドは停止します。 - パブリックイングレス (依存しない境界制御)。 パブリックイングレスは、ガバナンス判定ロールにおける企業独自のルールによって管理されます。企業のセキュリティチームは、ノードのクラウドネイティブなオントロジー型を評価し、開発者が
workerまたはtaskノードにpublic-ingressフィーチャーをアタッチしようとした場合にビルドを拒否するポリシーを作成できます。コンパイラは「パブリック」が何を意味するかを解釈しません。Wasm 検証ゲートのブール値出力を強制するだけです。
5. コンパイル時の来歴スタンプ
コンパイラはコンパイル中に来歴レコードを構築し、コンパイラのバージョンと、コンパイルした Aggregate、Manifest、Release のバージョンを記録します。タイムスタンプは含まないため、このレコードがバイト単位で同一の出力を損なうことはありません。helm レンダラーはコンパイラのバージョンを生成された Kubernetes マニフェストに aggrega.ai/compiler-version ラベルとして出力し、helm-chart レンダラーは chart 自身のテンプレートを変更せずにコピーするため、Recipe が chart に追加するテンプレートファイルに出力します。企業のセキュリティチームはこれを使って、どのレンダリング済みアーティファクトがどのコンパイラバージョンでビルドされたかを特定します。これは、特定のコンパイラリリースで脆弱性が発見され、影響を受けるアーティファクトを監査する必要がある場合に重要です。
compose プロバイダーは同じ来歴キーをサービスラベルとして、terraform プロバイダーは組み立てる各モジュール内の来歴ファイルとして、cloudformation プロバイダーは各リソースの Metadata の下に刻印します。メモリ上の来歴レコードはすべてのコンパイルに存在します。
6. 拡張面としてのメタデータとアノテーション
Go コンパイラは、AI フレームワーク、データベースエンジン、Kubernetes のイディオムといったドメイン固有の概念に依存せず、IR に対するフラットなグラフレベルの操作のみを行います。ドメイン固有のロジックを Go バイナリにハードコードせずにエコシステムを駆動するため、プラットフォームは標準のメタデータラベルとアノテーションをドメイン知識の拡張面として使用します。
コンパイラはドメイン固有のアノテーションを一切読みません。開発者が指定したすべてのアノテーションとダックタイピング用のラベルをフラットな IR グラフにまとめ、このメタデータをそのままガバナンスプラグインとレンダリングプラグインに渡します。WebAssembly エコシステムがメタデータを解釈し、コンプライアンスポリシーの評価、クラウドネイティブなアーティファクトへのタグの注入、フィーチャー展開のトリガーといった必要なロジックを、コアコンパイラから独立して実行します。
これにより、拡張面を広く保ちつつ (誰でも新しいアノテーションプレフィックスを読む Wasm プラグインを作成できます)、コアコンパイラを安定に保てます。エコシステムが新しいドメイン固有のアノテーションを追加するのに、コアのリリースは必要ありません。
ポリシーがアタッチメントについて読み取る内容
IR グラフを評価する判定ロールは、グラフ全体を受け取ります。ただし、後述するとおり、作成者が機密と宣言した値はすべて伏せられます。これには各ノードが持つすべてのアタッチメントが含まれ、作成者が付けた名前をキーとします。ノードの接続の一つに記述されたアタッチメントの場合は、接続のエイリアスとスロットをドットでつないだものがキーになります。要約ではなくアタッチメントの詳細を渡す理由は、Aggrega には要約すべき意見がないからです。コンパイラはアタッチメントの中身を判断せずにルーティングするため、ポリシーが判断に必要とする事実が、そのままポリシーに渡される事実になります。
アタッチメントごとに、グラフは次の情報を持ちます。
- 要求する Feature の型と、それに対して解決されたカタログのバージョン。 型は作成者が書いた文字列そのままです。バージョンを固定した参照と固定しない参照は、同じ参照先を指していても異なる文字列になるため、型を比較するポリシーはどちらの表記も想定する必要があります。
- アタッチされた Feature のカタログラベル(そのまま)。 フィルタリングも正規化もされず、カタログエンティティが宣言した順序のままです。ポリシーは、Aggrega が関知しない作成者独自のラベルも含め、カタログ作成者が書いたとおりの内容を読み取ります。
- アタッチされた Feature のカタログアノテーション(そのまま)。 Feature エンティティ自身の
metadata.annotationsで、ラベルとまったく同じ条件で渡されます。つまりフィルタリングも正規化もされず、エンティティが宣言した順序のままなので、作成者独自の名前空間にあるアノテーションキーも書かれたとおりに届きます。これは、アノテーション展開によるアタッチメントをそもそも生じさせたアノテーションとは別の話です。グラフはその由来を別途報告し、features:ブロックに記述されたアタッチメントは、エンティティのアノテーションを持ちながら展開の由来は一切報告しません。 - どの宣言済みアタッチメントスロットを埋めるか。
featuresSchemaのスロットは、スロット名で Feature をアタッチすることで埋められます。そのため、Component が宣言するスロットを指定したアタッチメントはそのスロット名を報告し、どのスロットも埋めないものはfreeを報告します。接続に記述されたアタッチメントは、接続のソケットが宣言するスロットを埋め、そのスロット名を報告します。ソケットは他の名前を受け付けないため、freeを報告することはありません。値がフラグではなくスロット名であるのは、どの結合ポイントが埋められたかのほうが、通常は答えとしてより有用だからです。 - どの接続に記述されたか(該当する場合)。 コンポーネントの接続の一つに記述されたアタッチメントは、その接続のソケットとエイリアスを持ちます。これらは、アタッチメントが提示されるグラフのエッジを示し、そのエッジを通じて提示先のコンポーネントを示します。コンポーネント自身のブロックのアタッチメントはどちらも持ちません。接続はアタッチメントの名前から読み取らせるのではなく、データとして渡されます。名前にはエイリアスは含まれますが、ソケットは含まれないためです。
- 作成者が機密と宣言した素材を扱うかどうかと、その素材をどの配信キーが運ぶか。どちらも宣言から導出されます。すなわち Feature のスキーマ上の
sensitiveなリーフや、利用側 Component 上のsensitiveなスロット(自身のアタッチメント用に宣言したものか、接続が通るソケット上のものかを問いません)から導出され、値を調べて導出されることはありません。 - その
values、そのinfra、およびその配信マッピング、さらにアタッチメントがfeatures:ブロックに記述されたものか、アノテーション駆動の展開によって追加されたものか。ただし、次の段落で説明するとおり、作成者が機密と宣言した値はすべて伏せられます。
ポリシーには機密と宣言された素材の所在が伝えられますが、素材そのものが渡されることはありません。 グラフが機密宣言済みとしてマークした各リーフは、任意のアタッチメントの values や infra 内(どのスコープや接続に記述されたかを問いません)、境界アタッチメントの infra 内、ノード自身の values と infra 内、接続自身の values と infra 内のいずれにあっても、値の代わりに単一キーのマーカー {"aggrega_withheld": "declared"} としてポリシーに届きます。キーは残るため、ポリシーはペイロードがどのリーフを持つかを引き続き把握できます。それらのリーフを示すマーキングも残るため、どのリーフが宣言済みの素材を持つかも把握できます。さらに上記の事実はすべて従来どおり届き、どの宣言にもマークされていない値もすべて届きます。ポリシーが推論に使う事実、つまりアタッチメントが何であるか、何を埋めるか、何に提示されるか、そのカタログエンティティが何を述べているか、そしてその秘密の素材がどこへ流れるかは、いずれも作成者が機密と宣言できる値ではありません。そして素材そのものは、それがどこへ行くかを判断するうえでポリシーが必要としない唯一のものです。これは、コマンドラインがグラフを出力するときや、デーモンがエディタからのグラフ要求に応答するときに適用するのと同じ秘匿処理です。それらの経路では明示的に要求した人に値が返されますが、ポリシーのコピーにはそのような要求の手段はありません。この処理はポリシーのコピーにのみ適用されます。ビルドがレンダリングに使うグラフには手を加えないため、レンダリングされるバイトは一切変わりません。
アタッチメントのラベルがコンパイラを拘束するのはただ一箇所であり、それはポリシー判断ではありません。スロットは selector を宣言でき、ラベルがそれを満たさないフィルはビルドを停止させます。このゲートを過ぎると、ラベルは何も左右しません。値のルーティングと配信は、Feature がどのラベルを持っていても同じです。したがって、ラベルを読むポリシーは、コンパイラが解釈せずに運んだメタデータを読んでいるのであり、コンパイラ内部の分岐を推し量っているわけではありません。
Feature のカタログアノテーションは、どこでもコンパイラを拘束しません。それに基づいて分岐するコンパイラの動作はなく、スロットはラベルに対してできるような制約をアノテーションに対しては宣言しません。アノテーションは運ばれるだけです。
これにより記述可能になるルールの例です。いずれもコンパイラが代わりに設けるものではありません。
- 自由形式のアタッチメントを禁止する。 すべてのアタッチメントに宣言済みの結合ポイントを埋めることを求める環境では、
freeを報告するアタッチメントをすべて拒否します。これはアタッチメントの面が開かれていることの裏返しです。構成はデフォルトで自由であり、自由にしたくないオペレーターはそう表明します。 - 機密素材の値渡し配信を拒否する。 Aggrega は、機密と宣言されたデータがリテラルとして配信キーを通る場合に警告しますが、停止することはありません。値渡しの認証情報ファミリーは意図的なものです。その警告を拒否にしたいオペレーターは、ここでそれを表現します。
- 何を認証情報とみなすかを自分で決める。 標準ライブラリは認証情報の Features にファミリーラベルを付けており、そのラベルを読むことはそれらを推論する方法の一つです。より広い、あるいはより狭い述語(内部ラベル、命名ルール、承認済みの型の集合など)も同様に利用できます。届くのはラベルそのものであり、ラベルについての判定ではないからです。
- カタログが自身のメタデータに記録するものに基づいてゲートを設ける。 レビュー状況、データ所在地、所有者を Feature エンティティのアノテーションとして保持している環境では、それらをすべてのアタッチメントに要求できます。Aggrega が一度も聞いたことのないアノテーションをキーにしたルールも、Aggrega が同梱するキーをキーにしたルールとまったく同じように機能します。アノテーションは書かれたとおりに届くからです。これは、Feature と Component が同じ基準で、つまりそれぞれのエンティティが宣言するカタログメタデータによって判断されることも意味します。
- コンポーネントが何を誰に提示するかを統制する。 接続に記述された認証情報はその接続を示し、接続のエッジはその提示先を示します。そのため環境は、独自のラベルでマークした信頼ゾーンの外にあるコンポーネントに提示される認証情報を拒否できます。これは接続の両端を必要とする判断であり、利用側コンポーネント単独の事実では提供できません。
判定ロールは受理または拒否を行うだけで、書き換えることはありません。ビルドは変更されずに進むか、判定のメッセージとともに停止するかのいずれかです。そのため、ポリシーが非準拠のグラフを密かに準拠させることはできません。
アタッチメントの詳細が届くのは、IR グラフを評価するポリシーです。レンダリングされた成果物を評価するポリシーは、その成果物を受け取り、グラフは受け取りません。これはその入力の性質であり、入力に課された制限ではありません。2 つの段階は異なる問いに答えるものであり、アタッチメントのトポロジーは、レンダリングされた出力に問える問いには含まれません。
エステートのルールをポリシー言語で表現する
上記のパターンはガバナンスのアタッチメントが何を行うかを説明するものです。このセクションでは、それを得るためにエンタープライズが何を書くかを扱います。記述すべきルールを 50 個抱えるプラットフォームチームは、50 個のプラグインを望みません。 望むのは、ルールをコンテンツとして、つまり他の成果物と同様にレビューし、バージョン管理し、 出荷するファイルとして扱い、それを 1 つのアタッチされたエンジンで評価することです。
それを提供するのが、ソケットにアタッチされたポリシー言語エンジンであり、まさにこの目的のために 2 つのエンジンが コンパイラに同梱されています。Rego エンジンと CEL エンジンです。 オペレーターはそのいずれかをアタッチし、読み込むべきポリシーファイルを宣言すれば、ルールが実行されます。 外部ツールチェーンは不要で、ビルド時に何も取得せず、コンパイラにポリシーロジックはありません。 評価は WebAssembly ゲスト内で行われ、そこにすべてのドメインの知識が 存在します。
同じエンジンがすべてのガバナンスロールに対応するため、エステートは 1 つのアタッチされたプラグインと そのアタッチメント複数個で、サーフェス全体をカバーできます。
- アーキテクチャの判定。 ビルドグラフに対してアタッチされると、ポリシーはコンパイラが保持するすべての ノード、エッジ、アタッチメントに加え、それらと併せて列挙されるルーティングパスを読み取り、 ビルドを停止すべきものを報告します。トポロジーの不変条件、境界をまたぐ認可ルール、 クレデンシャルの流れに関するルールはここに置かれます。
- 出力の判定。 レンダリングされた成果物に対してアタッチされると、ポリシーはビルドが生成した ファイルを、テキストとして、またフォーマットがポリシーより前にパースされている場合はパース済みドキュメントとして 読み取り、具体的な結果について報告します。
- 派生メタデータの供給。 ラベルを形成するためにアタッチされると、ポリシーは Release の環境と ノードがすでに宣言している内容から、ビルドのノードがどのラベルを持つかを決定します。 これは上記のパターン 2 が説明する仕組みであり、ルールは専用のプラグインではなく ポリシーコンテンツとして表現されます。
- 開発者が記述していない機能の追加。 アノテーションを注入するためにアタッチされると、ポリシーはビルドのコンポーネントにアノテーションを追加します。Manifest がバインディングを登録しているキーの下のアノテーションは Feature アタッチメントに展開されるため、企業のルールはコンポーネントに必要なラップが欠けていることを単に拒否するのではなく、それを供給できます。判定は、オペレーターがそのアノテーションに書けるあらゆる値(文字列、または複数の値を振り分けるバインディングではサブキーのオブジェクト)を書き込むことができ、ビルドはそれを Release に書かれた同じ値とまったく同じように読み取ります。判定にできるのは追加だけです。アノテーションを削除またはオプトアウトする値は拒否され、ビルドが振り分けられない注入値やバインドされた Feature が受け入れない注入値は、注入したプラグインを名指しして拒否されます。
ルールはペイロードが持つ内容を読み取り、名前付きキーの下で判定を報告します。
# Evaluated by a governance verdict role over the assembled graphpackage acme.security
import rego.v1
deny contains msg if { some id, node in input.graph.spec.nodes node.labels["compliance.aggrega.ai/data-class"] == "restricted" not node.labels["acme.com/owner"] msg := sprintf("node %v holds restricted data and declares no owner.", [id])}グラフに沿ってデータを追跡するルールは、ペイロードが列挙するルートを読み取ります。language-reference/examples/policy-data-class-route/ はそのエンドツーエンドの例です。あるクラスのデータを保持するコンポーネントが、非機密化する Feature がアタッチされていないルートに沿って別のクラスのコンポーネントに到達するビルドを停止し、Release がそのトラフィックを core/data-masking を持つゲートウェイ経由でルーティングすると、同じ Aggregate が完了します。コンパイラはクラスラベルを文字列として運ぶだけで、何も順位付けしません。クラス、その順序、非機密化とみなす Features はアタッチメントの設定です。このルールは 3 つのエンジンそれぞれに対して 1 回ずつ書かれています。CLI にコンパイルされた 2 つと、リファレンスアダプターゲストの背後にある OPA です。各コピーは独立しているため、2 つのエンジンの判断が食い違うビルドではその食い違いが現れます。
ポリシー独自の語彙は保持されます。 ソケットが扱う重大度は 閉じた集合ですが、ポリシーが判定を集める名前はポリシーに属します。 デフォルトの名前は Rego のコーパスですでに使われている慣例的なものであり、 ポリシーが判定に別の名前を付けているオペレーターは、そのマッピングを アタッチメントの設定で宣言します。そのため、すでにポリシーライブラリを保守しているエステートは、 それを書き直さずにソケットを採用できます。マッピングはプラグインが設定用に宣言するスキーマによって型付けされるため、 不正なマッピングは判定を誤ってルーティングするのではなく、ポリシーが実行される前にビルドを 停止します。
ポリシーライブラリ全体が 1 つのアタッチメントとして運ばれます。 ポリシーセットはファイルごとに アタッチすることも、ポリシーファイルとデータドキュメントをまとめた単一のアーカイブとしてアタッチすることもでき、 アーカイブはゲストが開きます。読み取れないアーカイブは、ファイル名を挙げてそのように報告されます。 判定に至らなかったポリシーセットとして報告されることは決してありません。「ライブラリが読み取れなかった」ことと 「ライブラリがビルドを許可した」ことが区別できなくなっては ならないからです。
評価できないポリシーはビルドを停止します。 ポリシーを評価できない場合、 アタッチメントは失敗し、ビルドはプラグインを名指しするフォールトで停止します。これは、ビルドを停止する判定とは 意図的に区別されています。この 2 つのケースを混同してはならず、 どちらも許可ではありません。
各ロールが公開するペイロード、判定キー、重大度へのマッピング、
アーカイブのアタッチ方法を含む、記述に関する全体は
language-reference/plugins/policy-socket.md にあります。
継承と公開の規律
extends: による継承は、Platform Architect が共有ベースラインの上に特化した子エンティティを構築できるようにするカタログの仕組みです。2 つのカタログ種別は、データの柱において扱いが分かれます。Feature の親スキーマと子スキーマはワークスペースのロード時に合成され、リーフごとの来歴を持つ統合スキーマが生成されます。拡張する Component は柱の内容を一切記述しません。リテラルのマーカー schema: inherited を書き、チェーンのどの深さでも、ベースが記述したとおりのベースの schema: ブロックを受け取ります。
これにより、共有ベースラインが提起するガバナンス上の問い、すなわち子がベースに対してどのような制約を宣言できるかが決まります。Component の場合、その答えは取り締まりではなく構造によるものです。子が宣言する契約はベースの契約そのものであるため、ベースの制約を子が緩めたり、削除したり、型を変えたりすることはできず、ベースラインを保つための公開時チェックも必要ありません。ベースが宣言するよりも厳しいルールを正当に必要とする子は、それを assertions: ブロックへの追加エントリとして表現します。このエントリはベースのルールを置き換えるのではなく、ベースのルールと並んで合成されます。
子 Component が合成するのは構造です。アタッチメントスロット(featuresSchema)、トポロジーソケット(usesSchema)、自己注入の許可リスト(inject)、名前付きの assertions はすべてチェーンに沿ってマージされ、再宣言されたエントリはベースのエントリを完全に置き換えます。
ルールの配置:どのルールをポリシープラグインに置き、どのルールを Component ごとのスキーマに置くか
公開規律プラグインは、カタログ全体に適用される横断的なルールの置き場所です。サプライチェーンのルール(例:「すべての Recipe は、カタログに存在する Component を implements: しなければならない」)や、企業のコンプライアンスルール(例:「compliance.aggrega.ai/scope: pci-dss を持つすべての Component は、企業の pci ベースラインを extends: しなければならない」)がこれにあたります。これらのルールは複数のエンティティにまたがるか、ワークスペースを一つの単位として評価するか、あるいはビルド時ではなく公開時に慣例を適用します。
Component ごと/Feature ごとの schema: 宣言は、エンティティごとの制約の置き場所です。フィールドごとの型、範囲、パターン、列挙値、および専用の assertions: ブロックで表現されるフィールド間のルールがこれにあたります。これらの制約は一つのエンティティに局所的であり、カタログの中でそのエンティティとともに移動します。
この区分は恣意的なものではありません。「すべての必須フィールドが存在しなければならない」といったルールは、required: 配列に属するエンティティごとの制約です。「pci-dss の親を拡張するすべての子エンティティは、ワークスペースレベルのガバナンスラベルを宣言しなければならない」といったルールは、ポリシープラグインが適用するエンティティ横断のルールです。2 つのルール分類は異なる問いに答えるため、重なることはありません。スキーマは「このインスタンスは自身の契約に一致しているか」を検証し、ポリシープラグインは「このカタログはワークスペースが求める横断的なルールを満たしているか」を検証します。
新しいガバナンスルールを記述する際の配置の問いは、そのルールが単一のエンティティの内容だけに依存するのか(→ スキーマまたは assertions ブロック)、それとも複数のエンティティ間の関係やワークスペースレベルの設定に依存するのか(→ ポリシープラグイン)です。横断的なケースに対しては Wasm リンターのパターンが標準的な仕組みです。企業のカタログは、標準の公開規律プラグインと同じプラグイン契約インターフェースを利用するカスタムのポリシープラグインを配布できます。
アノテーションのプレフィックス規律
アノテーションの名前空間は由来のセマンティクスを持ちます。プレフィックスが異なれば、対象とする読み手もガバナンスの権限主体も異なります。カタログ作成者、エンタープライズのプラットフォームチーム、そして Aggrega プラットフォーム自体が、いずれも同じフラットな辞書にアノテーションを記述します。読み手を区別しているのはプレフィックスです。
| プレフィックス | 由来 | 対象 | 変更可否 |
|---|---|---|---|
aggrega.ai/(サブドメインなし) | 予約済み:Aggrega コンパイラのみが出力 | 内部ツール、来歴の付与 | ユーザーは記述できません。ユーザーコンテンツで宣言されたサブドメインなしプレフィックスのアノテーションは、公開時に拒否されます |
<sub-domain>.aggrega.ai/(例:component.aggrega.ai/、feature.aggrega.ai/、compliance.aggrega.ai/) | カタログの慣例 | カタログエンティティを記述するアーキテクト、ラベルを利用する Wasm ポリシープラグイン | カタログ公開者が記述し、利用者は読み取ります |
<enterprise-domain>/(例:acme.com/、my-org.io/) | エンタープライズのオーバーレイ | エンタープライズのプラットフォームチーム、エンタープライズの Wasm プラグイン | エンタープライズが記述します。プラットフォームのコンパイラは不透明なメタデータとして無視します |
<community-domain>/(例:cncf.io/、kubernetes.io/) | 外部エコシステム | よく知られたラベルを読み取るエコシステム横断のツール | コミュニティが管理 |
サブドメインなしの aggrega.ai/ プレフィックスには最も強い規律が課されます。これはプラットフォームが出力するアノテーション専用に予約されています。コンパイラはレンダリング出力に aggrega.ai/compiler-version、aggrega.ai/component-id、aggrega.ai/recipe-uri、aggrega.ai/boundary-path および関連する来歴キーを出力します。aggrega.ai/<key> アノテーションを直接宣言するユーザーコンテンツは、公開時に拒否されます。この規律により、ユーザーが記述したアノテーションがプラットフォームの出力する来歴と衝突することを防ぎます。
<sub-domain>.aggrega.ai/ 配下のサブドメインプレフィックスは、カタログの慣例のための空間です。標準ライブラリは component.aggrega.ai/type(クラウドネイティブのオントロジーラベル)、feature.aggrega.ai/kind(運用系と認証情報系の Feature の区分)、compliance.aggrega.ai/*(コンプライアンス軸のラベル)、および同様にスコープされたサブ名前空間を使用します。各サブドメインは特定のカタログの読み手が管理します。component.aggrega.ai/* は Component エンティティの作成者が、feature.aggrega.ai/* は Feature エンティティの作成者が、compliance.aggrega.ai/* はコンプライアンスポリシーの担当者が管理します。サブドメインをまたぐ読み取り(Wasm プラグインが複数のサブ名前空間から読み取ること)は許可されていますが、まれです。各プラグインは通常、1 つのサブ名前空間に自身のスコープを限定します。
エンタープライズドメインのプレフィックス(acme.com/...、my-org.io/...)は、プラットフォームの拡張面です。Aggrega コンパイラはこれらを不透明なメタデータとして扱い、エンタープライズの Wasm プラグインがこれらを利用します。エンタープライズは自らのガバナンスに合う任意のプレフィックス構造を記述できます。フラット(acme.com/owner: team-payments)、サブドメイン(security.acme.com/scope: pii)、階層型(org.acme.com/billing-center: finance)などです。プラットフォームはエンタープライズのプレフィックス構成を制約しません。唯一のルールは、エンタープライズのプレフィックスが aggrega.ai/ やそのサブドメインと衝突しないことです。
この規律が重要なのは、アノテーションがカスケードするためです。Aggregate のサブシステムに記述されたアノテーションはサブシステム内のすべてのコンポーネントに伝播し、コンポーネントインスタンス自身のアノテーションはそのサブシステムのアノテーションを上書きし、モジュールのアノテーションはそのモジュール自身のコンポーネントに届きます。Release の境界に付けたアノテーションは境界内のすべてのコンポーネントに伝播します。プロバイダー向けのアノテーションはどちらの側からでもレンダリング出力に届き、両方が同じキーを書いた場合は Release の値が適用されます。プレフィックスの規律がなければ、Aggregate 側のアノテーションがプラットフォームの出力する来歴キーを暗黙に上書きしたり、エンタープライズのアノテーションがカタログの慣例のキーと衝突したりする可能性があります。プレフィックスの表によって読み手が明示され、衝突防止のルールを公開時に強制できるようになります。
エンティティごとのアノテーション面の一覧と、3 つのバケットによるカスケードのセマンティクス(.context.annotations.release / .context.annotations.catalog / .context.annotations.aggregate)については、language-reference/vocabulary/labels-and-annotations.md を参照してください。