すべてのプロダクト
Search
ドキュメントセンター

Container Compute Service:ack-agent-sandbox-controller

最終更新日:Jun 17, 2026

ack-agent-sandbox-controller は、標準化された本番環境グレードのサンドボックスのライフサイクル管理を提供する、Kubernetes ベースの拡張コンポーネントです。このトピックでは、このコンポーネントの概要、使用方法、および変更ログについて説明します。

概要

使用方法

ACS Agent Sandbox の使用方法については、「Agent Sandbox の作成」をご参照ください。

変更ログ

2026 年 6 月

バージョン

更新日時

変更内容

影響

v0.5.16-release.2

2026 年 6 月 16 日

  • バグ修正:

    • サンドボックスの再開後に init コンテナのイメージの整合性チェックを追加しました。コントローラーがイメージの整合性を確認した後にのみ、ランタイムの初期化と CSI 動的ボリュームマウントが実行されるようになります。

この更新によるお客様のサービスへの影響はありません。

v0.5.16-release.1

2026 年 6 月 12 日

  • 機能:

    • サンドボックスの一時停止または再開後も Pod テンプレートの spec が変更されないようになり、再開時に Pod 仕様が予期せず変更されるのを防ぎます。

    • SandboxSet が関連する SandboxTemplate を自動的に作成するようになり、設定プロセスが簡素化されました。

    • 大規模な SandboxSet シナリオ (5,000 以上のサンドボックス) における claim のパフォーマンスを最適化しました。新しいインプレースカウンター CountActiveSandboxes が全リストのコピーを置き換えることで、claim のホットパスにおけるオーバーヘッドを大幅に削減します。

    • サンドボックス削除時のメトリクスのクリーンアップが非同期で実行されるようになりました。これにより、操作が reconcile ホットパスから外れ、削除のスループットが向上します。

    • SandboxUpdateOps が、SandboxSet によって管理されていないすべてのサンドボックスをサポートするようになりました。これにより、直接作成されたサンドボックスのアップグレードシナリオに対応します。

  • バグ修正:

    • 新しくスケールアウトされたサンドボックスによって SandboxUpdateOps が Updating 状態のままになる問題を修正しました。コントローラーは、テンプレートがすでにターゲットバージョンと一致するサンドボックスを自動的にスキップします。

    • init コンテナのインジェクション順序を安定させ、ランタイムコンテナへの一貫したインジェクション順序を保証し、下位互換性を維持するようにしました。

    • サンドボックスのインプレースイメージアップグレードにおける断続的な障害を修正しました。コントローラーは、SandboxHashImmutablePart アノテーションが存在しない場合、不変部分の検証をスキップするようになりました。

この更新によるお客様のサービスへの影響はありません。

v0.5.14-release.1

2026 年 6 月 1 日

  • 機能:

    • サンドボックスのトラフィック管理のサポートを追加しました。この機能は traffic-proxy ランタイムをインジェクトし、Pod に network.alibabacloud.com/network-policy-mode=enhanced-traffic-policy アノテーションを追加することで有効になります。

    • サンドボックスランタイムコンテナの異常状態を監視するために、sandbox_runtime_container_abnormal メトリクスを追加しました。

    • コンポーネントセンターから TrafficPolicy をデプロイして、envd のポート 49983 へのアクセスを制限するサポートを追加しました。この機能はデフォルトで無効になっています。

    • サンドボックスの作成、削除、一時停止、再開の操作に対するトレースのサポートを追加しました。この機能はデフォルトで無効になっており、FeatureGate SandboxTraceLog=true を使用して有効にできます。

  • バグ修正:

    • deleteSandboxMetrics を非同期呼び出しにすることで、高コンカレンシーでのサンドボックス削除時に DeletePartialMatch でのロック競合に起因する調整のブロック問題が解消されます。

    • Pending フェーズ中にサンドボックスのステータスが永続化されない問題を修正しました。

この更新によるお客様のサービスへの影響はありません。

2026 年 5 月

バージョン

更新日時

変更内容

影響

v0.5.13-release.1

2026 年 5 月 21 日

  • バグ修正:

    • SandboxUpdateOps のライフサイクルスクリプトが失敗した際に、サンドボックスのステータスコンディションの message フィールドにスクリプトの stdout または stderr が含まれない問題を修正し、トラブルシューティングの効率を向上させました。

    • サンドボックスの再開中に resumedCondition.Status=True のフォールバックチェックを追加しました。これにより、基盤となる一時停止操作は成功したものの、Pod の Ready コンディションが True のままだった場合に再開プロセスが停止する問題を解決しました。

  • 機能:

    • SandboxSet の VolumeClaimTemplates フィールドにおけるマウント設定の検証を追加しました。

    • SandboxClaim の TTLAfterCompleted および WaitReadyTimeout フィールドの検証を追加しました。

    • 新しい FeatureGate である SandboxMultiClusterNaming を導入しました。有効にすると、サンドボックスの generateName にクラスター ID のハッシュを埋め込み、マルチクラスター環境での命名競合を防ぎます。この機能はデフォルトで無効になっており、コンポーネントセンターで有効にできます。

    • SandboxClaim または E2B SDK でサンドボックスを作成する際に、ウォームプールからサンドボックスの CPU をインプレースでスケールアップできるようになりました。

    • CRD の types に Strategic Merge Patch マーカーを追加し、kubectl apply のパフォーマンスを向上させ、API サーバーの負荷を軽減しました。

    • 監視ダッシュボードに表示するために、サンドボックスの一時停止、再開、アップグレード操作に関する Prometheus メトリクスを追加しました。

    • 一時停止後および再開後のシナリオにおける CSI 動的ボリュームマウント機能を Sandbox Controller に移行し、Sandbox Manager への依存をなくしました。

この更新によるお客様のサービスへの影響はありません。

v0.5.12-release.3

2026 年 5 月 11 日

  • バグ修正:

    • E2B ワークフローを通じて作成されたサンドボックスに対して SandboxUpdateOps アップグレードを実行中に、動的ボリュームマウントがトリガーされない問題を修正しました。

この更新によるお客様のサービスへの影響はありません。

v0.5.12-release.2

2026 年 5 月 8 日

  • バグ修正:

    • agent-runtime が設定されていない場合に SkipInitRuntime=false を指定した SandboxClaim が失敗する問題を修正しました。現在は InitRuntime ステップをスキップし、エラーをログに記録するようになりました。

    • SandboxSet の maxUnavailable のパーセンテージ計算を切り上げるように変更しました。これにより、少なくとも 1 つのサンドボックスが更新可能であることが保証されます。

この更新によるお客様のサービスへの影響はありません。

v0.5.12-release.1

2026 年 5 月 6 日

  • 機能:

    • SandboxSet は、ウォームプール内のサンドボックスのアップグレードをサポートするようになりました。updateStrategymaxUnavailable パラメーターをサポートします。

    • サンドボックスは、updateStrategy=Recreate と、ライフサイクルフックの preUpgrade および postUpgrade をサポートするようになりました。CSI 動的ボリュームマウントは、アップグレード後に実行されるようになりました。

    • SandboxUpdateOps カスタムリソース (CR) を使用して、割り当て済みのサンドボックスをアップグレードできるようになりました。

    • 一時停止および再開のシナリオでは、SandboxClaim コントローラーが動的ボリュームマウントを実行するようになりました。

    • ops.alibabacloud.com/pause-enabled='false' を明示的に設定できるようになりました。

    • サンドボックス監視メトリクスのサポートを追加しました。メトリクスは kube-state-metrics と同じ方法で生成および公開されます。

    • サンドボックスが Vertical Pod Autoscaler (VPA) を使用した CPU の垂直スケーリングをサポートするようになりました。この機能はデフォルトで無効になっており、FeatureGate SandboxInPlaceResourceResizeGate=true で有効にできます。

    • Pod 検証 Webhook による意図しない Pod の削除に対する保護を追加しました。

    • SandboxClaim でサンドボックスを取得する際に、pod ラベルを変更できるようになりました。

この更新によるお客様のサービスへの影響はありません。