异步复制卷

本页介绍了如何设置和执行 Google Distributed Cloud (GDC) 气隙式块存储卷的异步复制。

异步复制用于将数据从一个 GDC 可用区复制到另一个可用区。如果源可用区中的数据不可用，则可以在故障切换场景中使用此复制的数据。请注意，创建故障切换后，无法将原始卷设置为复制到同一目标卷。而是必须创建新的复制关系。

对于偏好使用 gdcloud CLI 的应用运维人员，请参阅异步复制卷。

准备工作

为了使用异步块复制，您的基础架构运维者 (IO) 必须先为异步复制设置两个可用区。

接下来，确保您拥有 volume-replication-admin-global 角色，以便管理 VolumeReplicationRelationship 资源。如果全局 API 不可用，可以使用 app-volume-replication-admin 角色直接修改区域 VolumeReplicationRelationshipReplica 资源。

设置复制

VolumeReplicationRelationship 自定义资源 (CR) 用于提供异步块复制 API 服务。此 CR 存在于全局管理 API 中。如需为给定的块设备启用复制，需要在全局管理 API 上创建 VolumeReplicationRelationship CR：

PVC API

必须提供项目绑定。确保您已将项目附加到每个参与可用区中的每个 Cluster 资源。

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 资源的命名空间。
  • SOURCE_USER_CLUSTER_NAME：要连接的源用户集群资源的名称。
  • PVC_NAME：PersistentVolumeClaim 资源的名称。
  • SOURCE_ZONE_NAME：源可用区资源的名称。
  • DESTINATION_USER_CLUSTER_NAME：要连接的目标用户集群资源的名称。
  • DESTINATION_ZONE_NAME：目标 Zone 资源的名称。

此示例假定在名为 my-org 的组织中创建了一个名为 PROJECT 的项目，并且已预配名为 PVC_NAME 的 PVC。SOURCE_USER_CLUSTER_NAME 是 PVC 所在的源集群的名称，DESTINATION_USER_CLUSTER_NAME 是将存在新 PVC 的目标集群的名称。

规范的 source 和 destination 字段分别表示数据复制的源和目标。在此示例中，数据从 SOURCE_ZONE_NAME 复制到 DESTINATION_ZONE_NAME。

虚拟机磁盘 API

复制虚拟机磁盘

VolumeReplicationRelationship 还为异步虚拟机磁盘 (VM 磁盘) 复制 API 提供服务。被复制的源磁盘称为主磁盘。要复制到的目标磁盘称为辅助磁盘。在主磁盘上启动异步复制会自动创建辅助磁盘。

请求权限和访问权限

如需复制虚拟机磁盘，您必须拥有项目虚拟机管理员角色。按照以下步骤验证您是否在虚拟机磁盘所在项目的命名空间中拥有 Project VirtualMachine Admin (project-vm-admin) 角色。

对于使用 gdcloud CLI 的虚拟机操作，请让您的项目 IAM 管理员为您分配“Project VirtualMachine Admin”角色和“Project Viewer”角色 (project-viewer)。

启动异步复制

使用 kubectl 在虚拟机磁盘上启动异步复制。

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 资源的命名空间。
  • SOURCE_ZONE_NAME：源可用区资源的名称。
  • DESTINATION_ZONE_NAME：目标 Zone 资源的名称。
  • VIRTUAL_MACHINE_SOURCE_DISK_NAME：源上的 VirtualMachineDisk 资源的名称。
  • VIRTUAL_MACHINE_DESTINATION_DISK_NAME：目标位置的 VirtualMachineDisk 资源的名称。

此示例假设在名为 my-org 的组织中创建了一个名为 PROJECT 的项目，并且已为 VirtualMachine 资源预配了名为 VIRTUAL_MACHINE_SOURCE_DISK_NAME 的 VirtualMachineDisk。

规范的 source 和 destination 字段分别表示数据复制的源和目标。在此示例中，数据从 SOURCE_ZONE_NAME 复制到 DESTINATION_ZONE_NAME。

验证

通过从全局 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

虚拟机磁盘 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 组织，这将是管理 API 服务器。对于 v1 组织，这将是组织管理员集群。例如，如果创建了一个 VolumeReplicationRelationship，其中指定 zone2 为目标可用区，并且 my-org 组织中存在 PVC 或 VirtualMachineDisk，则 VolumeFailover CR 会在 zone2 中 my-org 的管理平面中创建。这会中断两个可用区之间的复制关系，并允许目标可用区中的 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 资源的命名空间。

  • 之后，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

虚拟机磁盘 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 时代表用户创建的目标可用区中的相应卷也应调整大小以匹配。

如需调整源可用区和目标可用区中的存储空间大小，请参阅扩展虚拟机磁盘文档或扩展卷容量。