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

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

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

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

gdcloud CLI の使用を希望するアプリケーションオペレーターの場合は、アプリケーションオペレーター向けにボリュームを非同期で複製するをご覧ください。

始める前に

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

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

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

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

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 に複製されます。

VM Disk API

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

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

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

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

gdcloud CLI を使用した VM オペレーションの場合は、IAM プロジェクト管理者に、プロジェクト VirtualMachine 管理者ロールとプロジェクト閲覧者（project-viewer）ロールの両方を割り当てるようリクエストします。

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

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。
SOURCE_ZONE_NAME: ソースゾーンリソースの名前。
DESTINATION_ZONE_NAME: 宛先ゾーンリソースの名前。
VIRTUAL_MACHINE_SOURCE_DISK_NAME: 移行元の VirtualMachineDisk リソースの名前。
VIRTUAL_MACHINE_DESTINATION_DISK_NAME: 宛先の VirtualMachineDisk リソースの名前。

この例では、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

この CR で実行できる残りのアクションはの削除のみであるため、VolumeReplicationRelationship を削除しても問題ありません。
```
kubectl --kubeconfig MANAGEMENT_API_SERVER delete volumereplicationrelationship VRR_NAME \
        -n PROJECT
```

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

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

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

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

始める前に

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

PVC API

VM Disk API

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

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

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

検証

PVC API

VM Disk API

フェイルオーバーの作成

PVC API

VM Disk API

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

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