ホーム
製品
OpenShift Container Platform
4.17
Hosted Control Plane
5.3. OpenShift Virtualization での Hosted Control Plane の管理

5.3. OpenShift Virtualization での Hosted Control Plane の管理

OpenShift Virtualization にホステッドクラスターをデプロイした後、次の手順を実行してクラスターを管理できます。

5.3.1. ホステッドクラスターへのアクセス
リンクのコピー

ホステッドクラスターにアクセスするには、kubeconfig ファイルと kubeadmin 認証情報をリソースから直接取得するか、hcp コマンドラインインターフェイスを使用して kubeconfig ファイルを生成します。

前提条件

リソースから kubeconfig ファイルと認証情報を直接取得し、ホステッドクラスターにアクセスするには、ホステッドクラスターのアクセスシークレットを理解している必要があります。ホステッドクラスター (ホスティング) のリソースとアクセスシークレットは、ホステッドクラスターの namespace に格納されます。Hosted Control Plane は、Hosted Control Plane の namespace で実行されます。

シークレット名の形式は次のとおりです。

kubeconfig シークレット: <hosted_cluster_namespace>-<name>-admin-kubeconfig (clusters-hypershift-demo-admin-kubeconfig)
kubeadmin パスワードシークレット: <hosted_cluster_namespace>-<name>-kubeadmin-password (clusters-hypershift-demo-kubeadmin-password)

kubeconfig シークレットには Base64 でエンコードされた kubeconfig フィールドが含まれており、これをデコードしてファイルに保存し、次のコマンドで使用できます。

oc --kubeconfig <hosted_cluster_name>.kubeconfig get nodes

$ oc --kubeconfig <hosted_cluster_name>.kubeconfig get nodes

Copy to Clipboard

Toggle word wrap

kubeadmin パスワードシークレットも Base64 でエンコードされます。これをデコードし、そのパスワードを使用して、ホステッドクラスターの API サーバーまたはコンソールにログインできます。

手順

hcp CLI を使用してホステッドクラスターにアクセスして kubeconfig ファイルを生成するには、次の手順を実行します。
1. 次のコマンドを入力して、kubeconfig ファイルを生成します。
  $ hcp create kubeconfig --namespace <hosted_cluster_namespace> \ --name <hosted_cluster_name> > <hosted_cluster_name>.kubeconfig
  Copy to Clipboard Toggle word wrap
2. kubeconfig ファイルを保存した後、次のコマンド例を入力して、ホステッドクラスターにアクセスできます。
  $ oc --kubeconfig <hosted_cluster_name>.kubeconfig get nodes
  Copy to Clipboard Toggle word wrap

5.3.2. ホステッドクラスターのノード自動スケーリングの有効化
リンクのコピー

ホステッドクラスターにさらに容量が必要で、予備のエージェントが利用可能な場合は、自動スケーリングを有効にして新しいワーカーノードをインストールできます。

手順

自動スケーリングを有効にするには、次のコマンドを入力します。
```
oc -n <hosted_cluster_namespace> patch nodepool <hosted_cluster_name> \
  --type=json \
  -p '[{"op": "remove", "path": "/spec/replicas"},{"op":"add", "path": "/spec/autoScaling", "value": { "max": 5, "min": 2 }}]'
```
```
$ oc -n <hosted_cluster_namespace> patch nodepool <hosted_cluster_name> \
  --type=json \
  -p '[{"op": "remove", "path": "/spec/replicas"},{"op":"add", "path": "/spec/autoScaling", "value": { "max": 5, "min": 2 }}]'
```
Copy to Clipboard Toggle word wrap
注記
この例では、ノードの最小数は 2、最大数は 5 です。追加できるノードの最大数は、プラットフォームによって制限される場合があります。たとえば、エージェントプラットフォームを使用する場合、ノードの最大数は使用可能なエージェントの数によって制限されます。

新しいノードを必要とするワークロードを作成します。

次の例を使用して、ワークロード設定を含む YAML ファイルを作成します。

apiVersion: apps/v1
kind: Deployment
metadata:
  creationTimestamp: null
  labels:
    app: reversewords
  name: reversewords
  namespace: default
spec:
  replicas: 40
  selector:
    matchLabels:
      app: reversewords
  strategy: {}
  template:
    metadata:
      creationTimestamp: null
      labels:
        app: reversewords
    spec:
      containers:
      - image: quay.io/mavazque/reversewords:latest
        name: reversewords
        resources:
          requests:
            memory: 2Gi
status: {}

apiVersion: apps/v1
kind: Deployment
metadata:
  creationTimestamp: null
  labels:
    app: reversewords
  name: reversewords
  namespace: default
spec:
  replicas: 40
  selector:
    matchLabels:
      app: reversewords
  strategy: {}
  template:
    metadata:
      creationTimestamp: null
      labels:
        app: reversewords
    spec:
      containers:
      - image: quay.io/mavazque/reversewords:latest
        name: reversewords
        resources:
          requests:
            memory: 2Gi
status: {}

Copy to Clipboard

Toggle word wrap

ファイルを workload-config.yaml として保存します。
以下のコマンドを入力して、YAML を適用します。
```
oc apply -f workload-config.yaml
```
```
$ oc apply -f workload-config.yaml
```
Copy to Clipboard Toggle word wrap

次のコマンドを入力して、admin-kubeconfig シークレットを抽出します。

oc extract -n <hosted_cluster_namespace> \
  secret/<hosted_cluster_name>-admin-kubeconfig \
  --to=./hostedcluster-secrets --confirm

$ oc extract -n <hosted_cluster_namespace> \
  secret/<hosted_cluster_name>-admin-kubeconfig \
  --to=./hostedcluster-secrets --confirm

Copy to Clipboard

Toggle word wrap

出力例

hostedcluster-secrets/kubeconfig

hostedcluster-secrets/kubeconfig

Copy to Clipboard

Toggle word wrap

次のコマンドを入力して、新しいノードが Ready ステータスであるかどうかを確認できます。
```
oc --kubeconfig ./hostedcluster-secrets get nodes
```
```
$ oc --kubeconfig ./hostedcluster-secrets get nodes
```
Copy to Clipboard Toggle word wrap

ノードを削除するには、次のコマンドを入力してワークロードを削除します。

oc --kubeconfig ./hostedcluster-secrets -n <namespace> \
  delete deployment <deployment_name>

$ oc --kubeconfig ./hostedcluster-secrets -n <namespace> \
  delete deployment <deployment_name>

Copy to Clipboard

Toggle word wrap

数分間待ちます。その間に、容量の追加が必要にならないようにします。エージェントプラットフォームでは、エージェントは廃止され、再利用できます。次のコマンドを入力すると、ノードが削除されたことを確認できます。
```
oc --kubeconfig ./hostedcluster-secrets get nodes
```
```
$ oc --kubeconfig ./hostedcluster-secrets get nodes
```
Copy to Clipboard Toggle word wrap

注記

IBM Z エージェントの場合、コンピュートノードがクラスターからデタッチされるのは、KVM エージェントを使用する IBM Z の場合だけです。z/VM および LPAR の場合は、コンピュートノードを手動で削除する必要があります。

エージェントは、KVM を使用する IBM Z でのみ再利用できます。z/VM および LPAR の場合は、エージェントを再作成して、それらをコンピュートノードとして使用してください。

5.3.3. OpenShift Virtualization での Hosted Control Plane のストレージの設定
リンクのコピー

詳細なストレージ設定を指定しなかった場合、KubeVirt 仮想マシン (VM) イメージ、KubeVirt Container Storage Interface (CSI) マッピング、および etcd ボリュームにデフォルトのストレージクラスが使用されます。

次の表に、ホステッドクラスターで永続ストレージをサポートするためにインフラストラクチャーが提供する必要がある機能を示します。

Expand

表5.1 ホステッドクラスターの永続ストレージモード
インフラストラクチャーの CSI プロバイダー	ホステッドクラスターの CSI プロバイダー	ホステッドクラスターの機能	注記
任意の RWX `Block` CSI プロバイダー	`kubevirt-csi`	基本: RWO `Block` および `File`、RWX `Block` および `Snapshot`	推奨
任意の RWX `Block` CSI プロバイダー	Red Hat OpenShift Data Foundation 外部モード	Red Hat OpenShift Data Foundation の機能セット
任意の RWX `Block` CSI プロバイダー	Red Hat OpenShift Data Foundation 内部モード	Red Hat OpenShift Data Foundation の機能セット	使用しないでください。

5.3.3.1. KubeVirt CSI ストレージクラスのマッピング
リンクのコピー

KubeVirt CSI は、ReadWriteMany (RWX) アクセスが可能なインフラストラクチャーストレージクラスのマッピングをサポートします。クラスターの作成時に、インフラストラクチャーのストレージクラスをホストされるストレージクラスにマッピングできます。

手順

インフラストラクチャーのストレージクラスをホストされるストレージクラスにマッピングするには、次のコマンドを実行して --infra-storage-class-mapping 引数を使用します。
```
hcp create cluster kubevirt \
  --name <hosted_cluster_name> \
  --node-pool-replicas <worker_node_count> \
  --pull-secret <path_to_pull_secret> \
  --memory <memory> \
  --cores <cpu> \
  --infra-storage-class-mapping=<infrastructure_storage_class>/<hosted_storage_class> \
```
```
$ hcp create cluster kubevirt \
  --name <hosted_cluster_name> \ 
```
1
```
  --node-pool-replicas <worker_node_count> \ 
```
2
```
  --pull-secret <path_to_pull_secret> \ 
```
3
```
  --memory <memory> \ 
```
4
```
  --cores <cpu> \ 
```
5
```
  --infra-storage-class-mapping=<infrastructure_storage_class>/<hosted_storage_class> \ 
```
6
Copy to Clipboard Toggle word wrap
1
ホステッドクラスターの名前を指定します (例: example)。
2
ワーカー数を指定します (例: 2)。
3
プルシークレットへのパスを指定します (例: /user/name/pullsecret)。
4
メモリーの値を指定します (例: 8Gi)。
5
CPU の値を指定します (例: 2)。
6
<infrastructure_storage_class> をインフラストラクチャーストレージクラス名に置き換え、<hosted_storage_class> をホステッドクラスターストレージクラス名に置き換えます。hcp create cluster コマンド内で --infra-storage-class-mapping 引数を複数回使用できます。

ホステッドクラスターを作成すると、インフラストラクチャーのストレージクラスがホステッドクラスター内に表示されます。これらのストレージクラスのいずれかを使用するホステッドクラスター内に永続ボリューム要求 PVC を作成すると、KubeVirt CSI はクラスターの作成時に設定したインフラストラクチャーストレージクラスマッピングを使用してそのボリュームをプロビジョニングします。

注記

KubeVirt CSI は、RWX アクセスが可能なインフラストラクチャーストレージクラスのマッピングのみをサポートします。

次の表に、ボリュームモードとアクセスモードの機能が KubeVirt CSI ストレージクラスにどのようにマッピングされるかを示します。

Expand

表5.2 KubeVirt CSI ストレージクラスとアクセスモードおよびボリュームモードのマッピング
インフラストラクチャーの CSI 機能	ホステッドクラスターの CSI 機能	仮想マシンのライブ移行のサポート	注記
RWX: `Block` または `Filesystem`	`ReadWriteOnce` (RWO) `Block` または `Filesystem` RWX `Block` のみ	サポート対象	`Filesystem` ボリュームモードでは、ホストされた `Block` モードのパフォーマンスが低下するため、`Block` モードを使用してください。RWX `Block` ボリュームモードは、ホステッドクラスターが OpenShift Container Platform 4.16 以降の場合にのみサポートされます。
RWO `Block` ストレージ	RWO `Block` ストレージまたは `Filesystem`	サポート対象外	ライブマイグレーションのサポートが不足しているため、KubeVirt 仮想マシンをホストする基盤となるインフラストラクチャークラスターを更新する機能が影響を受けます。
RWO `FileSystem`	RWO `Block` または `Filesystem`	サポート対象外	ライブマイグレーションのサポートが不足しているため、KubeVirt 仮想マシンをホストする基盤となるインフラストラクチャークラスターを更新する機能が影響を受けます。インフラストラクチャー `Filesystem` ボリュームモードを使用すると、ホストされた `Block` モードのパフォーマンスが低下します。

5.3.3.2. 単一の KubeVirt CSI ボリュームスナップショットクラスのマッピング
リンクのコピー

KubeVirt CSI を使用して、インフラストラクチャーのボリュームスナップショットクラスをホステッドクラスターに公開できます。

手順

ボリュームスナップショットクラスをホステッドクラスターにマッピングするには、ホステッドクラスターを作成するときに --infra-volumesnapshot-class-mapping 引数を使用します。以下のコマンドを実行します。
```
hcp create cluster kubevirt \
  --name <hosted_cluster_name> \
  --node-pool-replicas <worker_node_count> \
  --pull-secret <path_to_pull_secret> \
  --memory <memory> \
  --cores <cpu> \
  --infra-storage-class-mapping=<infrastructure_storage_class>/<hosted_storage_class> \
  --infra-volumesnapshot-class-mapping=<infrastructure_volume_snapshot_class>/<hosted_volume_snapshot_class>
```
```
$ hcp create cluster kubevirt \
  --name <hosted_cluster_name> \ 
```
1
```
  --node-pool-replicas <worker_node_count> \ 
```
2
```
  --pull-secret <path_to_pull_secret> \ 
```
3
```
  --memory <memory> \ 
```
4
```
  --cores <cpu> \ 
```
5
```
  --infra-storage-class-mapping=<infrastructure_storage_class>/<hosted_storage_class> \ 
```
6
```
  --infra-volumesnapshot-class-mapping=<infrastructure_volume_snapshot_class>/<hosted_volume_snapshot_class> 
```
7
Copy to Clipboard Toggle word wrap
1
ホステッドクラスターの名前を指定します (例: example)。
2
ワーカー数を指定します (例: 2)。
3
プルシークレットへのパスを指定します (例: /user/name/pullsecret)。
4
メモリーの値を指定します (例: 8Gi)。
5
CPU の値を指定します (例: 2)。
6
<infrastructure_storage_class> は、インフラストラクチャークラスターに存在するストレージクラスに置き換えます。<hosted_storage_class> は、ホステッドクラスターに存在するストレージクラスに置き換えます。
7
<infrastructure_volume_snapshot_class> は、インフラストラクチャークラスターに存在するボリュームスナップショットクラスに置き換えます。<hosted_volume_snapshot_class> は、ホステッドクラスターに存在するボリュームスナップショットクラスに置き換えます。
注記
--infra-storage-class-mapping および --infra-volumesnapshot-class-mapping 引数を使用しない場合、デフォルトのストレージクラスとボリュームスナップショットクラスを使用してホステッドクラスターが作成されます。したがって、インフラストラクチャークラスターでデフォルトのストレージクラスとボリュームスナップショットクラスを設定する必要があります。

5.3.3.3. 複数の KubeVirt CSI ボリュームスナップショットクラスのマッピング
リンクのコピー

複数のボリュームスナップショットクラスを特定のグループに割り当てることで、それらをホステッドクラスターにマッピングできます。インフラストラクチャーのストレージクラスとボリュームスナップショットクラスは、同じグループに属している場合にのみ相互に互換性があります。

手順

複数のボリュームスナップショットクラスをホステッドクラスターにマッピングするには、ホステッドクラスターを作成するときに group オプションを使用します。以下のコマンドを実行します。
```
hcp create cluster kubevirt \
  --name <hosted_cluster_name> \
  --node-pool-replicas <worker_node_count> \
  --pull-secret <path_to_pull_secret> \
  --memory <memory> \
  --cores <cpu> \
  --infra-storage-class-mapping=<infrastructure_storage_class>/<hosted_storage_class>,group=<group_name> \
  --infra-storage-class-mapping=<infrastructure_storage_class>/<hosted_storage_class>,group=<group_name> \
  --infra-storage-class-mapping=<infrastructure_storage_class>/<hosted_storage_class>,group=<group_name> \
  --infra-volumesnapshot-class-mapping=<infrastructure_volume_snapshot_class>/<hosted_volume_snapshot_class>,group=<group_name> \
  --infra-volumesnapshot-class-mapping=<infrastructure_volume_snapshot_class>/<hosted_volume_snapshot_class>,group=<group_name>
```
```
$ hcp create cluster kubevirt \
  --name <hosted_cluster_name> \ 
```
1
```
  --node-pool-replicas <worker_node_count> \ 
```
2
```
  --pull-secret <path_to_pull_secret> \ 
```
3
```
  --memory <memory> \ 
```
4
```
  --cores <cpu> \ 
```
5
```
  --infra-storage-class-mapping=<infrastructure_storage_class>/<hosted_storage_class>,group=<group_name> \ 
```
6
```
  --infra-storage-class-mapping=<infrastructure_storage_class>/<hosted_storage_class>,group=<group_name> \
  --infra-storage-class-mapping=<infrastructure_storage_class>/<hosted_storage_class>,group=<group_name> \
  --infra-volumesnapshot-class-mapping=<infrastructure_volume_snapshot_class>/<hosted_volume_snapshot_class>,group=<group_name> \ 
```
7
```
  --infra-volumesnapshot-class-mapping=<infrastructure_volume_snapshot_class>/<hosted_volume_snapshot_class>,group=<group_name>
```
Copy to Clipboard Toggle word wrap
1
ホステッドクラスターの名前を指定します (例: example)。
2
ワーカー数を指定します (例: 2)。
3
プルシークレットへのパスを指定します (例: /user/name/pullsecret)。
4
メモリーの値を指定します (例: 8Gi)。
5
CPU の値を指定します (例: 2)。
6
<infrastructure_storage_class> は、インフラストラクチャークラスターに存在するストレージクラスに置き換えます。<hosted_storage_class> は、ホステッドクラスターに存在するストレージクラスに置き換えます。<group_name> は、グループ名に置き換えます。たとえば、infra-storage-class-mygroup/hosted-storage-class-mygroup,group=mygroup および infra-storage-class-mymap/hosted-storage-class-mymap,group=mymap です。
7
<infrastructure_volume_snapshot_class> は、インフラストラクチャークラスターに存在するボリュームスナップショットクラスに置き換えます。<hosted_volume_snapshot_class> は、ホステッドクラスターに存在するボリュームスナップショットクラスに置き換えます。たとえば、infra-vol-snap-mygroup/hosted-vol-snap-mygroup,group=mygroup および infra-vol-snap-mymap/hosted-vol-snap-mymap,group=mymap です。

5.3.3.4. KubeVirt 仮想マシンのルートボリュームの設定
リンクのコピー

クラスターの作成時に、--root-volume-storage-class 引数を使用して、KubeVirt 仮想マシンルートボリュームをホストするために使用するストレージクラスを設定できます。

手順

KubeVirt 仮想マシンのカスタムのストレージクラスとボリュームサイズを設定するには、次のコマンドを実行します。
```
hcp create cluster kubevirt \
  --name <hosted_cluster_name> \
  --node-pool-replicas <worker_node_count> \
  --pull-secret <path_to_pull_secret> \
  --memory <memory> \
  --cores <cpu> \
  --root-volume-storage-class <root_volume_storage_class> \
  --root-volume-size <volume_size>
```
```
$ hcp create cluster kubevirt \
  --name <hosted_cluster_name> \ 
```
1
```
  --node-pool-replicas <worker_node_count> \ 
```
2
```
  --pull-secret <path_to_pull_secret> \ 
```
3
```
  --memory <memory> \ 
```
4
```
  --cores <cpu> \ 
```
5
```
  --root-volume-storage-class <root_volume_storage_class> \ 
```
6
```
  --root-volume-size <volume_size> 
```
7
Copy to Clipboard Toggle word wrap
1
ホステッドクラスターの名前を指定します (例: example)。
2
ワーカー数を指定します (例: 2)。
3
プルシークレットへのパスを指定します (例: /user/name/pullsecret)。
4
メモリーの値を指定します (例: 8Gi)。
5
CPU の値を指定します (例: 2)。
6
KubeVirt 仮想マシンルートボリュームをホストするストレージクラスの名前を指定します (例: ocs-storagecluster-ceph-rbd)。
7
ボリュームサイズを指定します (例: 64)。
これにより、PVC 上でホストされる仮想マシンを使用してホステッドクラスターが作成されます。

5.3.3.5. KubeVirt 仮想マシンイメージキャッシュの有効化
リンクのコピー

KubeVirt 仮想マシンイメージキャッシュを使用すると、クラスターの起動時間とストレージ使用量の両方を最適化できます。KubeVirt 仮想マシンイメージキャッシュは、スマートクローニングと ReadWriteMany アクセスモードが可能なストレージクラスの使用をサポートします。スマートクローン作成の詳細は、smart-cloning を使用したデータボリュームのクローン作成 を参照してください。

イメージのキャッシュは次のように機能します。

VM イメージは、ホステッドクラスターに関連付けられた PVC にインポートされます。
その PVC の一意のクローンは、クラスターにワーカーノードとして追加されるすべての KubeVirt VM に対して作成されます。

イメージキャッシュを使用すると、イメージのインポートが 1 つだけ必要になるため、VM の起動時間が短縮されます。ストレージクラスがコピーオンライトクローン作成をサポートしている場合、クラスター全体のストレージ使用量をさらに削減できます。

手順

イメージキャッシュを有効にするには、クラスターの作成時に、次のコマンドを実行して --root-volume-cache-strategy=PVC 引数を使用します。
```
hcp create cluster kubevirt \
  --name <hosted_cluster_name> \
  --node-pool-replicas <worker_node_count> \
  --pull-secret <path_to_pull_secret> \
  --memory <memory> \
  --cores <cpu> \
  --root-volume-cache-strategy=PVC
```
```
$ hcp create cluster kubevirt \
  --name <hosted_cluster_name> \ 
```
1
```
  --node-pool-replicas <worker_node_count> \ 
```
2
```
  --pull-secret <path_to_pull_secret> \ 
```
3
```
  --memory <memory> \ 
```
4
```
  --cores <cpu> \ 
```
5
```
  --root-volume-cache-strategy=PVC 
```
6
Copy to Clipboard Toggle word wrap
1
ホステッドクラスターの名前を指定します (例: example)。
2
ワーカー数を指定します (例: 2)。
3
プルシークレットへのパスを指定します (例: /user/name/pullsecret)。
4
メモリーの値を指定します (例: 8Gi)。
5
CPU の値を指定します (例: 2)。
6
イメージキャッシュのストラテジー (例: PVC) を指定します。

5.3.3.6. KubeVirt CSI ストレージのセキュリティーと分離
リンクのコピー

KubeVirt Container Storage Interface (CSI) は、基盤となるインフラストラクチャークラスターのストレージ機能をホステッドクラスターに拡張します。CSI ドライバーは、インフラストラクチャーストレージクラスとホステッドクラスターへの分離されたセキュアなアクセスを実現するために、次のセキュリティー制約を使用します。

ホステッドクラスターのストレージは、他のホステッドクラスターから分離されます。
ホステッドクラスター内のワーカーノードは、インフラストラクチャークラスターに直接 API によってアクセスできません。ホステッドクラスターは、制御された KubeVirt CSI インターフェイスを通じてのみ、インフラストラクチャークラスター上にストレージをプロビジョニングできます。
ホステッドクラスターは、KubeVirt CSI クラスターコントローラーにアクセスできません。そのため、ホステッドクラスターは、ホステッドクラスターに関連付けられていないインフラストラクチャークラスター上の任意のストレージボリュームにアクセスできません。KubeVirt CSI クラスターコントローラーは、Hosted Control Plane namespace の Pod で実行されます。
KubeVirt CSI クラスターコントローラーのロールベースアクセス制御 (RBAC) により、永続ボリューム要求 (PVC) アクセスが Hosted Control Plane namespace だけに制限されます。したがって、KubeVirt CSI コンポーネントは他の namespace からストレージにアクセスできません。

5.3.3.7. etcd ストレージの設定
リンクのコピー

クラスターの作成時に、--etcd-storage-class 引数を使用して、etcd データをホストするために使用されるストレージクラスを設定できます。

手順

etcd のストレージクラスを設定するには、次のコマンドを実行します。
```
hcp create cluster kubevirt \
  --name <hosted_cluster_name> \
  --node-pool-replicas <worker_node_count> \
  --pull-secret <path_to_pull_secret> \
  --memory <memory> \
  --cores <cpu> \
  --etcd-storage-class=<etcd_storage_class_name>
```
```
$ hcp create cluster kubevirt \
  --name <hosted_cluster_name> \ 
```
1
```
  --node-pool-replicas <worker_node_count> \ 
```
2
```
  --pull-secret <path_to_pull_secret> \ 
```
3
```
  --memory <memory> \ 
```
4
```
  --cores <cpu> \ 
```
5
```
  --etcd-storage-class=<etcd_storage_class_name> 
```
6
Copy to Clipboard Toggle word wrap
1
ホステッドクラスターの名前を指定します (例: example)。
2
ワーカー数を指定します (例: 2)。
3
プルシークレットへのパスを指定します (例: /user/name/pullsecret)。
4
メモリーの値を指定します (例: 8Gi)。
5
CPU の値を指定します (例: 2)。
6
etcd ストレージクラス名を指定します (例: lvm-storageclass)。--etcd-storage-class 引数を指定しない場合は、デフォルトのストレージクラスが使用されます。

5.3.4. hcp CLI を使用して NVIDIA GPU デバイスをアタッチする
リンクのコピー

OpenShift Virtualization 上のホステッドクラスターの hcp コマンドラインインターフェイス (CLI) を使用して、1 つ以上の NVIDIA グラフィックスプロセッシングユニット (GPU) デバイスをノードプールにアタッチできます。

重要

NVIDIA GPU デバイスをノードプールにアタッチする機能は、テクノロジープレビュー機能です。テクノロジープレビュー機能は、Red Hat 製品のサービスレベルアグリーメント (SLA) の対象外であり、機能的に完全ではないことがあります。Red Hat は、実稼働環境でこれらを使用することを推奨していません。テクノロジープレビュー機能は、最新の製品機能をいち早く提供して、開発段階で機能のテストを行い、フィードバックを提供していただくことを目的としています。

Red Hat のテクノロジープレビュー機能のサポート範囲に関する詳細は、テクノロジープレビュー機能のサポート範囲を参照してください。

前提条件

GPU デバイスが存在するノード上のリソースとして NVIDIA GPU デバイスを公開した。詳細は、NVIDIA GPU Operator with OpenShift Virtualization を参照してください。
ノードプールに割り当てるために、NVIDIA GPU デバイスをノード上の拡張リソースとして公開した。

手順

次のコマンドを実行すると、クラスターの作成中に GPU デバイスをノードプールにアタッチできます。
```
hcp create cluster kubevirt \
  --name <hosted_cluster_name> \
  --node-pool-replicas <worker_node_count> \
  --pull-secret <path_to_pull_secret> \
  --memory <memory> \
  --cores <cpu> \
  --host-device-name="<gpu_device_name>,count:<value>"
```
```
$ hcp create cluster kubevirt \
  --name <hosted_cluster_name> \
```
1
```
  --node-pool-replicas <worker_node_count> \
```
2
```
  --pull-secret <path_to_pull_secret> \
```
3
```
  --memory <memory> \
```
4
```
  --cores <cpu> \
```
5
```
  --host-device-name="<gpu_device_name>,count:<value>" 
```
6
Copy to Clipboard Toggle word wrap
1
ホステッドクラスターの名前を指定します (例: example)。
2
ワーカー数を指定します (例: 3)。
3
プルシークレットへのパスを指定します (例: /user/name/pullsecret)。
4
メモリーの値を指定します (例: 16Gi)。
5
CPU の値を指定します (例: 2)。
6
GPU デバイス名と数を指定します (例: --host-device-name="nvidia-a100,count:2")。--host-device-name 引数は、インフラストラクチャーノードからの GPU デバイスの名前と、ノードプール内の各仮想マシンにアタッチする GPU デバイスの数を表すオプション数を取得します。デフォルトは 1 です。たとえば、2 つの GPU デバイスを 3 つのノードプールレプリカにアタッチすると、ノードプール内の 3 つの仮想マシンすべてが 2 つの GPU デバイスにアタッチされます。
ヒント
--host-device-name 引数を複数回使用して、タイプの異なる複数デバイスをアタッチできます。

5.3.5. NodePool リソースを使用して NVIDIA GPU デバイスをアタッチする
リンクのコピー

NodePool リソースの nodepool.spec.platform.kubevirt.hostDevices フィールドを設定することで、1 つ以上の NVIDIA グラフィックスプロセッシングユニット (GPU) デバイスをノードプールにアタッチできます。

重要

Red Hat のテクノロジープレビュー機能のサポート範囲に関する詳細は、テクノロジープレビュー機能のサポート範囲を参照してください。

手順

1 つ以上の GPU デバイスをノードプールにアタッチします。

1 つの GPU デバイスをアタッチするには、次の設定例を使用して NodePool リソースを設定します。

apiVersion: hypershift.openshift.io/v1beta1
kind: NodePool
metadata:
  name: <hosted_cluster_name> 
  namespace: <hosted_cluster_namespace> 
spec:
  arch: amd64
  clusterName: <hosted_cluster_name>
  management:
    autoRepair: false
    upgradeType: Replace
  nodeDrainTimeout: 0s
  nodeVolumeDetachTimeout: 0s
  platform:
    kubevirt:
      attachDefaultNetwork: true
      compute:
        cores: <cpu> 
        memory: <memory> 
      hostDevices: 
      - count: <count> 
        deviceName: <gpu_device_name> 
      networkInterfaceMultiqueue: Enable
      rootVolume:
        persistent:
          size: 32Gi
        type: Persistent
    type: KubeVirt
  replicas: <worker_node_count>

apiVersion: hypershift.openshift.io/v1beta1
kind: NodePool
metadata:
  name: <hosted_cluster_name>


  namespace: <hosted_cluster_namespace>


spec:
  arch: amd64
  clusterName: <hosted_cluster_name>
  management:
    autoRepair: false
    upgradeType: Replace
  nodeDrainTimeout: 0s
  nodeVolumeDetachTimeout: 0s
  platform:
    kubevirt:
      attachDefaultNetwork: true
      compute:
        cores: <cpu>


        memory: <memory>


      hostDevices:


      - count: <count>


        deviceName: <gpu_device_name>


      networkInterfaceMultiqueue: Enable
      rootVolume:
        persistent:
          size: 32Gi
        type: Persistent
    type: KubeVirt
  replicas: <worker_node_count>

Copy to Clipboard

Toggle word wrap

1: ホステッドクラスターの名前を指定します (例: example)。
2: ホステッドクラスターの namespace の名前を指定します (例: clusters)。
3: CPU の値を指定します (例: 2)。
4: メモリーの値を指定します (例: 16Gi)。
5: hostDevices フィールドは、ノードプールにアタッチできる各種 GPU デバイスのリストを定義します。
6: ノードプール内の各仮想マシンにアタッチする GPU デバイスの数を指定します。たとえば、2 つの GPU デバイスを 3 つのノードプールレプリカにアタッチすると、ノードプール内の 3 つの仮想マシンすべてが 2 つの GPU デバイスにアタッチされます。デフォルトは 1 です。
7: GPU デバイス名を指定します (例: nvidia-a100)。
8: ワーカー数を指定します (例: 3)。

複数の GPU デバイスをアタッチするには、次の設定例を使用して NodePool リソースを設定します。

apiVersion: hypershift.openshift.io/v1beta1
kind: NodePool
metadata:
  name: <hosted_cluster_name>
  namespace: <hosted_cluster_namespace>
spec:
  arch: amd64
  clusterName: <hosted_cluster_name>
  management:
    autoRepair: false
    upgradeType: Replace
  nodeDrainTimeout: 0s
  nodeVolumeDetachTimeout: 0s
  platform:
    kubevirt:
      attachDefaultNetwork: true
      compute:
        cores: <cpu>
        memory: <memory>
      hostDevices:
      - count: <count>
        deviceName: <gpu_device_name>
      - count: <count>
        deviceName: <gpu_device_name>
      - count: <count>
        deviceName: <gpu_device_name>
      - count: <count>
        deviceName: <gpu_device_name>
      networkInterfaceMultiqueue: Enable
      rootVolume:
        persistent:
          size: 32Gi
        type: Persistent
    type: KubeVirt
  replicas: <worker_node_count>

apiVersion: hypershift.openshift.io/v1beta1
kind: NodePool
metadata:
  name: <hosted_cluster_name>
  namespace: <hosted_cluster_namespace>
spec:
  arch: amd64
  clusterName: <hosted_cluster_name>
  management:
    autoRepair: false
    upgradeType: Replace
  nodeDrainTimeout: 0s
  nodeVolumeDetachTimeout: 0s
  platform:
    kubevirt:
      attachDefaultNetwork: true
      compute:
        cores: <cpu>
        memory: <memory>
      hostDevices:
      - count: <count>
        deviceName: <gpu_device_name>
      - count: <count>
        deviceName: <gpu_device_name>
      - count: <count>
        deviceName: <gpu_device_name>
      - count: <count>
        deviceName: <gpu_device_name>
      networkInterfaceMultiqueue: Enable
      rootVolume:
        persistent:
          size: 32Gi
        type: Persistent
    type: KubeVirt
  replicas: <worker_node_count>

Copy to Clipboard

Toggle word wrap

トップに戻る

5.3. OpenShift Virtualization での Hosted Control Plane の管理

5.3.1. ホステッドクラスターへのアクセス
リンクのコピー

5.3.2. ホステッドクラスターのノード自動スケーリングの有効化
リンクのコピー

5.3.3. OpenShift Virtualization での Hosted Control Plane のストレージの設定
リンクのコピー

5.3.3.1. KubeVirt CSI ストレージクラスのマッピング
リンクのコピー

5.3.3.2. 単一の KubeVirt CSI ボリュームスナップショットクラスのマッピング
リンクのコピー

5.3.3.3. 複数の KubeVirt CSI ボリュームスナップショットクラスのマッピング
リンクのコピー

5.3.3.4. KubeVirt 仮想マシンのルートボリュームの設定
リンクのコピー

5.3.3.5. KubeVirt 仮想マシンイメージキャッシュの有効化
リンクのコピー

5.3.3.6. KubeVirt CSI ストレージのセキュリティーと分離
リンクのコピー

5.3.3.7. etcd ストレージの設定
リンクのコピー

5.3.4. hcp CLI を使用して NVIDIA GPU デバイスをアタッチする
リンクのコピー

5.3.5. NodePool リソースを使用して NVIDIA GPU デバイスをアタッチする
リンクのコピー

詳細情報

試用、購入および販売

コミュニティー

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

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

会社概要

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

5.3. OpenShift Virtualization での Hosted Control Plane の管理

5.3.1. ホステッドクラスターへのアクセスリンクのコピーリンクがクリップボードにコピーされました!

5.3.2. ホステッドクラスターのノード自動スケーリングの有効化リンクのコピーリンクがクリップボードにコピーされました!

5.3.3. OpenShift Virtualization での Hosted Control Plane のストレージの設定リンクのコピーリンクがクリップボードにコピーされました!

5.3.3.1. KubeVirt CSI ストレージクラスのマッピングリンクのコピーリンクがクリップボードにコピーされました!

5.3.3.2. 単一の KubeVirt CSI ボリュームスナップショットクラスのマッピングリンクのコピーリンクがクリップボードにコピーされました!

5.3.3.3. 複数の KubeVirt CSI ボリュームスナップショットクラスのマッピングリンクのコピーリンクがクリップボードにコピーされました!

5.3.3.4. KubeVirt 仮想マシンのルートボリュームの設定リンクのコピーリンクがクリップボードにコピーされました!

5.3.3.5. KubeVirt 仮想マシンイメージキャッシュの有効化リンクのコピーリンクがクリップボードにコピーされました!

5.3.3.6. KubeVirt CSI ストレージのセキュリティーと分離リンクのコピーリンクがクリップボードにコピーされました!

5.3.3.7. etcd ストレージの設定リンクのコピーリンクがクリップボードにコピーされました!

5.3.4. hcp CLI を使用して NVIDIA GPU デバイスをアタッチするリンクのコピーリンクがクリップボードにコピーされました!

5.3.5. NodePool リソースを使用して NVIDIA GPU デバイスをアタッチするリンクのコピーリンクがクリップボードにコピーされました!

詳細情報

試用、購入および販売

コミュニティー

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

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

会社概要

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

5.3.1. ホステッドクラスターへのアクセス
リンクのコピー

5.3.2. ホステッドクラスターのノード自動スケーリングの有効化
リンクのコピー

5.3.3. OpenShift Virtualization での Hosted Control Plane のストレージの設定
リンクのコピー

5.3.3.1. KubeVirt CSI ストレージクラスのマッピング
リンクのコピー

5.3.3.2. 単一の KubeVirt CSI ボリュームスナップショットクラスのマッピング
リンクのコピー

5.3.3.3. 複数の KubeVirt CSI ボリュームスナップショットクラスのマッピング
リンクのコピー

5.3.3.4. KubeVirt 仮想マシンのルートボリュームの設定
リンクのコピー

5.3.3.5. KubeVirt 仮想マシンイメージキャッシュの有効化
リンクのコピー

5.3.3.6. KubeVirt CSI ストレージのセキュリティーと分離
リンクのコピー

5.3.3.7. etcd ストレージの設定
リンクのコピー

5.3.4. hcp CLI を使用して NVIDIA GPU デバイスをアタッチする
リンクのコピー

5.3.5. NodePool リソースを使用して NVIDIA GPU デバイスをアタッチする
リンクのコピー