Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

ボリュームを非同期で複製する

このページでは、Google Distributed Cloud（GDC）エアギャップブロックストレージボリュームの非同期レプリケーションを設定して実行する方法について説明します。

非同期レプリケーションは、ある GDC ゾーンから別の GDC ゾーンにデータを複製するために使用されます。ソースゾーンのデータが使用できなくなった場合、複製されたデータをフェイルオーバーに使用できます。フェイルオーバーが作成されると、元のボリュームを同じ宛先ボリュームにレプリケートすることはできません。代わりに、新しいレプリケーション関係を作成する必要があります。

KRM API を使用して PVC を管理するプラットフォーム管理者の場合は、プラットフォーム管理者向けにボリュームを非同期で複製するをご覧ください。

始める前に

非同期ブロックレプリケーションを使用するには、インフラストラクチャオペレーター（IO）がまず非同期レプリケーション用に 2 つのゾーンを設定する必要があります。

次に、VolumeReplicationRelationship リソースを管理するための app-volume-replication-admin-global ロールがあることを確認します。グローバル API が使用できない場合は、volume-replication-admin ロールを使用して、ゾーン VolumeReplicationRelationshipReplica リソースを直接変更できます。

レプリケーションを設定する

VolumeReplicationRelationship カスタムリソース（CR）は、非同期ブロックレプリケーション API を処理します。この CR はグローバル Management API に存在します。特定のブロックデバイスのレプリケーションを有効にするには、グローバル Management API で VolumeReplicationRelationship CR を作成する必要があります。

Replicate PVC API

kubectl --kubeconfig MANAGEMENT_API_SERVER apply -f - <<EOF
apiVersion: storage.global.gdc.goog/v1
kind: VolumeReplicationRelationship
metadata:
  name: VRR_NAME
  namespace: PROJECT
spec:
  source:
    pvc:
      clusterRef: SOURCE_USER_CLUSTER_NAME
      pvcRef: PVC_NAME
    zoneRef: SOURCE_ZONE_NAME
  destination:
    pvc:
      clusterRef: DESTINATION_USER_CLUSTER_NAME
    zoneRef: DESTINATION_ZONE_NAME
EOF

次のように置き換えます。

MANAGEMENT_API_SERVER: ゾーン API サーバーの kubeconfig パス。
VRR_NAME: VolumeReplicationRelationship リソースの名前。
PROJECT: Project リソースの Namespace。
SOURCE_USER_CLUSTER_NAME: 接続するソースユーザークラスタリソースの名前。
PVC_NAME: PersistentVolumeClaim リソースの名前。
SOURCE_ZONE_NAME: ソースゾーンリソースの名前。
DESTINATION_USER_CLUSTER_NAME: 接続する宛先ユーザークラスタリソースの名前。
DESTINATION_ZONE_NAME: 宛先ゾーンリソースの名前。

この例では、my-org という名前の組織に PROJECT という名前のプロジェクトが作成され、PVC_NAME という名前の PVC がすでにプロビジョニングされていることを前提としています。SOURCE_USER_CLUSTER_NAME は PVC が存在するソースクラスタの名前で、DESTINATION_USER_CLUSTER_NAME は新しい PVC が存在する宛先クラスタの名前です。

仕様の source フィールドと destination フィールドは、データの複製元と複製先をそれぞれ示します。この例では、データは SOURCE_ZONE_NAME から DESTINATION_ZONE_NAME に複製されます。

仮想マシンディスクを複製する

VolumeReplicationRelationship は、非同期仮想マシンディスク（VM ディスク）レプリケーション API も処理します。複製されるソースディスクはプライマリディスクと呼ばれます。レプリケーション先のディスクはセカンダリディスクと呼ばれます。プライマリディスクで非同期レプリケーションを開始すると、セカンダリディスクが自動的に作成されます。

権限とアクセスをリクエストする

仮想マシンディスクを複製するには、プロジェクト仮想マシン管理者のロールが必要です。手順に沿って、VM ディスクが存在するプロジェクトの名前空間にプロジェクト VirtualMachine 管理者のロール（project-vm-admin）があることを確認します。

gdcloud CLI を使用して仮想マシンを操作するには、IAM プロジェクト管理者に、プロジェクト仮想マシン管理者ロールとプロジェクト閲覧者（project-viewer）ロールの両方を割り当てるようリクエストします。

gdcloud

gdcloud compute disks start-async-replication PRIMARY_DISK_NAME \
  --project PROJECT --zone PRIMARY_ZONE \
  --secondary-disk SECONDARY_DISK_NAME --secondary-zone SECONDARY_ZONE

次のように置き換えます。

変数	定義
`PRIMARY_DISK_NAME`	レプリケートされるソースディスクの名前。
`PROJECT`	プライマリディスクの GDC プロジェクト。
`PRIMARY_ZONE`	プライマリディスクが存在するゾーン。
`SECONDARY_DISK_NAME`	レプリケーション先のディスクの名前。
`SECONDARY_ZONE`	セカンダリディスクが存在する必要があるゾーン。

VM Disk API

非同期レプリケーションを開始する

kubectl を使用して、VM ディスクで非同期レプリケーションを開始します。

kubectl --kubeconfig MANAGEMENT_API_SERVER apply -f - <<EOF
apiVersion: storage.global.gdc.goog/v1
kind: VolumeReplicationRelationship
metadata:
  name: VRR_NAME
  namespace: PROJECT
spec:
  destination:
    volumeOverrideName: VIRTUAL_MACHINE_DESTINATION_DISK_NAME
    zoneRef: DESTINATION_ZONE_NAME
  source:
    virtualMachineDisk:
      virtualMachineDiskRef: VIRTUAL_MACHINE_SOURCE_DISK_NAME
    zoneRef: SOURCE_ZONE_NAME
EOF

次のように置き換えます。

MANAGEMENT_API_SERVER: ゾーン API サーバーの kubeconfig パス。
VRR_NAME: VolumeReplicationRelationship リソースの名前。
PROJECT: Project リソースの Namespace。
VIRTUAL_MACHINE_DESTINATION_DISK_NAME: 宛先の VirtualMachineDisk リソースの名前。
DESTINATION_ZONE_NAME: 宛先ゾーンリソースの名前。
VIRTUAL_MACHINE_SOURCE_DISK_NAME: 移行元の VirtualMachineDisk リソースの名前。
SOURCE_ZONE_NAME: ソースゾーンリソースの名前。

この例では、my-org という名前の組織に PROJECT という名前のプロジェクトが作成され、VIRTUAL_MACHINE_SOURCE_DISK_NAME という名前の VirtualMachineDisk が VirtualMachine リソースにすでにプロビジョニングされていることを前提としています。

検証

グローバル API から VolumeReplicationRelationship CR を取得して、レプリケーション関係のステータスを確認します。次の例をご覧ください。なお、出力は簡略化のために切り捨てられています。

kubectl --kubeconfig MANAGEMENT_API_SERVER get volumereplicationrelationship VRR_NAME \
        -n PROJECT -o yaml

出力は次のようになります。

PVC API

apiVersion: storage.global.gdc.goog/v1
kind: VolumeReplicationRelationship
metadata:
  name: my-pvc-repl
  namespace: my-project
spec:
  destination:
    pvc:
      clusterRef: my-pvc-cluster
    zoneRef: zone2
  source:
    pvc:
      clusterRef: my-pvc-cluster
      pvcRef: my-block-pvc
    zoneRef: zone1
status:
  zones:
  - name: zone1
    replicaStatus:
      message: SnapMirror relationship has been established. Please check the destination
        zone for relationship state
      replicationID: a096621e-f062-11ef-ad24-00a0b89f23fb
      state: Established
  - name: zone2
    replicaStatus:
      exportedSnapshotName: snapmirror.c34f8845-e8c0-11ef-ad24-00a0b89f23fb_2150007868.2025-02-21_150000
      message: SnapMirror relationship has been successfully established
      replicationID: a096621e-f062-11ef-ad24-00a0b89f23fb
      state: Idle

VM Disk API

apiVersion: storage.global.gdc.goog/v1
kind: VolumeReplicationRelationship
metadata:
  name: my-vmdisk-vrr
  namespace: my-project
spec:
  destination:
    zoneRef: zone2
  source:
    virtualMachineDisk:
      virtualMachineDiskRef: my-vmdisk
    zoneRef: zone1
status:
  zones:
  - name: zone1
    replicaStatus:
      message: SnapMirror relationship has been established. Please check the destination
        zone for relationship state
      replicationID: a096621e-f062-11ef-ad24-00a0b89f23fb
      state: Established
  - name: zone2
    replicaStatus:
      exportedSnapshotName: snapmirror.c34f8845-e8c0-11ef-ad24-00a0b89f23fb_2150007868.2025-02-21_150000
      message: SnapMirror relationship has been successfully established
      replicationID: a096621e-f062-11ef-ad24-00a0b89f23fb
      state: Idle

フェイルオーバーの作成

何らかの理由でソースゾーンが使用できない場合は、宛先ゾーンの組織の管理プレーンに VolumeFailover CR を作成できます。v2 組織の場合、これは Management API サーバーになります。v1 組織の場合、これは組織の管理クラスタになります。たとえば、zone2 を宛先ゾーンとして指定する VolumeReplicationRelationship が作成され、PVC または VirtualMachineDisk が my-org 組織に存在する場合、VolumeFailover CR は zone2 の my-org 管理プレーンに作成されます。これにより、2 つのゾーン間のレプリケーション関係が解除され、ワークロードが宛先ゾーンの PVC または VirtualMachineDisk をマウントできるようになります。

  kubectl --kubeconfig MANAGEMENT_API_SERVER apply -f - <<EOF
  apiVersion: storage.gdc.goog/v1
  kind: VolumeFailover
  metadata:
    name: FAILOVER_NAME
    namespace: PROJECT
  spec:
    volumeReplicationRelationshipRef: VRR_NAME
  EOF

次のように置き換えます。

FAILOVER_NAME: VolumeFailover リソースの名前。
MANAGEMENT_API_SERVER: ゾーン API サーバーの kubeconfig パス。
VRR_NAME: VolumeReplicationRelationship リソースの名前。
PROJECT: Project リソースの Namespace。

その後、フェイルオーバーが成功すると、CR のステータスに反映されます。

  kubectl --kubeconfig MANAGEMENT_API_SERVER get volumefailover FAILOVER_NAME \
          -n PROJECT -o yaml

出力は次のようになります。

apiVersion: storage.gdc.goog/v1
kind: VolumeFailover
metadata:
  name: my-failover
  namespace: my-project
spec:
  volumeReplicationRelationshipRef: my-vrr-repl
status:
    state: Completed

フェイルオーバーが作成されると、my-vrr-repl VolumeReplicationRelationship は Broken Off 状態に移行します。zone2 の PVC または VirtualMachineDisk がマウント可能になりました。
この時点で、VolumeReplicationRelationship は次の例のようになります。ここでも、この出力は簡略化のために切り捨てられています。
```
kubectl --kubeconfig MANAGEMENT_API_SERVER get volumereplicationrelationship VRR_NAME \
        -n PROJECT -o yaml
```
出力は次のようになります。

PVC API

apiVersion: storage.global.gdc.goog/v1
kind: VolumeReplicationRelationship
metadata:
  name: my-vrr-repl
  namespace: my-project
spec:
  destination:
    pvc:
      clusterRef: my-pvc-cluster
    zoneRef: zone2
  source:
    pvc:
      clusterRef: my-pvc-cluster
      pvcRef: my-block-pvc
    zoneRef: zone1
status:
  zones:
  - name: zone1
    replicaStatus:
      message: SnapMirror relationship has been broken off
      replicationID: a096621e-f062-11ef-ad24-00a0b89f23fb
      state: Broken Off
  - name: zone2
    replicaStatus:
      exportedSnapshotName: snapmirror.c34f8845-e8c0-11ef-ad24-00a0b89f23fb_2150007868.2025-02-21_150000
      message: SnapMirror relationship has been broken off
      replicationID: a096621e-f062-11ef-ad24-00a0b89f23fb
      state: Broken Off

VM Disk API

apiVersion: storage.global.gdc.goog/v1
kind: VolumeReplicationRelationship
metadata:
  name: my-vmdisk-vrr
  namespace: my-project
spec:
  destination:
    zoneRef: zone2
  source:
    virtualMachineDisk:
      virtualMachineDiskRef: my-vmdisk
    zoneRef: zone1
status:
  zones:
  - name: zone1
    replicaStatus:
      message: SnapMirror relationship has been broken off
      replicationID: a096621e-f062-11ef-ad24-00a0b89f23fb
      state: Broken Off
  - name: zone2
    replicaStatus:
      exportedSnapshotName: snapmirror.c34f8845-e8c0-11ef-ad24-00a0b89f23fb_2150007868.2025-02-21_150000
      message: SnapMirror relationship has been broken off
      replicationID: a096621e-f062-11ef-ad24-00a0b89f23fb
      state: Broken Off

VolumeReplicationRelationship は、この CR で実行できる唯一の残りのアクションであるため、安全に削除できるようになりました。
```
kubectl --kubeconfig MANAGEMENT_API_SERVER delete volumereplicationrelationship VRR_NAME \
        -n PROJECT
```

ボリュームのサイズを変更する

ソースボリュームのサイズが変更された場合は、移行先ゾーンの対応するボリュームのサイズも変更する必要があります。宛先ゾーンのボリュームは、VolumeReplicationRelationship の作成時に作成されます。

ソースゾーンと宛先ゾーンの両方でストレージのサイズを変更するには、VM ディスクを拡張するドキュメントまたはボリューム容量を拡張するをご覧ください。

非同期レプリケーション関係を一覧表示する

kubectl を使用して、プロジェクト内の非同期レプリケーション関係を一覧表示します。

kubectl --kubeconfig MANAGEMENT_API_SERVER get volumereplicationrelationships -n PROJECT

次のように置き換えます。

PROJECT: プライマリディスクの GDC プロジェクト。
MANAGEMENT_API_SERVER: ゾーン管理 API サーバーの kubeconfig ファイル。

出力は次のようになります。

NAME       AGE     SOURCE ZONE   SOURCE PVC   SOURCE PVC CLUSTER   SOURCE VM DISK      DEST. ZONE   DEST. PVC CLUSTER   DEST. VOLUME OVERRIDE     STATE
my-vrr     3m21s   zone1                                           my-vm-boot-disk     zone2                            my-vm-boot-disk-replica
test-vrr   7s      zone1                                           test-vm-boot-disk   zone2

非同期レプリケーションを停止する

gdcloud または kubectl を使用して、プライマリ VM ディスクの非同期レプリケーションを停止します。

gdcloud

gdcloud compute disks stop-async-replication PRIMARY_DISK_NAME \
  --project PROJECT --zone PRIMARY_ZONE

次のように置き換えます。

変数	定義
`PRIMARY_DISK_NAME`	レプリケートされるソースディスクの名前。
`PROJECT`	プライマリディスクの GDC プロジェクト。
`PRIMARY_ZONE`	プライマリディスクが存在するゾーン。

API

プライマリ VM ディスクに対応するボリュームレプリケーション関係を見つけます。

kubectl --kubeconfig MANAGEMENT_API_SERVER get volumereplicationrelationships \
  -n PROJECT -o json | \
  jq -r '.items[] | select(.spec.source.virtualMachineDisk.virtualMachineDiskRef == "PRIMARY_DISK_NAME"
  and .spec.source.zoneRef == "PRIMARY_ZONE") | .metadata.name'

前の手順でリストしたボリュームレプリケーション関係をそれぞれ削除します。VRR_NAMES は、ボリュームレプリケーション関係の名前に置き換えます。

kubectl --kubeconfig MANAGEMENT_API_SERVER delete volumereplicationrelationships \
  -n PROJECT VRR_NAMES

次のように置き換えます。

変数	定義
`MANAGEMENT_API_SERVER`	グローバル Management API サーバーの kubeconfig ファイル。
`PROJECT`	プライマリディスクの GDC プロジェクト。
`PRIMARY_DISK_NAME`	レプリケートされるソースディスクの名前。
`PRIMARY_ZONE`	プライマリディスクが存在するゾーン。

なんらかの理由でソースゾーンが使用できない場合は、ボリュームフェイルオーバーを作成してレプリケーションを停止します。

レプリケートされたディスクを VM にアタッチする

レプリケーションが有効になっている間は、セカンダリディスクを VM にアタッチできません。レプリケーションが停止したら、セカンダリディスクを新しく作成した VM または既存の VM にアタッチできます。

ボリュームを非同期で複製する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

始める前に

レプリケーションを設定する

Replicate PVC API

仮想マシンディスクを複製する

権限とアクセスをリクエストする

gdcloud

VM Disk API

非同期レプリケーションを開始する

検証

PVC API

VM Disk API

フェイルオーバーの作成

PVC API

VM Disk API

ボリュームのサイズを変更する

非同期レプリケーション関係を一覧表示する

非同期レプリケーションを停止する

gdcloud

API

レプリケートされたディスクを VM にアタッチする

ボリュームを非同期で複製する