创建和管理区域级永久性磁盘卷

控制台

您必须先创建区域级永久性磁盘卷，然后将其挂接到现有虚拟机实例。您不能将区域级永久性磁盘卷作为启动磁盘进行创建，因为故障切换期间无法强制挂接此类磁盘。

创建区域级永久性磁盘卷

1. 在 Google Cloud 控制台中，转到磁盘页面。

   转到“磁盘”

2. 选择所需项目。

3. 点击创建磁盘。

4. 指定磁盘的名称。

5. 在位置部分，选择区域级。

6. 选择区域和可用区。您必须选择与创建虚拟机时选择的相同区域。

7. 选择同一区域中的副本可用区。记下所选的可用区，因为您必须将磁盘挂接到位于其中一个可用区的虚拟机。

8. 选择磁盘来源类型。

9. 选择磁盘类型和大小。默认值为 100 GiB 平衡永久性磁盘。

10. 点击创建以完成磁盘的创建。

将区域级永久性磁盘卷挂接到虚拟机

1. 如需将磁盘挂接到虚拟机，请进入虚拟机实例页面。

   转到虚拟机实例

2. 在名称列中，点击虚拟机的名称。

3. 点击修改 edit。

4. 点击 +挂接现有磁盘。

5. 选择要添加到虚拟机的区域级永久性磁盘。

6. 如果您看到一条警告，指示所选磁盘已挂接到其他实例，请选中强制挂接磁盘复选框，将该磁盘强制挂接到当前正在修改的虚拟机。

   如需详细了解强制挂接区域级永久性磁盘卷的应用场景，请参阅区域级永久性磁盘故障切换。

7. 点击保存。

8. 在修改虚拟机页面上，点击保存。

gcloud

使用 Google Cloud CLI 创建并挂接区域级永久性磁盘卷：

1. 使用 compute disks create 命令创建区域级永久性磁盘卷。如果您需要使用区域 SSD 永久性磁盘以实现更高的吞吐量或 IOPS，请添加 --type 标志并指定 pd-ssd。

   gcloud compute disks create DISK_NAME \
       --size=DISK_SIZE \
       --type=DISK_TYPE \
       --region=REGION \
       --replica-zones=ZONE1,ZONE2
   

   请替换以下内容：

   • DISK_NAME：新磁盘的名称
   • DISK_SIZE：新磁盘的大小（以 GB 为单位）
   • DISK_TYPE：永久性磁盘的类型。默认值为 pd-standard。
   • REGION：区域磁盘将驻留的区域，例如 europe-west1
   • ZONE1 和 ZONE2：两个磁盘副本所在区域内的可用区，例如 europe-west1-b,europe-west1-c

2. 通过使用 compute instances attach-disk 命令并将 --disk-scope 标志设置为 regional，将磁盘挂接到正在运行或已停止的虚拟机。

   gcloud compute instances attach-disk VM_NAME \
       --disk=DISK_NAME \
       --disk-scope=regional
   

   请替换以下内容：

   • VM_NAME：您要向其添加新区域级永久性磁盘卷的虚拟机的名称
   • DISK_NAME：您要挂接到虚拟机的新磁盘的名称

Terraform

如需创建区域级永久性磁盘卷，您可以使用 google_compute_region_disk 资源。

resource "google_compute_region_disk" "regiondisk" {
  name                      = "region-disk-name"
  snapshot                  = google_compute_snapshot.snapdisk.id
  type                      = "pd-ssd"
  region                    = "us-central1"
  physical_block_size_bytes = 4096
  size                      = 11

  replica_zones = ["us-central1-a", "us-central1-f"]
}

REST

1. 如需创建区域级永久性磁盘卷，请构建一个向 compute.regionDisks.insert 方法发出的 POST 请求。如需创建空白磁盘，请勿指定任何映像或快照来源。

   POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/disks
   {
    "name": "DISK_NAME",
    "region": "projects/PROJECT_ID/regions/REGION",
    "replicaZones": [
      "projects/PROJECT_ID/zones/ZONE1",
      "projects/PROJECT_ID/zones/ZONE2"
    ],
    "sizeGb": "DISK_SIZE",
    "type": "projects/PROJECT_ID/regions/REGION/diskTypes/DISK_TYPE"
   }
   

   请替换以下内容：

   • PROJECT_ID：您的项目 ID
   • REGION：区域磁盘将驻留的区域，例如 europe-west1
   • DISK_NAME：新磁盘的名称
   • ZONE1 和 ZONE2：新磁盘副本应位于的可用区
   • DISK_SIZE：新磁盘的大小（以 GB 为单位）
   • DISK_TYPE：永久性磁盘的类型。默认值为 pd-standard。

2. 如需挂接磁盘，请构建一个向 compute.instances.attachDisk 方法发出的 POST 请求，并将网址添加到您创建的永久性磁盘卷中。

   POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/attachDisk
   {
    "source": "/projects/PROJECT_ID/regions/REGION/disks/DISK_NAME"
   }
   

   请替换以下内容：

   • PROJECT_ID：您的项目 ID
   • ZONE：您的虚拟机的位置
   • VM_NAME：您要向其添加新永久性磁盘卷的虚拟机的名称
   • REGION：区域级磁盘所在的区域
   • DISK_NAME：新磁盘的名称

gcloud

gcloud compute instances create PRIMARY_INSTANCE_NAME  \
 --zone=ZONE  \
 --create-disk=^:^name=REPD_DISK_NAME:scope=regional:boot=true:source-snapshot=SNAPSHOT_NAME:replica-zones=ZONE,REMOTE_ZONE

指定磁盘参数时，字符 ^:^ 指定参数之间的分隔符是英文冒号 (:)。这样您可以在指定 replica-zones 参数时使用英文逗号 (,)。

替换以下内容：

• 将 PRIMARY_INSTANCE_NAME 替换为虚拟机名称
• 将 ZONE 替换为要创建虚拟机的可用区的名称
• 将 REPD_DISK_NAME 替换为区域级永久性磁盘的名称
• 将 SNAPSHOT_NAME 替换为您为启动磁盘创建的快照的名称
• 将 REMOTE_ZONE 替换为区域级永久性磁盘的备用可用区

REST

如需在虚拟机创建期间创建具有区域级磁盘的新虚拟机，请指定 boot: 'true' 和 replicaZones。例如：

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
 "name": "VM_NAME",
 "disks": [{
    "boot": true,
    "initializeParams": {
      "sourceSnapshot": "global/snapshots/BOOT_SNAPSHOT_NAME",
      "replicaZones": [
           "projects/PROJECT_ID/zones/ZONE",
           "projects/PROJECT_ID/zones/REMOTE_ZONE"]
   }
  }],
}

请替换以下内容：

• PROJECT_ID：您的项目 ID
• ZONE：要创建虚拟机的可用区的名称
• VM_NAME：虚拟机的名称
• BOOT_SNAPSHOT_NAME：启动磁盘快照的名称
• REMOTE_ZONE：区域级永久性磁盘的远程可用区

gcloud

gcloud compute instances create STANDBY_VM_NAME  \
 --zone=ZONE  \
 --disk=boot=yes,name=DISK_NAME,scope=regional,force-attach=true

请替换以下内容：

• 将 STANDBY_VM_NAME 替换为备用虚拟机的名称
• 将 ZONE 替换为将区域级永久性磁盘复制到的可用区的名称
• 将 DISK_NAME 替换为您要挂接的区域级永久性磁盘的名称。

可选：如果您由于服务中断或故障而无法成功将区域级永久性磁盘启动磁盘与其最初挂接到的虚拟机分离，请添加 force-attach=true。

gcloud

1. 停止虚拟机。

   gcloud compute instances stop STANDBY_VM_NAME  --zone=ZONE
   

2. 将当前启动磁盘与虚拟机分离。

   gcloud compute instances detach-disk STANDBY_VM_NAME  
   
    --zone=ZONE --disk=CURRENT_BOOT_DEVICE_NAME
   

3. 将区域级 Persistent Disk 永久性磁盘挂接到虚拟机。

   gcloud compute instances attach-disk STANDBY_VM_NAME  
   
    --zone=ZONE  
   
    --disk=REPD_DISK_NAME  
   
    --disk-scope=regional --force-attach
   

4. 重启虚拟机。

   gcloud compute instances start STANDBY_VM_NAME
   

将上述命令中的变量替换为以下变量：

• STANDBY_VM_NAME：您要将区域级永久性磁盘挂接到的虚拟机的名称
• ZONE：虚拟机所在的可用区
• CURRENT_BOOT_DEVICE_NAME：虚拟机正在使用的启动磁盘的名称。此名称通常与虚拟机名称相同。
• REPD_DISK_NAME：您要作为启动磁盘挂接到虚拟机的区域级永久性磁盘的名称

可选：如果您由于服务中断或故障而无法成功将区域级永久性磁盘启动磁盘与其最初挂接到的虚拟机分离，请添加 --force-attach 标志。

REST

1. 停止虚拟机。

   POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/STANDBY_VM_NAME/stop
   

2. 将当前启动磁盘与虚拟机分离。

   POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/STANDBY_VM_NAME/detachDisk?deviceName=CURRENT_BOOT_DEVICE_NAME
   

3. 将区域级永久性磁盘挂接到虚拟机。

   构建一个向 compute.instances.attachDisk 方法发出的 POST 请求，并在其中添加区域级永久性磁盘卷的网址：

   POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/STANDBY_VM_NAME/attachDisk
   {
   "source": "compute/v1/projects/PROJECT_ID/regions/REGION/disks/REPD_DISK_NAME",
   "boot": true
   }

4. 重启虚拟机。

   POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/STANDBY_VM_NAME/start
   

将上述命令中的变量替换为以下变量：

• PROJECT_ID：您的项目 ID
• STANDBY_VM_NAME：您要将区域级永久性磁盘挂接到的虚拟机的名称
• ZONE：虚拟机所在的可用区
• CURRENT_BOOT_DEVICE_NAME：虚拟机正在使用的启动磁盘的名称。此名称通常与虚拟机名称相同。
• REGION：区域级永久性磁盘所在的区域。
• REPD_DISK_NAME：您要作为启动磁盘挂接到虚拟机的区域级永久性磁盘的名称

可选：如果您由于服务中断或故障而无法成功将区域级永久性磁盘启动磁盘与其最初挂接到的虚拟机分离，请在请求正文中添加 "forceAttach": true。

控制台

调整区域永久性磁盘的大小。

1. 在 Google Cloud 控制台中，转到磁盘页面。

   转到“磁盘”

2. 选择要调整大小的磁盘。

3. 点击页面顶部的修改。

4. 输入磁盘的大小（以 GB 为单位）。

5. 点击保存以完成磁盘大小调整。

磁盘列表中会显示新的磁盘大小。

gcloud

在 gcloud CLI 中，使用 compute disks resize 命令调整区域永久性磁盘的大小。

gcloud compute disks resize DISK_NAME \
    --region=REGION  \
    --size=DISK_SIZE

请替换以下内容：

• DISK_NAME：您要调整大小的磁盘的名称
• REGION：磁盘所在的区域
• DISK_SIZE：磁盘的新大小（以 GB 为单位）。

Terraform

如需更改区域永久性磁盘的大小，您可以使用 google_compute_region_disk 资源并使用 size 参数。

resource "google_compute_region_disk" "regiondisk" {
  name                      = "region-disk-name"
  snapshot                  = google_compute_snapshot.snapdisk.id
  type                      = "pd-ssd"
  region                    = "us-central1"
  physical_block_size_bytes = 4096
  size                      = 11

  replica_zones = ["us-central1-a", "us-central1-f"]
}

如果添加 size 参数以及 image 或 snapshot 参数，则 size 值必须大于或等于映像或快照的大小。

如果省略 image 和 snapshot 参数，则可以将 size 参数设置为小于现有磁盘大小。如果您执行此操作，Terraform 会销毁该磁盘并新建一个空的永久性磁盘。在重新创建期间，Terraform 不会复制也未包含在 Terraform 配置中的其他数据，例如标签或快照时间表。为防止 Terraform 销毁并重新创建磁盘，您可以将 lifecycle.prevent_destroy = true 设置添加到 Terraform 配置中。

REST

如需调整区域级永久性磁盘的大小，请构建一个对 compute.regionDisks.resize 方法发出的 POST 请求。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/disks/DISK_NAME/resize

{
  "sizeGb": "DISK_SIZE"
}

替换以下内容：

• PROJECT_ID：您的项目 ID
• REGION：磁盘所在的区域
• DISK_NAME：您要调整大小的磁盘的名称
• DISK_SIZE：磁盘的新大小（以 GB 为单位）。

控制台

在多个虚拟机之间共享一个只读的永久性磁盘。

1. 在 Google Cloud 控制台中，前往虚拟机实例页面。

   转到虚拟机实例

2. 点击要向其挂接磁盘的虚拟机的名称。“虚拟机实例详情”页面随即打开。

3. 点击页面顶部的修改。

4. 在额外磁盘部分中，点击挂接现有磁盘。

5. 选择列表中的区域永久性磁盘。

6. 在模式部分中，选择只读。

7. 点击完成。

8. 在页面的底部，点击保存以将更改应用于虚拟机。

gcloud

在 gcloud CLI 中，通过使用 compute instances attach-disk 命令并将 --disk-scope 标志设置为 regional 以及将 --mode 标志设置为 ro，以在多个虚拟机之间共享一个只读的永久性磁盘。

gcloud beta compute instances attach-disk /VM_NAME \
    --disk=DISK_NAME \
    --disk-scope=regional \
    --mode=ro

请替换以下内容：

• VM_NAME：您要挂接永久性磁盘的虚拟机的名称
• DISK_NAME：您要挂接的磁盘的名称

REST

如需在多个虚拟机之间共享一个只读的永久性磁盘，请构建一个向 compute.instances.attachDisk 方法发出的 POST 请求。在请求正文中，将 mode 参数指定为 READ_ONLY。

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/attachDisk

{
  "source": "regions/REGION/disks/DISK_NAME",
  "mode": "READ_ONLY"
}

请替换以下内容：

• PROJECT_ID：您的项目 ID
• ZONE：虚拟机所在的区域
• VM_NAME：您要挂接永久性磁盘的虚拟机的名称。
• REGION：磁盘所在的区域
• DISK_NAME：您要挂接大小的磁盘的名称