8.4. Red Hat build of Kueue Operator への移行


分散ワークロードを管理するための組み込み Kueue コンポーネントは非推奨になりました。Red Hat build of Kueue Operator に移行する必要があります。組み込み Kueue および Red Hat build of Kueue Operator の両方を同じクラスターにインストールできません。同じリソースを管理するコントローラーが作成され、競合してしまうためです。

OpenShift AI は、既存のワークロードを Red Hat build of Kueue に自動的に移行しません。クラスター管理者は、アップグレード後もワークロードがキュー管理を引き続き使用できるように、組み込み Kueue から Red Hat build of Kueue Operator に手動で移行する必要があります。

前提条件

  • OpenShift クラスターのクラスター管理者権限を持っている。
  • OpenShift 4.18 以降を使用している。
  • クラスター用に Red Hat OpenShift の cert-manager Operator をインストールして設定している。
  • 埋め込まれた Kueue コンポーネントが有効になっています (つまり、DataScienceCluster オブジェクトの spec.components.kueue.managementState フィールドが Managed に設定されています)。

手順

  1. オプション: 組み込み Kueue から Red Hat build of Kueue に移行すると、OpenShift AI Operator は既存の Kueue 設定を kueue-manager-config ConfigMap から Kueue カスタムリソース (CR) に自動的に移動します。

    kueue-manager-config ConfigMap を保持するには、次のコマンドを実行します。<applications-namespace> は、OpenShift AI アプリケーションの namespace に置き換えます。デフォルトは redhat-ods-applications です。

    $ oc annotate configmap kueue-manager-config -n <applications-namespace> opendatahub.io/managed=false
    Copy to Clipboard Toggle word wrap
  2. OpenShift Web コンソールにクラスター管理者としてログインします。
  3. オプション (推奨): 潜在的な設定の競合を避けるため、Red Hat build of Kueue をインストールする前に、組み込みの Kueue コンポーネントをアンインストールします。

    1. Web コンソールで、Operators Installed Operators をクリックし、Red Hat OpenShift AI Operator をクリックします。
    2. Data Science Cluster タブをクリックします。
    3. default-dsc オブジェクトをクリックします。
    4. YAML タブをクリックします。
    5. 次のように、spec.components.kueue.managementStateRemoved に設定します。

      spec:
        components:
          kueue:
            managementState: Removed
      Copy to Clipboard Toggle word wrap
    6. Save をクリックします。
    7. OpenShift AI Operator が調整するまで待機し、埋め込まれた Kueue が削除されたことを確認します。

      • default-dsc オブジェクトの Details タブで、KueueReady 条件の StatusFalse で、ReasonRemoved になっていることを確認します。
      • Workloads Deployments に移動し、OpenShift AI がインストールされているプロジェクト (例: redhat-ods-applications) を選択し、Kueue 関連のデプロイメント (例: kueue-controller-manager) が存在しなくなっていることを確認します。
  4. OpenShift クラスターに Red Hat build of Kueue Operator をインストールします。

    1. Red Hat build of Kueue ドキュメント に記載された Red Hat build of Kueue Operator のインストール手順を実行します。
    2. Operators Installed Operators に移動し、Red Hat build of Kueue Operator の StatusSucceeded と表示されていることを確認します。
  5. OpenShift AI で Red Hat build of Kueue Operator をアクティブ化します。

    1. Web コンソールで、Operators Installed Operators をクリックし、Red Hat OpenShift AI Operator をクリックします。
    2. Data Science Cluster タブをクリックします。
    3. default-dsc オブジェクトをクリックします。
    4. YAML タブをクリックします。
    5. spec.components.kueue.managementStateUnmanaged に設定します。デフォルトのクラスターキューとデフォルトのローカルキューには、定義済みの名前 (default) を使用するか、次の例に示すようにカスタム名を指定できます。

      • 定義済みのキュー名を使用するには、次の設定を適用します。

        spec:
          components:
            kueue:
              managementState: Unmanaged
        Copy to Clipboard Toggle word wrap
      • カスタムキュー名を指定するには、<example-cluster-queue><example-local-queue> をカスタム値に置き換えて、次の設定を適用します。

        spec:
          components:
            kueue:
              managementState: Unmanaged
              defaultClusterQueueName: <example-cluster-queue>
              defaultLocalQueueName: <example-local-queue>
        Copy to Clipboard Toggle word wrap
    6. Save をクリックします。
  6. 各プロジェクト namespace に kueue.openshift.io/managed=true ラベルを適用して、既存のプロジェクトの Kueue 管理を有効にします。

    $ oc label namespace <project-namespace> kueue.openshift.io/managed=true --overwrite
    Copy to Clipboard Toggle word wrap

    <project-namespace> はプロジェクトの名前に置き換えます。

    注記

    Kueue の検証とキューの適用は、kueue.openshift.io/managed=true ラベルが指定された namespace 内のワークロードのみが対象です。

検証

  • 埋め込まれた Kueue が削除されていることを確認します。
  • DataScienceCluster リソースで、Kueue の正常な Unmanaged ステータスが表示されていることを確認します。
  • キュー内の既存のワークロードが、新しいオペレータ管理 Kueue コントローラーによって引き続き処理されることを確認します。機能を確認するには、新しいテストワークロードを送信します。

次のステップ

  • ResourceFlavorClusterQueue、および LocalQueue オブジェクトを作成および変更して、クォータを設定します。詳細は、Red Hat build of Kueue ドキュメント を参照してください。
  • ダッシュボードで Kueue を有効にして、ユーザーがワークロードを作成するときに Kueue 対応のオプションを選択できるようにします。Kueue を有効にすると、ダッシュボードから作成されたすべての新しいプロジェクトに対して Kueue 管理も有効になります。ダッシュボードで Kueue を有効にする を参照してください。
  • クラスター管理者と OpenShift AI 管理者は、ユーザーが OpenShift AI ダッシュボードからワークロードを送信できるように、ハードウェアプロファイルを作成できます。ハードウェアプロファイルの使用 を参照してください。
トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat