Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

Virtualization

Red Hat Advanced Cluster Management for Kubernetes 2.13

Red Hat Advanced Cluster Management が管理するクラスター全体で {rhocpv-short} 仮想マシンリソースを管理する方法を説明します。

概要

Red Hat Advanced Cluster Management による仮想化の使用方法の詳細は、こちらを参照してください。

第1章 Virtualization
リンクのコピー

Red Hat Advanced Cluster Management が管理するすべてのクラスターで Red Hat OpenShift Virtualization 仮想マシンリソースを管理します。

1.1. 仮想マシンアクションの有効化 (テクノロジープレビュー)
リンクのコピー

Red Hat Advanced Cluster Management for Kubernetes が管理するすべてのクラスターの VirtualMachine リソースを表示するには、Red Hat OpenShift Virtualization で作成された VirtualMachine リソースを検索サービスを使用してリスト表示し、フィルタリングします。VirtualMachine リソースの Red Hat Advanced Cluster Management コンソールから次のアクションを有効にすることもできます。

  • Start
  • Stop
  • Restart
  • Pause
  • Unpause

必要なアクセス権: クラスター管理者

1.1.1. 前提条件
リンクのコピー

ManagedServiceAccount アドオンが有効になっていることを確認する。ManagedServiceAccount アドオン を参照してください。

1.1.2. Red Hat Advanced Cluster Management に対する仮想マシンアクションを有効にする
リンクのコピー

検索 Operator に virtual-machine-preview=true アノテーションを追加することで、Red Hat Advanced Cluster Management の仮想マシンアクションを有効化できます。次のコマンドを実行して、アノテーションを追加します。 

oc annotate search search-v2-operator -n open-cluster-management virtual-machine-preview='true'
Copy to Clipboard Toggle word wrap

検索 Operator ステータスを確認することで、Red Hat Advanced Cluster Management の仮想マシンアクションが有効になっていることを確認できます。 

status:
  conditions:
    - lastTransitionTime: '2024-12-09T20:14:18Z'
      message: Virtual machine actions are enabled.
      reason: None
      status: 'True'
      type: VirtualMachineActionsReady
Copy to Clipboard Toggle word wrap

1.1.3. 仮想マシンのアクションを無効にする
リンクのコピー

Red Hat Advanced Cluster Management の仮想マシンアクションを無効にするには、次のコマンドを実行して virtual-machine-preview アノテーションを削除します。 

oc annotate search search-v2-operator -n open-cluster-management virtual-machine-preview-
Copy to Clipboard Toggle word wrap

Red Hat Advanced Cluster Management に対する仮想マシンアクションが無効になります。

1.2. Observability フィールドによる仮想マシンのメトリクスの表示
リンクのコピー

ハブクラスターに Observability サービスがインストールされている場合は、Red Hat Advanced Cluster Management コンソールの Observability フィールドにアクセスして、仮想マシンのメトリクスを表示できます。

次の手順を実行して、Observability フィールドにアクセスします。

  1. Red Hat Advanced Cluster Management コンソールで、Virtual Machine ページに移動します。

  2. Observability dashboards リンクを選択して、Grafana ダッシュボードを起動します。

    1. オプション: Launch links テーブルセルの Observability metrics リンクを選択して Grafana ダッシュボードを起動します。
  3. Grafana ダッシュボードから、仮想マシンと個々のメトリクスを表示します。

Red Hat Advanced Cluster Management のバックアップおよび復元コンポーネントを使用して、OpenShift Virtualization リソースのバックアップと復元に使用できる Red Hat Advanced Cluster Management のポリシーをインストールします。このポリシーを使用すると、OpenShift APIs for Data Protection (OADP) を使用して仮想マシンをバックアップおよび復元できます。仮想マシンをバックアップした後、ハブクラスターまたはマネージドクラスターで仮想マシンを実行および復元できます。

このような OpenShift Virtualization 用の Red Hat Advanced Cluster Management のポリシーは、次のバックアップおよび復元ストレージオプションをサポートしています。

  • Container Storage Interface (CSI) バックアップ
  • DataMover による Container Storage Interface (CSI) バックアップ

以下のオプションはサポートされていません。

  • ファイルシステムのバックアップと復元
  • ボリュームスナップショットのバックアップと復元

ポリシーを設定し、バックアップスケジュールを有効にするか、仮想マシンの復元操作を実行するには、次のセクションの手順を完了してください。

1.3.1. 仮想マシンのバックアップと復元
リンクのコピー

次の手順を実行すると、クラスター上で実行されている仮想マシンをバックアップしたり、クラスターに仮想マシンを復元したりできます。

  1. MultiClusterHub の cluster-backup パラメーターを true に設定して、ハブクラスター上のバックアップコンポーネントを有効にします。

  2. cluster-name クラスターにポリシーを適用するために、次の YAML サンプルを使用して、ManagedCluster リソースに acm-virt-config ラベルを追加します。 

    apiVersion: cluster.open-cluster-management.io/v1
kind: ManagedCluster
metadata:
 name: cluster-name
 labels:
   acm-virt-config: acm-dr-virt-config
    1
    Copy to Clipboard Toggle word wrap
    1
    ラベルアノテーションを介して渡される acm-dr-virt-config は、acm-virt-config ConfigMap です。acm-dr-virt-config ConfigMap セクションで、OADP とバックアップストレージの場所を設定する方法を参照してください。

  3. 仮想マシンをバックアップするか復元するかに応じて、次の手順を実行します。

    1. 仮想マシンをバックアップするには、cluster.open-cluster-management.io/backup-vm を kubevirt.io.VirtualMachine リソースに追加します。kubevirt.io.VirtualMachine リソースは、次の YAML サンプルのようになります。 
    apiVersion: kubevirt.io/v1
kind: VirtualMachine
metadata:
  name: vm-name
  labels:
    cluster.open-cluster-management.io/backup-vm: daily_8am
    Copy to Clipboard Toggle word wrap
    1. 仮想マシンを復元するには、acm-dr-virt-restore-config セクションの説明に従って、acm-dr-restore-config ConfigMap を更新します。

1.3.2. ハブクラスターにインストールされる仮想化ポリシー
リンクのコピー

バックアップ Operator を有効にすると、Red Hat Advanced Cluster Management のポリシーと ConfigMap のセットがハブクラスターにインストールされます。ポリシーを無効にするか、クラスターから削除すると、ポリシーによって作成されたすべてのリソースが削除されます。利用可能なさまざまな種類のポリシーの詳細を確認するには、次のセクションを参照してください。

1.3.2.1. インストールポリシー
リンクのコピー

acm-dr-virt-install インストールポリシーは、このポリシーが適用されているクラスターに OADP をインストールし、oadp.openshift.io.DataProtectionApplication リソースを設定します。クラスターがハブクラスターである場合は、OADP が open-cluster-management-backup namespace にインストールされていること、および DataProtectionApplication リソースが存在し、必要な設定になっていることを確認します。このポリシーは、ハブクラスターに OADP をインストールすることも、DataProtectionApplication リソースを作成することもありません。

MultiClusterHub リソースで cluster-backup オプションを有効にすると、バックアップチャートによって OADP がインストールされます。cluster-backup-option を有効にすると、ハブクラスターに DataProtectionApplication が作成されます。

次のインストールポリシーテンプレートと説明を参照してください。

  1. インストールポリシーテンプレート
Expand

テンプレート

説明

check-config-file

ManagedCluster リソースに設定された acm-virt-config ラベルによって定義された ConfigMap が、ハブの open-cluster-management-backup namespace に存在することを確認します。

check-oadp-channel

クラスターに OADP バージョンがインストールされているか、またそれがポリシーによってインストールされるバージョンと一致しているかどうかを確認します。

check-dpa-config

DataProtectionApplication リソースが存在し、想定どおりの設定を持ち、ステータスが Reconciled であることを確認します。BackupStorageLocation が存在し、ステータスフェーズが Available であることを確認します。

install-oadp-copy-config

OADP がインストールされる namespace を作成します (この namespace が検出されない場合)。OADP シークレットをコピーし、OADP をインストールします (マネージドクラスターの場合のみ)。acm-virt-config ラベルによって定義された DataProtectionApplication リソースを作成します (マネージドクラスターの場合のみ)。ハブクラスターでは、ユーザーが OADP と DataPotectionApplication を手動で作成する必要があります。

1.3.2.2. バックアップポリシー
リンクのコピー

acm-dr-virt-backup バックアップポリシーは、ラベル cluster.open-cluster-management.io/backup-vm: schedule_cron_name を持つ kubevirt.io.VirtualMachine リソースをバックアップします。

次のバックアップポリシーテンプレートと説明を参照してください。

  1. バックアップポリシーテンプレート
Expand

テンプレート

説明

check-cron-schedule-valid

仮想マシン cluster.open-cluster-management.io/backup-vm ラベルによって使用される cron スケジュール名が、cron スケジュールの ConfigMap で見つからない場合に、違反エラーを表示します。cron スケジュールの ConfigMap の名前が、schedule_hub_config_name プロパティーによって定義されており、open-cluster-management-backup namespace で使用可能である必要があります。

check-backup-status-completed

スケジュールが一時停止されていない場合に、ステータスが Enabled であることを確認します。このスケジュールによって生成された最新のバックアップを検索し、ステータスが Completed であることを確認します。このバックアップに対して DataUpload が作成されている場合、ステータスは Completed になります。これらの条件のいずれかが True でない場合は違反が表示されます。

create-virt-backup

cluster.open-cluster-management.io/backup-vm ラベルを持つすべての仮想マシンリソースの Velero スケジュールを作成します。仮想マシンのラベルで検出された cron ジョブスケジュールごとに 1 つのスケジュールを作成します。同じ cron ジョブスケジュールを共有する仮想マシンを同じバックアップでバックアップします。acm-dr-virt-install ポリシーに準拠している場合にのみ、Velero スケジュールリソースを作成します。

1.3.2.3. 復元ポリシー
リンクのコピー

acm-dr-virt-restore 復元ポリシーは、UID によって kubevirt.io.VirtualMachine リソースを復元します。このポリシーは、acm-dr-virt-config ConfigMap の restore_hub_config_name プロパティーによって識別される ConfigMap の情報を使用して、クラスターに velero 復元リソースを作成します。

次の復元ポリシーテンプレートと説明を参照してください。

  1. 復元ポリシーテンプレート
Expand

テンプレート

説明

check-velero-restore-status

clusterID_restoreName プロパティーによって定義された名前を持つ復元リソースが存在し、そのステータスが Completed であることを確認します。

create-velero-restore

clusterID_restoreName プロパティー値が空でなく、clusterID がこのクラスターの UID と一致する場合に、restore_hub_config_name によって識別される ConfigMap で定義されたプロパティーを使用して、Velero 復元リソースを作成します。acm-dr-virt-install ポリシーに準拠している場合にのみ、Velero 復元リソースを作成します。

1.3.3. ConfigMaps によるポリシーの定義
リンクのコピー

ハブクラスターにポリシーをインストールすると、ハブクラスターの open-cluster-management-backup namespace に次の ConfigMap が作成されます。ハブクラスターまたはマネージドクラスターに仮想化ポリシーを適用すると、次の ConfigMap によって仮想化ポリシーのバックアップおよび復元設定が定義されます。

1.3.3.1. acm-dr-virt-config ConfigMap の定義
リンクのコピー

acm-dr-virt-config ConfigMap は、OADP の設定と、バックアップまたは復元操作に関連するその他の設定を定義します。このリソースの名前は、ポリシーが適用されている ManagedCluster に設定されている acm-virt-config ラベルの値として使用できます。また、acm-dr-virt-config をサンプルとして使用する新しい ConfigMap を作成し、この新しい ConfigMap を使用してクラスターに仮想化ポリシーを適用することもできます。

マネージドクラスターまたはハブクラスターに仮想化ポリシーを適用するには、次の手順を実行します。

  1. acm-dr-virt-config を使用するか、または、acm-dr-virt-config ConfigMap を例として使用して、ハブクラスターの open-cluster-management-backup namespace に新しい ConfigMap を作成します。この例では、新しい ConfigMap の名前は acm-dr-virt-config-new です。

    1. OADP によって作成されたバックアップが保存されるストレージ場所と一致するように dpa_spec セクションを更新します。この更新は必須です。
    2. オプション: OADP バージョンやチャネルなど、acm-dr-virt-config-new ConfigMap で使用可能なその他のプロパティーを更新します。
  2. ManagedCluster リソースに acm-virt-config=acm-dr-virt-config-new ラベルを追加します。acm-virt-config ラベルの値は、作成した ConfigMap の名前です。

ManagedCluster リソースの例は、次の YAML サンプルを参照してください。acm-dr-virt-config-new ConfigMap を使用するように仮想化バックアップラベルが設定されています。 

apiVersion: cluster.open-cluster-management.io/v1
kind: ManagedCluster
metadata:
 name: managed-cluster-name
 labels:
   acm-virt-config: acm-dr-virt-config-new
Copy to Clipboard Toggle word wrap

詳細は、次の表を参照してください。

  1. acm-dr-virt-install ポリシーの ConfigMap プロパティー
Expand

名前

説明

型

デフォルト値

任意

channel

チャネルは、OpenShift Container Platform クラスターのバージョンに基づいて、サポートされている OADP バージョンにデフォルト設定されます。このプロパティーを使用してデフォルト値を上書きします。

文字列

なし

はい

channelName

OADP チャネルの名前。カスタムインストールの場合はこのプロパティーを設定します (例: offline install)。

文字列

redhat-oadp-operator

はい

subscriptionSource

OADP サブスクリプション。カスタムインストールの場合はこのプロパティーを設定します (例: offline install)。

文字列

redhat-operators

はい

subscriptionSourceNamespace

OADP サブスクリプションのソース。カスタムインストールの場合はこのプロパティーを設定します (例: offline install)。

文字列

openshift-marketplace

はい

subscriptionStartingCSV

OADP サブスクリプションの startingCSV。

文字列

なし

はい

subscriptionInstallPlanApproval

OADP インストールプラン。

文字列

自動

はい

backupNS

OADP がインストールされるマネージドクラスターの namespace。

文字列

なし

いいえ

credentials_hub_secret_name

マネージドクラスターで使用される OADP シークレットの名前。この名前を持つシークレットが、ハブクラスターの open-cluster-management-backup namespace に存在する必要があります。このシークレットは、インストールポリシーによって、ハブクラスターの指定された backupNS namespace に移動されます。

String

なし

いいえ

credentials_name

Velero の認証情報名を設定するときに、マネージドクラスター上の OADP DataProtectionApplication リソースによって使用されるシークレットの名前。

JSON

なし

いいえ

dpa_name

マネージドクラスターに作成される DataProtectionApplication リソースの名前。

文字列

なし

いいえ

dpa_spec

DataProtectionApplication 仕様を定義する有効な JSON (マネージドクラスターに作成される場合)。

JSON

なし

なし

  1. acm-dr-virt-backup ポリシーの ConfigMap プロパティー
Expand

名前

説明

型

デフォルト値

任意

scheduleTTL

バックアップの有効期限。

文字列

24h0m0s

はい

schedule_paused

仮想化バックアップのスケジュールを一時停止するには、True に設定します。

文字列

False

はい

schedule_hub_config_name

有効な cron ジョブスケジュールを定義するために使用される ConfigMap の名前。この名前を持つ ConfigMap が、ハブクラスターの open-cluster-management-backup namespace に存在する必要があります。

String

なし

はい

  1. acm-dr-virt-restore ポリシーの ConfigMap プロパティー
Expand

名前

説明

型

デフォルト値

任意

restore_hub_config_name

復元操作を定義するために使用される ConfigMap の名前。この名前を持つ ConfigMap が、ハブクラスターの open-cluster-management-backup namespace に存在する必要があります。

String

なし

いいえ

1.3.3.2. acm-dr-virt-schedule-cron ConfigMap の定義
リンクのコピー

acm-dr-virt-schedule-cron ConfigMap は、仮想マシンのバックアップをスケジュールするときに使用する有効な cron ジョブスケジュールを定義するために使用します。acm-dr-virt-schedule-cron ConfigMap は、open-cluster-management-backup namespace 内のハブクラスターバックアップコンポーネントによって作成され、次の YAML を内容として含んでいます。 

apiVersion: v1
kind: ConfigMap
    metadata:
        name: acm-dr-virt-schedule-cron
        namespace: open-cluster-management-backup
    data:
        hourly: "0 */1 * * *"
        every_2_hours: "0 */2 * * *"
        every_3_hours: "0 */3 * * *"
        every_4_hours: "0 */4 * * *"
        every_5_hours: "0 */5 * * *"
        every_6_hours: "0 */6 * * *"
        twice_a_day: "0 */12 * * *"
        daily_8am: "0 8 * * *"
        every_sunday: "0 0 * * 0"
Copy to Clipboard Toggle word wrap

acm-dr-virt-schedule-cron ConfigMap のスケジュールは、いずれも kubevirt.io.VirtualMachine のバックアップスケジュールを設定するのに使用できます。たとえば、毎日午前 8 時に仮想マシンをバックアップする場合は、仮想マシンリソースに次のラベルを追加します。 

apiVersion: kubevirt.io/v1
kind: VirtualMachine
metadata:
  name: vm-name
  labels:
    cluster.open-cluster-management.io/backup-vm: daily_8am
Copy to Clipboard Toggle word wrap

この acm-dr-virt-schedule-cron ConfigMap は、ハブクラスターバックアップコンポーネントによって作成および管理されます。そのため、ユーザーが既存の cron プロパティーを変更または削除することはできません。プロパティーはコンテンツの調整時に再作成されます。既存のプロパティーに新しいプロパティーを追加することだけは可能です。たとえば、毎週土曜日に実行する cron ジョブを作成する場合は、既存の acm-dr-virt-schedule-cron プロパティーに every_sunday: "0 0 * * SAT" というラベルを追加します。

1.3.3.3. acm-dr-virt-restore-config ConfigMap の定義
リンクのコピー

acm-dr-virt-restore-config ConfigMap は、acm-dr-virt-restore ポリシーによって実装される復元操作を定義するために使用します。この ConfigMap は、open-cluster-management-backup namespace 内のハブバックアップコンポーネントによって作成されます。

詳細な復元操作の例は、次の YAML サンプルを参照してください。 

kind: ConfigMap
apiVersion: v1
metadata:
 name: acm-dr-virt-restore-config
 namespace: open-cluster-management-backup
data:
 2a054d24-3235-4249-9c81-f58ebc6110c7_backupName: acm-rho-virt-schedule-every-10-hours-20250120230438
1 

 2a054d24-3235-4249-9c81-f58ebc6110c7_restoreName: restore-20250120230438
2 

 2a054d24-3235-4249-9c81-f58ebc6110c7_vmsUID: 2a054d24-3235-4249-9c81-f58ebc6110c7
3
Copy to Clipboard Toggle word wrap
1
2a054d24-3235-4249-9c81-f58ebc6110c7 は、復元を完了する必要がある clusterId です。acm-rho-virt-schedule-every-10-hours-20250120230438 は、復元操作に使用するバックアップの名前です。
2
restore-20250120230438 は、この復元操作の結果として作成される復元リソースの名前です。
3
2a054d24-3235-4249-9c81-f58ebc6110c7 は、復元する acm-rho-virt-schedule-every-10-hours-20250120230438 バックアップでバックアップされた仮想マシンの UID です。

1.3.4. 復元ポリシーを使用した復元操作の作成
リンクのコピー

復元操作のために仮想化ポリシーをインストールする場合は、次の状況を考慮してください。

  • acm-dr-virt-restore-config ConfigMap の clusterID_restoreName プロパティーを空の値に設定すると、clusterID を持つクラスター上の acm-dr-virt-restore ポリシーによって作成された復元リソースが削除されます。
  • acm-dr-virt-restore-config ConfigMap の clusterID_restoreName プロパティーを空でない値に設定すると、acm-dr-virt-restore ポリシーによって Velero 復元リソースが作成されます。この Velero 復元リソースの名前は、clusterID_restoreName 値と同じになります。この名前を持つ復元リソースが復元クラスターから削除されると、acm-dr-virt-restore ポリシーによってリソースが再作成され、復元操作が再度実行されます。

  • 次のアクションを検討してください。

    • 復元を再度実行しない場合は、復元リソースを削除しないでください。
    • 復元操作が正常に完了したことが確認されたらすぐに、acm-dr-virt-restore-config ConfigMap の clusterID_restoreName を空に設定します。これを行うと、acm-dr-virt-restore ポリシーを無効にして再度有効にしたときに、復元操作を再実行する必要がなくなります。acm-dr-virt-restore ポリシーを無効にすると、復元クラスター上でこのポリシーによって作成されたすべてのリソースがクリーンアップされ、ポリシーを再度有効にしたときに再作成されます。

法律上の通知
リンクのコピー

Copyright © 2025 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

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

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

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

会社概要

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

Theme

© 2026 Red Hat