Container Service for Kubernetes:ack-koordinator (旧称 ack-slo-manager)

アーキテクチャ

ack-koordinator は、中央コンポーネントとノードレベルのコンポーネントで構成されます。

• Koordinator Manager：Deployment としてデプロイされる中央コンポーネントです。プライマリインスタンスとスタンバイインスタンスで構成され、高可用性を確保します。

  • SLO Controller：リソースのオーバーコミットメントを管理します。コロケーション中にノードの実行ステータスに基づいてクラスター内のオーバーコミットされたリソースを動的に調整し、各ノードの差別化された SLO ポリシーを管理します。

  • Recommender：リソースプロファイリング機能を提供します。ワークロードのピーク時のリソース要件を推定し、コンテナのリソース仕様の設定を簡素化します。

• Koordinator Descheduler：Deployment としてデプロイされる中央コンポーネントで、デスケジューリング機能を提供します。

• Koordlet：DaemonSet としてデプロイされるノードレベルのコンポーネントです。動的なリソースオーバーコミットメント、負荷感知スケジューリング、およびコロケーションシナリオでの QoS 保証スケジューリングをサポートします。

• Koordinator スケジューリングプラグイン：ack-koordinator コンポーネントをインストールする際、Koord-Scheduler モジュールは含まれません。代わりに、そのスケジューリング機能は ACK スケジューラにプラグインとして統合され、デフォルトでインストールされます。

バージョニング

v1.1.1-ack.1 以降、ack-koordinator のバージョン番号は x.y.z-ackn 形式を使用します。

• x.y.z：オープンソースの Koordinator バージョンに対応しており、ack-koordinator がそのバージョンのすべての機能をサポートしていることを意味します。

• ackn：オープンソースバージョンに基づいた機能強化と最適化を表します。

主要な概念

前提条件

• Kubernetes 1.18 以降を実行する ACK クラスターが必要です。クラスターのアップグレード方法の詳細については、「クラスターの手動アップグレード」をご参照ください。

• Helm v3.0 以降がインストールされている必要があります。Helm をアップグレードするには、「[コンポーネントのアップグレード] Helm V2 Tiller のアップグレードに関するお知らせ」および「Helm のバージョンを手動でアップグレードするにはどうすればよいですか？」をご参照ください。

コンポーネントのインストールと管理

ack-koordinator コンポーネントは アドオン管理 ページでインストールできます。このページに戻って、必要に応じてコンポーネントのパラメーターを変更したり、アップグレードしたりすることもできます。

Marketplace からデプロイされた v0.7 より前のバージョンのコンポーネントについては、「Marketplace からアドオンへの ack-koordinator の移行」を参照して移行を完了してください。

• コンポーネントのインストール：以下の手順に従ってコンポーネントをインストールし、デプロイメントを検証します。

• コンポーネントパラメーターの変更：システムは新しい構成に基づいて ack-koordinator を自動的に再デプロイします。

• コンポーネントのアップグレード：ack-koordinator のデプロイ済みモジュール (Deployment や DaemonSet など) を手動で変更した場合、アップグレードによってカスタム構成が上書きされます。

1. ACK コンソールにログインします。左側のナビゲーションウィンドウで、クラスターリスト をクリックします。

2. クラスターリスト ページで、対象クラスターの名前をクリックします。左側のナビゲーションウィンドウで、 [コンポーネントとアドオン] をクリックします。

3. アドオン管理 ページで、[インストール] タブをクリックし、[ack-koordinator(ack-slo-manager)] コンポーネントを見つけて選択し、[次へ] をクリックします。

4. 画面の指示に従ってコンポーネントの構成を完了し、[次へ] をクリックします。

5. 構成情報を確認し、[OK] をクリックします。

コンポーネントのアンインストール

ack-koordinator と ack-slo-manager の関係

ack-slo-manager は ack-koordinator の前身であり、オープンソースプロジェクト Koordinator をインキュベートしました。Koordinator が成熟するにつれて、その技術は ack-slo-manager に取り込まれました。ack-koordinator は、オープンソースの Koordinator バージョンの機能を提供し、前身よりも多くの機能を提供します。新しい機能やバグ修正にアクセスするには、「Marketplace からアドオンへの ack-koordinator の移行」の指示に従って、コンポーネントを最新バージョンにアップグレードしてください。

Marketplace からアドオンへの ack-koordinator の移行

Marketplace から ack-koordinator (v0.7 より前のバージョン) をデプロイした場合は、アンインストールしてから再インストールする必要があります。以下の指示に従って移行を完了してください。

Marketplace の ack-koordinator の ConfigMap を変更した場合は、アップグレードする前にバックアップしてください。ConfigMap を変更していない場合は、ステップ 2 に進み、コンポーネントを直接アップグレードしてください。

1. kubectl またはコンソールを使用して、ack-koordinator の ConfigMap をバックアップします。

   kubectl

   1. 次のコマンドを実行して、元の構成を slo-config.yaml ファイルに保存します。名前空間 (例：kube-system) と名前 (例：ack-slo-manager-config) を、ご利用の ConfigMap の実際の値に置き換えてください。

      kubectl get cm -n kube-system ack-slo-manager-config -o yaml > slo-config.yaml

   2. vim slo-config.yaml コマンドを実行してファイルを編集します。ConfigMap の名前空間を kube-system に変更し、name フィールドを ack-slo-config に変更し、アップグレード中に上書きされないように、ConfigMap からすべての annotations と labels を削除します。

   3. 次のコマンドを実行して、変更した構成をクラスターに適用します。

      kubectl apply -f slo-config.yaml 

   コンソール

   1. 元の ConfigMap のキーと値のペアを記録します。

      1. 左側のナビゲーションウィンドウで、設定 > ConfigMapを選択します。 ページの上部で、Marketplaceから ack-koordinator をインストールしたときに指定した名前空間を選択します。 デフォルトの名前空間は kube-system です。

      2. [名前] 検索ボックスに ack-slo-manager-config と入力し、ターゲットの ConfigMap の名前をクリックして、ConfigMap のキーと値のペアを記録します。

   2. 元の ConfigMap のキーと値のペアを使用して、新しい ConfigMap を作成します。

      1. 左側のナビゲーションウィンドウで、設定 > ConfigMap を選択します。ページの上部で、すべての名前空間 を選択します。

      2. ConfigMap ページの右上隅で、作成する をクリックします。設定マップ名 を ack-slo-config に設定し、kube-system 名前空間を選択します。[+] 追加 をクリックし、記録したキーと値のペアを入力して、作成する をクリックします。

2. 左側のナビゲーションウィンドウで、アプリケーション > Helm を選択します。Marketplace からインストールされた ack-slo-manager コンポーネントを見つけ、[操作] 列の [削除] をクリックしてアンインストールします。

   アドオン管理 ページで、最新バージョンの ack-koordinator をインストールします。詳細については、「コンポーネントのインストールと管理」をご参照ください。

   重要

   Marketplace の ack-koordinator コンポーネントの ConfigMap を変更した場合は、ステップ 1 で作成したバックアップ ConfigMap の名前 (例：ack-slo-config) を [ack-koordinator パラメーター] ダイアログボックスの対応するパラメーターフィールドに入力する必要があります。

resource-controller から ack-koordinator への移行

resource-controller コンポーネントは非推奨になりました。ack-koordinator は、トポロジー認識 CPU スケジューリングやPod のリソースパラメーターの動的変更など、resource-controller のすべての機能をサポートするようになりました。クラスターで resource-controller を使用している場合は、次の手順に従って resource-controller から ack-koordinator に移行してください。

1. resource-controller を最新バージョンにアップグレードします。

   1. ACK コンソールにログインします。左側のナビゲーションウィンドウで、クラスターリスト をクリックします。

   2. クラスターリスト ページで、対象クラスターの名前をクリックします。左側のナビゲーションウィンドウで、 [コンポーネントとアドオン] をクリックします。

   3. アドオン管理 ページで resource-controller を見つけ、画面の指示に従ってコンポーネントをアップグレードします。

2. ack-koordinator をインストールして構成します。

   1. アドオン管理 ページで ack-koordinator を見つけ、画面の指示に従ってインストールします。

   2. インストールが完了したら、アドオン管理 ページに移動し、ack-koordinator アドオンの [操作] 列にある [設定] をクリックします。Koordlet の feature-gate スイッチである agentFeatures パラメーターやその他のパラメーターを必要に応じて構成します。その後、OK をクリックします。

      1. クラスターが「Pod のリソースパラメーターの動的変更」で説明されている CPU Limit 調整機能を使用しているかどうかを確認します。この機能は、CRD を作成するか、Pod アノテーションを追加することで、特定のコンテナの cpu.cfs_quota_us cgroups ファイルを変更します。この機能を使用している場合は、ステップ ii に進んでください。そうでない場合は、ステップ c に進んでください。

      2. 次のコマンドを実行して、ack-koordlet の DaemonSet YAML ファイルから現在の feature-gate 構成を取得します。

         kubectl get daemonset -n kube-system ack-koordlet -o yaml |grep feature-gates
         - --feature-gates=AllAlpha=false,AllBeta=false,...,CPUBurst=true,....

      3. ack-koordlet の feature-gate 構成を変更して、CPUBurst=false を設定することで、CPU Burst パフォーマンス最適化ポリシーを無効にします。パラメーターはカンマ (,) で区切ります。他の設定は変更しないでください。

         このポリシーを無効にすると、クラスター内のすべてのコンテナの CPU Burst メカニズムも無効になります。これにより、2 つのモジュールが同時に cpu.cfs_quota_us cgroups ファイルを変更するのを防ぎます。

         AllAlpha=false,AllBeta=false,...,CPUBurst=false,....

         コンテナの弾力的な CPU リソースを有効にするには、CPU Burst パフォーマンス最適化ポリシーを使用して Pod の CPU 弾力性を自動的に調整します。詳細については、「CPU Burst パフォーマンス最適化ポリシーを有効にする」をご参照ください。

   3. 左側のナビゲーションウィンドウで、アプリケーション > Helm を選択して、ack-koordinator のデプロイメントステータスを表示します。

3. アドオン管理 ページで resource-controller を見つけ、画面の指示に従ってアンインストールします。

コンポーネントのインストールエラー：no matches for kind "ServiceMonitor" in version "monitoring.coreos.com/v1" ensure CRDs are installed first

クラスターに Managed Service for Prometheus がインストールされていません。「Managed Service for Prometheus の接続と構成」の指示に従ってインストールするか、アドオン管理 ページで ack-koordinator をインストールする際に [ACK-Koordinator の Prometheus メトリクスを有効にする] の選択を解除してください。

コンポーネントのインストールエラー：task install-addons-xxx timeout, error install addons map[ack-slo-manager:Can't install release with errors: ... function "lookup" not defined

Helm を v3.0 以降にアップグレードしてください。詳細については、「コンポーネントのアップグレード：Helm V2 Tiller のアップグレードに関するお知らせ」をご参照ください。

2026年7月

2026年1月

2025年11月

2025年8月

2025年7月

2024年9月