在地区之间移动实例

本页面介绍如何在地区之间移动虚拟机实例，方法包括使用 projects.moveInstance API，或通过一系列步骤手动移动。如果某个地区不可用或已弃用，您可以使用该方法将实例移动到其他地区。

您应当尽可能使用 projects.moveInstance API 自动移动实例。如果您无法使用该 API，则仍可以按照以下步骤手动移动实例：

创建挂接到原始实例的永久性磁盘的快照。
在目标地区中创建永久性磁盘的副本。
对于外部和内部 IP 地址：
- 如果您要跨同一区域内的多个地区移动实例，并且希望保留其临时 IP 地址，请暂时将分配给该实例的临时 IP 地址提升为静态 IP 地址，然后将其分配给在目标地区中创建的新虚拟机实例。
- 如果您要跨区域移动实例，则必须为虚拟机实例选择其他 IP 地址。
在目标地区中创建并启动新实例。如果您要跨区域移动，还必须为新实例选择新的子网。
将新的永久性磁盘挂接到新实例。
向新实例分配外部 IP 地址。如有必要，将该地址降级回临时外部 IP 地址。
删除快照、原始磁盘和原始实例。

准备工作

如果您要使用本指南中的命令行示例，请执行以下操作：
1. 安装或更新到 gcloud 命令行工具的最新版本。
2. 设置默认地区和区域。
如果您要使用本指南中的 API 示例，请设置 API 访问权限。
阅读地区文档。

要求

在您移动实例前，必须满足以下要求：

项目中必须有足够配额用于新快照及提升任何临时外部 IP 地址。
目标区域中必须有足够配额用于新实例和磁盘。例如，如果您要移动的实例挂接了三个磁盘，则需要足够的配额来创建三个临时永久性磁盘快照和三个新磁盘。创建新磁盘后，您可以删除临时快照。
挂接到要移动的实例的永久性磁盘未挂接到其他实例。
如果实例包含 GPU，请验证并确保您要使用的 GPU 在目标地区中可用。如需查看 GPU 及其相应可用地区的列表，请参阅 Compute Engine 上的 GPU。

请注意，您的虚拟机在移动时将关停，然后在移动后将重启。移动实例后，请更新您对原始资源的任何现有引用，例如指向旧实例的任何目标实例或目标池。

限制

尽可能使用 moveInstances API 来减轻工作负担，但在某些情况下您无法使用 moveInstances API。具体而言，需要进行手动移动的情况有：

虚拟机目前处于 TERMINATED 状态。
您想要在区域之间移动实例，例如在 us-west1-a 和 asia-south1-b 之间，并且您的虚拟机属于子网。您必须手动执行移动并为实例选择新的子网。
实例挂接了本地 SSD 或实例的 GPU 在目标地区不可用。
- 本地 SSD 用于临时存储，上面的数据在手动终止实例时不会保留，而您在移动实例时正需要手动将其终止。如果您需要保留本地 SSD 数据，请使用永久性磁盘等持久性存储选项对其进行复制。
- 如果目标地区不支持您所需的 GPU，请选择一个支持该 GPU 的新地区或在目标地区选择新的 GPU。
虚拟机正在使用启用了安全强化型虚拟机的映像，例如 Debian 10。

无论是手动还是自动移动，您都需要满足要求才能成功移动实例。

资源属性

在移动过程中，实例和磁盘的某些服务器生成的属性将发生变化。

针对实例更改的属性

属性名称	更改
内部 IP 地址	通常会分配新的内部 IP 地址，但实例有可能得以保留原来的内部 IP 地址。
外部 IP 地址	如果在同一区域内的地区之间移动实例，则外部 IP 地址将保持不变。否则，请为虚拟机实例选择其他 IP 地址。
CPU 平台	根据目标地区中的可用 CPU 平台，您的实例在移动后可能具有不同的 CPU 平台。如需查看各地区中 CPU 平台的完整列表，请参阅可用区域和地区。
网络/子网	如果您的实例属于子网，并且您要跨区域移动实例，则必须为实例选择新的子网。在同一区域内跨地区移动的实例保留相同的子网。

针对磁盘更改的属性

属性名称	更改
来源快照	新磁盘的来源快照设置为移动期间创建的临时快照。
来源快照 ID	来源快照 ID 设置为临时快照的 ID。
来源映像	来源映像字段为空。
映像 ID	映像 ID 为空。
上次分离时间戳	上次分离时间戳为空。
上次附加时间戳	上次附加时间戳更改为将新磁盘附加到新实例时的时间戳。

针对实例和磁盘更改的属性

属性名称	更改
ID	生成新的资源 ID。
创建时间戳	生成新的创建时间戳。
地区资源网址	所有地区资源网址都会更改，以反映目标地区。下面的列表显示了更改的资源网址：实例的来源磁盘网址实例的机器类型网址页内链接网址地区网址磁盘类型网址磁盘的 `users[]` 列表中所列实例的任何网址

自动移动实例

移动实例之前，请确保查看要求和限制。

gcloud

确保实例正在运行。然后，使用 gcloud 工具运行 compute instances move 子命令来移动实例。

例如，如需将一个名为 example-instance-1 的实例及其挂接的所有永久性磁盘从当前运行的 us-central1-b 区域移动到新区域 us-central1-f，请运行以下命令：

gcloud compute instances move example-instance-1 \
    --zone us-central1-b --destination-zone us-central1-f

API

在 API 中，向 moveInstance API 发出 POST 请求，其请求正文中包含 targetInstance 和 destinationZone。例如：

{
   "targetInstance": "zones/us-central1-b/instances/example-instance-1",
   "destinationZone": "zones/us-central1-f"
}

手动移动实例

您应当尽可能使用 moveInstance API 自动移动实例，因为它可为您处理移动实例所包含的全部步骤。但是，如果您无法使用该 API，则可以手动执行移动。

以下示例描述了如何将具有两个永久性磁盘 mybootdisk 和 mydatadisk 的 myinstance 实例从 europe-west1-a 移动到 us-west1-b。示例实例如下所示：

gcloud compute instances list

NAME       ZONE           MACHINE_TYPE  INTERNAL_IP    EXTERNAL_IP     STATUS
myinstance europe-west1-a n1-standard-4 10.240.116.177 146.148.112.106 RUNNING

如需将实例移动到另一个地区，请执行以下操作：

找出与您要移动的实例关联的磁盘。
转到“磁盘”页面

在此示例中，您将找到 myinstance 实例的以下两个关联磁盘：
- 名为 mybootdisk 的启动磁盘
- 名为 mydatadisk 的数据磁盘
将 mybootdisk 和 mydatadisk 的自动删除状态设置为 false，以确保在删除实例时不会自动删除磁盘。
```
gcloud compute instances set-disk-auto-delete myinstance --zone europe-west1-a \
    --disk mybootdisk --no-auto-delete
```
如果状态已更新，则 gcloud compute 将返回响应 Updated [...]。如果自动删除状态原来已设置为 false，则 gcloud compute 将返回以下响应：
```
No change requested; skipping update for [myinstance].
```
（可选）保存实例元数据。

当您删除实例时，实例元数据将一并移除。您可以将该信息保存在单独的文件中，然后将实例元数据重新应用到新实例。

按照以下方式描述实例的元数据：
```
gcloud compute instances describe myinstance --zone europe-west1-a
```
将内容保存到单独文件中。
创建数据的备份。

为保险起见，请在永久性磁盘仍挂接到实例时使用永久性磁盘快照创建数据的备份。在截取快照之前，为确保快照与永久性磁盘的状态一致，请清空磁盘缓冲区。

注意：如果您运行的是 Windows 实例，必须先终止该实例，然后才能创建快照。按照步骤为 Windows 实例创建快照。
清空磁盘缓冲区后，按如下所示创建快照：
```
gcloud compute disks snapshot mybootdisk mydatadisk \
    --snapshot-names backup-mybootsnapshot,backup-mydatasnapshot \
    --zone europe-west1-a
```
如需验证快照是否已创建，请运行 gcloud compute snapshots list。
（可选）如果您要跨同一区域内的多个地区移动实例，并且希望保留其临时内部或外部 IP 地址，请将该内部或外部 IP 地址提升为静态 IP 地址，稍后您可以重复使用该地址。

注意：如果您要跨区域移动实例，则无法保留实例的临时内部或外部 IP 地址。您必须在重新创建实例时选择新的 IP 地址。

删除实例。

删除实例将彻底关停该实例并分离任何永久性磁盘。

gcloud compute instances delete myinstance --zone europe-west1-a

gcloud 会提示您确认删除：

The following instances will be deleted. Any attached disks configured to be auto-deleted will be deleted unless they are attached to any other instances or the --keep-disks flag is given and specifies them for keeping. Deleting a disk is irreversible and any data on the disk will be lost. — [myinstance] in [europe-west1-a]

Do you want to continue (Y/n)?

由于您先前在此过程中关闭了磁盘的自动删除状态，因此，请输入 Y 以继续并忽略该警告。

接着，创建启动磁盘和数据磁盘的另一个快照。

gcloud compute disks snapshot mybootdisk mydatadisk \
    --snapshot-names mybootsnapshot,mydatasnapshot \
    --zone europe-west1-a

Created [.../mydatasnapshot].
Created [.../mybootsnapshot].

（可选）删除永久性磁盘。

如果打算为新磁盘重复使用永久性磁盘的名称，必须删除现有磁盘以释放这些名称。此外，删除磁盘还可以节省永久性磁盘存储费用。

如果您不打算重复使用相同的磁盘名称，您无需将其删除。
```
gcloud compute disks delete mybootdisk mydatadisk --zone europe-west1-a
```

使用创建的快照在 us-west1-b 中创建新的永久性磁盘。首先创建启动磁盘。

gcloud compute disks create mybootdiskb --source-snapshot mybootsnapshot \
    --zone us-west1-b

Created [.../mybootdiskb].
NAME        ZONE           SIZE_GB TYPE        STATUS
mybootdiskb us-west1-b     100     pd-standard READY

然后创建数据磁盘。

gcloud compute disks create mydatadiskb --source-snapshot mydatasnapshot \
    --zone us-west1-b

Created [.../mydatadiskb].
NAME        ZONE           SIZE_GB TYPE        STATUS
mydatadiskb us-west1-b 4000    pd-standard READY

在 us-west1-b 中重新创建实例。
- 如果您选择将实例元数据保存在一个文件中，例如 myinstance.describe 中，则可以使用它在实例上设置相同的元数据。
- 如果实例具有静态外部 IP 地址，您可以通过指定 --address [ADDRESS] 选项将该地址重新分配给新实例。如果您要跨区域移动实例，则必须为新的虚拟机实例选择其他外部 IP 地址。
- 如果实例具有静态内部 IP 地址，您可以通过指定 --private-network-ip ADDRESS 选项将该地址重新分配给新实例。如果您要跨区域移动实例，则必须为新的虚拟机实例选择其他内部 IP 地址。
- 如果实例包含 GPU，请使用 --accelerator 选项将 GPU 添加到实例。
- 如果实例使用特定子网，请添加 --subnet [SUBNET_NAME] 标志。
如需查看其他标志的完整列表，请参阅 gcloud compute instances create。
```
gcloud compute instances create myinstanceb --machine-type n1-standard-4 \
    --zone us-west1-b \
    --disk name=mybootdiskb,boot=yes,mode=rw \
    --disk name=mydatadiskb,mode=rw
```
```
Created [.../myinstanceb].
NAME        ZONE           MACHINE_TYPE  INTERNAL_IP    EXTERNAL_IP     STATUS
myinstanceb us-west1-b     n1-standard-4 10.240.173.229 146.148.112.106 RUNNING
```
（可选）删除永久性磁盘快照。

在您确认虚拟机已完成移动后，可通过删除创建的临时快照来节省存储费用。
```
gcloud compute snapshots delete mybootsnapshot mydatasnapshot
```
如果您不再需要备份快照，也请删除这些快照：
```
gcloud compute snapshots delete backup-mybootsnapshot backup-mydatasnapshot
```

后续步骤

了解如何为项目更改默认地区/区域。
了解实时迁移。
检查实例的状态。
了解如何将虚拟机迁移到 Compute Engine。