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

コンポーネントアーキテクチャ

ack-koordinator は、中央コンポーネントとノードレベルのコンポーネントで構成されています。各モジュールの機能は次のとおりです。

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

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

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

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

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

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

バージョン番号の説明

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

• x.y.z：Koordinator のオープンソース版に対応します。これは、ack-koordinator がそのオープンソース版のすべての機能をサポートしていることを示します。

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

関連概念

前提条件

• v1.18 以降の ACK クラスターが作成されていること。クラスターのアップグレード方法の詳細については、「ACK クラスターの手動アップグレード」をご参照ください。

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

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

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

使用しているコンポーネントのバージョンが App Marketplace からデプロイされたもの (v0.7 より前のバージョン) の場合は、「App Marketplace からアドオンセンターへの ack-koordinator の移行」を参照して移行を完了してください。

• コンポーネントのインストール：以下の手順に従ってコンポーネントをインストールし、デプロイが成功したことを確認します。

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

• コンポーネントのアップグレード：ack-koordinator のデプロイ済みモジュール (Deployment、DaemonSet) を他の方法で手動で変更した場合、コンポーネントのアップグレード後にカスタム設定は上書きされます。

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

2. クラスター ページで、管理するクラスターを見つけてその名前をクリックします。左側のナビゲーションウィンドウで、アドオン管理 をクリックします。

3. [コンポーネント管理] ページで、ack-koordinator を見つけ、[ack-koordinator (ack-slo-manager)] カードの [インストール] をクリックします。

4. [コンポーネント Ack-koordinator(ack-slo-manager) のインストール] ダイアログボックスで、必要に応じて設定パラメーターを変更し、[OK] をクリックします。

5. (オプション) クラスター管理ページの左側のナビゲーションウィンドウで、[アプリケーション] を選択して、ack-koordinator のデプロイステータスを表示します。

   ack-koordinator の [ステータス] が [デプロイ済み] の場合、コンポーネントは正常にデプロイされています。

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

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

ack-slo-manager は ack-koordinator の前身であり、オープンソースプロジェクト Koordinator をインキュベートしました。Koordinator が成熟し安定するにつれて、ack-slo-manager に貢献しました。ack-koordinator は、Koordinator のオープンソース版でサポートされている機能を提供し、ack-slo-manager に基づいてより豊富な機能セットを追加します。「App Marketplace からアドオンセンターへの ack-koordinator の移行」を参照して、速やかに最新のコンポーネントバージョンにアップグレードすることを推奨します。これにより、新機能やバグ修正を利用できます。

App Marketplace からアドオンセンターへの ack-koordinator の移行

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

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

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

   kubectl

   1. 次のコマンドを実行して、元の設定を slo-config.yaml という名前のファイルに保存します。このコマンドは、元の ConfigMap の名前空間 (例：kube-system) と名前 (例：ack-slo-manager-config) に基づいています。

      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] をクリックします。ページの上部で、[App Marketplace] で ack-koordinator をインストールしたときに指定した [名前空間] (デフォルトは kube-system) を選択します。

      2. [名前] テキストボックスで、ack-slo-manager-config を検索します。対象の ConfigMap の名前をクリックし、そのキーと値のペアを記録します。

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

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

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

2. クラスター管理ページの左側のナビゲーションウィンドウで、[アプリケーション] > [Helm] を選択して、ack-slo-manager のデプロイステータスを表示します。[アクション] 列で、[削除] をクリックして、App Marketplace からインストールされた ack-slo-manager をアンインストールします。

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

   重要

   App 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(ack-slo-manager) のインストール] ダイアログボックスで、[agentFeatures] (Koordlet のフィーチャーゲート制御スイッチ) を変更し、必要に応じて他のパラメーターを設定します。その後、[OK] をクリックします。

      1. クラスターがPod リソースパラメーターの動的変更の [CPU 制限調整] 機能を使用しているかどうかを確認します。この機能を使用すると、CRD または Pod アノテーションを作成して、指定したコンテナーの cpu.cfs_quota_us cgroups パラメーターファイルを変更できます。使用している場合は、ステップ ii に進みます。そうでない場合は、ステップ c に進みます。

      2. 次のコマンドを実行して、現在の ack-koordlet の DaemonSet YAML から現在のフィーチャーゲート設定を取得します。

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

      3. 次の例に示すように、ack-koordlet の現在のフィーチャーゲート設定を変更して、CPU バーストポリシーモジュールを無効にします。CPUBurst=false を設定し、他のパラメーターは変更しません。パラメーターはカンマ (,) で区切ります。

         モジュールを無効にすると、クラスター内のすべてのコンテナーの CPU バーストメカニズムは有効になりません。これにより、両方のモジュールが同時にコンテナーの cpu.cfs_quota_us cgroups パラメーターファイルを変更するのを防ぎます。

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

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

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

      ack-koordinator の [ステータス] が [デプロイ済み] の場合、コンポーネントは正常にデプロイされています。

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

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

このエラーは、クラスターに Prometheus がインストールされていないために発生します。「Alibaba Cloud Prometheus モニタリングへの接続と設定」を参照して 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 アップグレードのお知らせ」を参照してアップグレードを完了してください。

2025年11月

2025年8月

2025年7月

2024年9月