Day-2 ライフサイクル
Day-2 ライフサイクルと時間的実行
ケイパビリティに依存しない AOT(Ahead-of-Time)コンパイラは、宣言的な意図(Day-1)と運用上の現実(Day-2)との間に本質的にギャップを生みます。クラウドは完全に決定論的ではなく、デプロイには時間的な順序付けが必要であり、開発者はメンテナンス作業のための命令的なトリガーを必要とします。
Aggrega は、特定のアーキテクチャ上のポリフィルと GitOps ネイティブなルーティングによって、これらのギャップを構造的に埋めます。これにより、コアコンパイラの純粋性を損なうことなく、生成される設定がこれらの運用上のニーズを満たします。
1. DAG 実行モデル(時間的な順序付け)
課題: インフラのデプロイは時間の有向非巡回グラフ(DAG)です。データベースマイグレーションの task は、Web の server が起動する前に完了まで実行されなければなりません。しかし AOT コンパイラは静的な YAML や Terraform のフラットなフォルダを生成します。これらのフラットなフォルダを GitOps コントローラ(ArgoCD など)に渡すと、すべてが同時に適用され、Web サーバーはデータベースを待つ間にクラッシュループを起こします。
解決策: Release におけるバウンダリごとの syncWave 開発者の Aggregate には手を加えません。順序付けは物理的な運用上の現実であるため、ドメイン 4(Release)で厳密に管理されます。Release 内の各バウンダリは省略可能な syncWave: <integer> フィールドを持ち、プラットフォームオペレーターがバウンダリ単位でロールアウトの順序を明示的に段階付けできます。
apiVersion: aggrega.ai/v1beta1kind: Releasemetadata: name: sequenced-release version: 1.0.0 environment: productionspec: aggregate: my-app manifest: prod-manifest boundaries: infra: syncWave: 0 components: core-vpc: {} postgres-db: {} migrations: syncWave: 1 components: db-migration-task: {} apps: syncWave: 2 components: web-server: {} support-agent: {}Wave 値のセマンティクス:
- Wave は符号付き整数で、デフォルトは
0です。負の値は他のすべて(CRD、名前空間、RBAC)より先に実行され、大きい値は小さい値の後に実行されます。オペレーターは自身のデプロイトポロジーに合わせて値を設定します。 - バウンダリに直接含まれるすべてのコンポーネントインスタンスは、バウンダリの Wave 値を自身の IR ノードに継承します。オーサリング層にはコンポーネントごとのオーバーライドはありません。単一バウンダリ内でのプロバイダー内部のリソースごとの順序付けは、プロバイダーの責務です。
- ネストしたバウンダリは暗黙的に継承しません。
syncWaveを宣言していないネストしたバウンダリは、外側のバウンダリの宣言にかかわらず0がデフォルトになります。「innerサブバウンダリを含め、outer全体を wave 1 にしたい」場合、オペレーターは両方にsyncWave: 1を宣言します。
コンパイラの効果: コンパイラは、各境界の wave 値をその境界内でレンダリングされるマニフェストに伝播します。Providers はネイティブの順序付けプリミティブを出力します:
- Kubernetes(ArgoCD/Flux)の場合: helm プロバイダーは、レンダリングされるすべてのマニフェストに
metadata.annotationsエントリとしてargocd.argoproj.io/sync-wave: "<N>"を出力し、チャートが Helm フックとして指定したリソースには、ネイティブな Helm フックの順序付けのためにhelm.sh/hook-weight: "<N>"も追加で付与されます。helm-chart プロバイダーは、Recipe がartifacts:を通じてチャートに追加するテンプレートファイルにのみこのアノテーションを出力します。チャート自身のテンプレートは変更せずにコピーするため、それらには wave が付きません。 - Compose の場合: compose プロバイダーは、バウンダリのレンダリング先ファイル内のサービス間の
depends_onとして順序を表現します。対象がhealthcheckを宣言している場合は対象のヘルスで、宣言していない場合は対象の起動でゲートします。depends_onは 1 つのファイル内のサービスを指すため、2 つの compose ファイルにまたがる順序は表現できません。オペレーターは別々の compose プロジェクトをdocker compose upの呼び出し層で順序付けます。 - CloudFormation の場合: cloudformation プロバイダーは、ディスパッチグループが組み立てるスタックテンプレート内のリソース間の
DependsOnとして順序を表現します。各リソースは直前の、リソースを含む Wave のリソースを指定し、対象が残りを連鎖させます。この属性は作成順序に加えて削除順序も逆順に制御しますが、準備完了の条件は表現しません。テンプレートにはリソースが利用可能であるという概念がないためです。DependsOnは 1 つのテンプレート内のリソースを指すため、2 つのスタックにまたがる順序は表現できません。オペレーターは別々のスタックをデプロイ層で順序付けます。 - Terraform の場合: terraform プロバイダーは、境界が組み立てられるルート構成の
moduleブロック間のdepends_onとして順序を表現します。各モジュールは直前の中身のある wave のモジュールを指定し、残りは Terraform が連鎖させます。これは Terraform が実行するアクションを順序付けるものであり、準備完了の条件は表現しません。構成にはリソースがサービス可能であるという概念がないためです。depends_onは 1 つの構成内のモジュールを指定するため、2 つのルート構成にまたがる順序は表現できません。それらの順序付けはオペレーターの責任です。
Aggrega 内部の aggrega.ai/sync-wave: "<N>" キーは、可観測性と来歴の用途のために ArgoCD アノテーションと並んで出力されます。helm の出力と、Recipe が helm-chart のチャートに追加するテンプレートファイルではアノテーションとして、compose ではサービスのラベルとして、各 terraform モジュールでは来歴コメントの 1 行として、各 cloudformation リソースでは Metadata."aggrega.ai/provenance" の下に出力されます。GitOps コントローラが消費するのは ArgoCD アノテーションのほうです。
Wave のオーサリング単位とデプロイ可能単位
バウンダリは Wave のオーサリング単位 です。デプロイ可能単位は アセンブリパス であり、コンパイラが生成し CI/CD パイプラインがオーケストレーションの対象とするディスク上の出力です。デフォルトでは、1 つのバウンダリが 1 つのアセンブリパスに対応します。各バウンダリのコンポーネントは boundaries/<boundary-name>/<provider>/ 配下に出力され、helm install / docker compose up はそのパスに対して実行されます。
オペレーターはこの 1:1 の対応をまとめることができます。バウンダリは directory:(および subDirectory:)のパステンプレートフィールドを宣言でき、これを複数のバウンダリで共有すると、それらのバウンダリのコンポーネントは共有パスの単一の組み立て済み出力にルーティングされます。directory: "deploy/cluster" を宣言した 2 つのバウンダリは、両方のコンポーネントを含む 1 つの組み立て済み出力を生成します。デプロイ可能単位はバウンダリの識別ではなく、アセンブリパスになります。
1 つの組み立て済み出力の中に異なる wave のマニフェストが混在するのは通常のことであり、サポートされています。バウンダリ A が syncWave: 1 を、バウンダリ B が syncWave: 2 を宣言し、両方が directory: "deploy/cluster" を共有する場合、生成されるデプロイ可能単位には両方のバウンダリのコンポーネントが含まれ、各マニフェストは作成元バウンダリの wave アノテーションを持ちます。ランタイムツールはリソースごとのアノテーションを読み取り、組み立て済みデプロイ単位の中で順序付けます。ArgoCD の Application ごとの同期コンテキストは wave 1 のマニフェストを処理し、それらが Healthy になるのを待ってから wave 2 を処理します。Helm のフック順序付けはフックリソースごとに helm.sh/hook-weight を読み取ります。これは ArgoCD の標準パターンであり、リソースごとの出力は、ツールを横断するコンシューマーが期待する入力そのものです。
Application 間の順序付け(オペレーターが別々の組み立て済み出力に対して複数の ArgoCD Application を実行する場合)は、オペレーターレベルの CI 設定です。Aggrega は成果物を生成し、オペレーターは app-of-apps や Progressive Sync によって ArgoCD Application をそれらの周りに配線します。Aggrega のリソースごとのアノテーションパターンは、ツールを横断するすべてのコンシューマーが期待する標準の入力形式です。
2. 動的アドレッシングのポリフィル
課題: クラウドは作成時点では非決定論的です。AWS RDS インスタンスや S3 バケットのようなリソースは、物理的にプロビジョニングされた後になって初めてランダムな URL ハッシュを生成します。AOT コンパイラはクラウドが何かをプロビジョニングする前に設定を生成するため、コンパイラがコンテナの環境変数にデータベースの URL のリテラルを注入することは物理的に不可能です。
解決策: クレデンシャルの Features による決定論的ポインタ Aggrega は既存のクレデンシャルの Features を活用し、「決定論的」の定義をリテラルの IP アドレスから決定論的ポインタへと移すことでこれを解決します。生成される設定は URL を渡すのではなく、URL が存在することになるクラウド Vault へのパスを渡します。
- 例 1: 出力の生成(Terraform RDS)
データベース用の Ops Recipe が AWS RDS インスタンスを作成します。重要なのは、この Recipe が、新たに生成された動的 URL を AWS Systems Manager(SSM)Parameter Store の決定論的に命名されたパス(例:
/aggrega/prod/db-url)にネイティブに出力するよう作成されている点です。 - 例 2: 入力の注入(Kubernetes アプリ) 開発者は、クレデンシャルの Feature
core/referenced-secretを、worker の Component が宣言するスロットにアタッチし、originに決定論的ポインタ文字列("/aggrega/prod/db-url")を設定します。Kubernetes ターゲットでは、Manifest がそのアタッチメントをhelm/k8s-external-secretにバインドします。これは、クラスタのシークレットストアオペレーターにそのエントリを Secret へ取得させる KubernetesExternalSecretをレンダリングし、その Secret の名前とデータキーを公開します。worker の Recipe はコンテナのattachments:を通じてそれらを読み取り、valueFrom: secretKeyRefにマップされた Pod の環境変数をレンダリングします(クレデンシャルがコンテナに届く仕組みを参照)。コンパイラはポインタ文字列を受け渡すだけで、URL を読み取ることはありません。
ランタイムでは、Terraform が DB をプロビジョニングし、URL を Vault に保存します。コンテナは起動して Vault から同期された Secret を読み取り、接続します。AOT コンパイラは、リテラルの IP アドレスを一切必要とせずに、安定したポインタ文字列によって関係を生成しました。
3. 命令的アクション(実行可能なハンドオフ)
課題: 宣言的な状態は Day-1 のプロビジョニングには最適ですが、開発者は命令的なアクションを実行する必要があります:「今すぐ DB バックアップを実行する」。厳密に宣言的な GitOps パイプラインには、静的なスクリプトを再トリガーするネイティブな仕組みがありません。
解決策:休止状態のタスクとターゲット自身のコマンド Aggrega は厳密な AOT の純粋性を保ちながらこれを解決します。デプロイされても開始されないタスクの設定を生成し、各実行はターゲット上でターゲット自身のコマンドによって開始されます。
- 開発者の意図: 開発者はスクリプトを
Aggregate内のtaskとして宣言し、オンデマンドでの実行を求める Feature(例:core/manual-trigger)をアタッチします。オンデマンドで実行されることはタスクの性質の一部であるため、開発者がアタッチします。一方、入力がすべて運用上のものである Feature は、運用チームが Release 内でアタッチします。 - 休止状態の形: 各ターゲットにおけるタスク自身の Recipe がアタッチメントを読み取り、デプロイしても実行が開始されない形でタスクをレンダリングします。Kubernetes では、タスクはデプロイされるとすぐに実行される
Jobの代わりに、suspend: trueで保留され、決して来ない日付を指定したスケジュールを持つCronJobになります。Docker Compose では、終了後に Compose が再起動しないタスクのサービスにプロファイルmanualが付与されるため、docker compose upはそれを停止したままにします。Amazon ECS では、Terraform 経由でも CloudFormation 経由でも、タスク定義は単独でデプロイされ、それを開始するスケジュールはありません。Manifest がこのアタッチメントにバインドする FeatureRecipe は、どのターゲットでも独自のファイルを追加しません。変更はタスク自身の出力にあります。 - ハンドオフ: コンパイラはクラスタに接続せず、クラウド API も呼び出しません。ビルドは実行を開始せず、スクリプトも書き出しません。各実行はオペレーターがターゲット自身のコマンドで開始します。Kubernetes では
kubectl create job <run-name> --from=cronjob/<cronjob>、Docker Compose ではdocker compose run --rm <service>、Amazon ECS ではaws ecs run-taskを使い、Release がタスクのinfra.overridesの下に設定するクラスタ、タスク定義、ネットワーク構成を指定します。設定の生成と実行時の実行は分離されたままです。
(注: Kubernetes と Amazon ECS では、スケジュールを持つタスクはアタッチメントの有無にかかわらずそのスケジュールで実行され、同じコマンドでスケジュールされた実行の合間に追加の実行を開始できます。スケジューラを持たない Docker Compose では、タスクの Recipe はスケジュールを拒否します。作業例 task-run-on-demand は、1 つの Aggregate を Kubernetes、Docker Compose、Terraform、CloudFormation 向けにビルドし、それぞれについてレンダリングされた出力と実行を開始するコマンドを示します。)
4. 事前分析:Workspace フック(プラットフォームの RBAC とクォータ)
課題: 一部の変更は、高価な、または本番環境に不可欠なインフラストラクチャ(たとえば大規模な GPU クラスタ)をプロビジョニングするため、レビューなしに GitOps パイプラインへ流れてはなりません。どのコントリビューターがどの変更をどの環境へ昇格できるかは組織のポリシー上の判断であり、コンパイラはそれをハードコードしてはなりません。
解決策: 純粋な AOT コンパイラは、誰がビルドを実行しているかを把握するために Active Directory へ問い合わせたり、クラウドの認証情報を取得したりすることはできません。CI/CD の実行前に権限のない生成を防ぐため、このアーキテクチャは明示的なコンテキスト注入に依拠します。
CI/CD ランナーが aggrega build を呼び出すと、パイプラインは実行コンテキストを、--config で渡す設定ファイルに、それを判定するガバナンスのアタッチメントの with.settings として書き込みます(例: approval: standard)。このファイルはアタッチメントを governance_append の下に列挙するため、それらはワークスペース自身の設定がアタッチするガバナンスプラグインに置き換えられるのではなく、それらに追加されます。ir-verdict ロールのポリシーは、これらの設定を input.settings として読み取ります。このポリシーが受け取るのは組み立てられたグラフであって Release ではないため、Release の環境はラベルとして届きます。label-transform ロールのポリシーが input.compilation_context.environment を読み取り、各ノードにそのラベルを付けます。判定は両者を比較し、一致しない場合にビルドを停止します。ここでは、設定に approval: platform-approved を含まない本番ビルドがそれに当たります:
# ci-governance.yaml — written by the CI/CD runner, passed as `aggrega build --config ci-governance.yaml`plugins: governance_append: - uri: governance/rego:<version> role: label-transform with: sources: - policies/environment.rego - uri: governance/rego:<version> role: ir-verdict with: sources: - policies/approval.rego settings: approval: standard# policies/environment.rego — evaluated by the governance label-transform role, during topology constructionpackage acme.context
import rego.v1
labels contains {"node": id, "key": "acme.com/environment", "value": input.compilation_context.environment} if { some id, _ in input.graph.nodes}# policies/approval.rego — evaluated by the governance ir-verdict role over the assembled graphpackage acme.approval
import rego.v1
approved if input.settings.approval == "platform-approved"
deny contains msg if { not approved some node in input.graph.spec.nodes node.labels["acme.com/environment"] == "production" msg := "a production build needs the approval platform-approved in the pipeline's governance settings."}設定に承認がまったく含まれない実行も拒否されます。ルールが問うのは、その承認が存在するかどうかであって、別の承認が存在するかどうかではないからです。これにより RBAC はコンパイラのネイティブなロジックから分離され、コンパイラは提供されたデータの決定論的な評価器としてのみ動作します。
5. シフトレフト FinOps(ポリシーによるコスト見積もり)
課題: 誤った設定(例:workers: 500 の要求)が財務上の安全策をすり抜け、クラウドの大きな予算超過を引き起こすことがあります。
解決策(企業の Wasm ポリシー): IR グラフは完全なトポロジを含み、Release は物理的なマッピング(.infra)を含むため、企業はコンパイラにハードコードされた機能を必要とせずに、Release がデプロイするものの正確なコストを生成前に評価できます。企業は独自の FinOps WebAssembly プラグインを作成し、判定ロールでガバナンスのソケットにアタッチするだけです。この独自プラグインは .infra ペイロードを読み取り、月額の推定コストを計算し、計算されたコストが企業内部で定義された予算上限を超える場合にはビルドを停止できます。
6. 「ブラウンフィールド」インポートのライフサイクル
課題: 企業はすでにインフラストラクチャの大半を稼働させています。Aggrega は参照ワークロード(パススルーネットワーキング。参照ワークロードを参照)を通じてビルドを管理外のインフラストラクチャに接続するよう設計されていますが、既存の Oracle データベースを Aggrega が生成した Terraform の状態へ移行すると、通常オーケストレータはデータベースを再作成しようとし、既存のデータが破壊されます。
解決策(計画中): インポートのライフサイクルを管理する core/resource-adoption Feature が計画されています。
開発者が既存のデータベースを Aggregate 内でモデル化し、順次実行されるパイプラインで resource-adoption 機能をアタッチすると、Wasm レンダリングプラグインはベースラインの運用 Recipe ペイロードを評価するよう設計されています。プラグインは標準の作成用設定を出力する代わりに、ターゲットプラットフォームの明示的な取り込み構文を出力するよう設計されています(例:Terraform の import {} ブロックや Crossplane の ObserveOnly 管理ポリシーを含む JSONPatch を返す)。これにより企業は、ダウンタイムなしにレガシーなアーキテクチャを GitOps のコントロールプレーンへ取り込む設定を安全に生成できます。
7. 運用のベストプラクティスと決定的な命名
コアコンパイラはフラットな IR グラフ内で安定した内部ノード ID(例:support-db)に依拠しますが、物理的なクラウドプロバイダー(AWS、Azure、GCP など)は、物理インフラストラクチャに対してグローバルに一意な文字列(例:S3 バケット名、IAM ロール名、API Gateway のドメイン)を要求することがよくあります。
Platform Ops のエンジニアがベースラインテンプレートに物理名をハードコードした場合(例:bucket_name: "enterprise-data-bucket")、生成された成果物は初回は問題なく適用されます。しかし、開発者が 2 つ目の環境(例:staging と prod)をデプロイすると、名前の衝突によりクラウドプロバイダーは実行時に 2 つ目の環境のリソースを拒否します。
決定的な出力のルール(GitOps の安全性): GitOps コントローラ(ArgoCD、Flux)はレンダリングされた成果物に対してバイトレベルの差分検出を行うため、コンパイラは同一の入力がバイト単位で同一の出力を生成することを保証します。テンプレートコンテキストを流れるマップ(.context.inject.env、.values、.infra、およびその他のランタイムビュー)は、データ層全体で作成者の挿入順序を保持する順序付きマップ構造に基づいていますが、テンプレートの境界だけは例外です。これらのマップに対する {{ range }} は、Go テンプレートと同様に、作成者の順序ではなくキーのアルファベット順で反復します。運用エンジニアは、同じ入力の実行間でその反復順序が決定的であることに依拠できます。順序に意味がある場合は、マップから復元するのではなくリストとして記述します。ただし、Sprig の keys 関数は Go のマップの反復順序(言語設計上、非決定的)を返します。keys の出力から決定的なキーの並びを組み立てるテンプレートは、決定性を取り戻すために sortAlpha を通す必要があります(例:{{ keys .values | sortAlpha }})。
運用 Recipes の黄金律(Helm パターン): Platform Ops のエンジニアは物理的なクラウドリソース名を決してハードコードしてはなりません。代わりに、テンプレート評価の段階で Aggrega のデプロイコンテキストを連結して、決定的に一意な名前を構築する必要があります。これは決定性のルールではなく、再利用性と衝突安全性のルールです。ハードコードされた名前は安定した出力を生成しますが、同じ Recipe が複数のコンポーネントインスタンスをレンダリングする場合や、同じ Aggregate が複数の Releases にわたってデプロイされる場合に致命的に衝突します。
コンパイラはグローバルな一意性を保証するために、ちょうど 2 つの変数を提供します:
{{ .metadata.release_name }}:デプロイを駆動するReleaseの名前(例:prod-billing)。{{ .context.instance_id }}:開発者のAggregateにおける特定の Component ID(例:receipt-storage)。
これらを連結することで(例:{{ .metadata.release_name }}-{{ .context.instance_id }})、運用チームは、開発者に物理的な命名の慣例を管理させることなく、Wasm プラグインが生成する設定が環境ごと、コンポーネントごとに一意なリソース名を使用することを保証します。