导入和导出虚拟机

借助 Migrate to Virtual Machines 导入和导出功能，您可以使用 CSV 文件创建、导出和/或修改迁移的虚拟机。

迁移先决条件

在使用导入和导出功能之前，您应该查看迁移单个虚拟机或虚拟机组的前提条件。在通过 CSV 管理迁移时，需要满足相同的前提条件。

如需详细了解迁移，请参阅有关以下内容的 Migrate to Virtual Machines 文档：

• 迁移单个虚拟机
• 迁移虚拟机组

导入和导出概览

您可以使用导出功能输出详细说明来源虚拟机或当前虚拟机及其目标详细信息的 CSV 文件，在外部对其进行修改，然后将 CSV 上传到 Migrate to Virtual Machines 来定义迁移。

修改和导入 CSV 文件时，您应该牢记迁移的结束状态。换句话说，您可以在 CSV 文件中定义设置，导入过程将创建迁移和群组、更改群组成员资格以及更新目标详细信息，以匹配导入的 CSV 文件的状态。

要为导入过程定义 CSV 文件，您有以下几个选项：

• 将现有迁移详细信息导出为 CSV 文件，以进行批量修改和群组上传
• 将源清单中的来源虚拟机导出为 CSV 文件
• 下载和修改模板 CSV 文件

如果 CSV 文件的格式不正确或特定的迁移详情无效，则在将其上传到 Migrate to Virtual Machines 时会收到错误。

注意：您不能使用导入和导出功能删除群组或迁移的虚拟机。

CSV 文件格式

在执行任何操作之前，系统会根据以下条件解析和验证导入的 CSV 文件：

• 迁移和来源虚拟机将被标识为来源名称、来源区域和来源虚拟机显示名或来源虚拟机 ID。
• 同一迁移或来源虚拟机不能出现在多个行中。
• 单个文件可以处理最多 100 个迁移或来源虚拟机。
• 如果来源虚拟机不存在迁移，则验证来源虚拟机的存在，并且将为它创建一个新的迁移。
• 导入和导出迁移功能通过类型和资源命名限制验证目标详细信息列。您应该手动验证目标项目中资源的存在情况以避免失败。
• CSV 文件中缺少的列将被忽略，并且不会更新这些字段中的迁移情况。但是，空值将更新相应的迁移并从该迁移中移除数据。
• 列可以包含每个虚拟机的多个值（例如网络标记或标签），并以换行符分隔。如需查看示例，请参阅导出模板文件。

某些验证错误将阻止继续导入。例如，无效的标题行或行数过多的文件将引发验证错误。

注意：您可以自行决定是否忽略行级警告。选择导入页面上的跳过错误并继续以继续操作。

CSV 文件字段

需要标题行，并且必须包含以下标识迁移或来源虚拟机的列。其他列为可选列，仅当列存在时才会在导入时更新。未知的标题列将予以忽略。

CSV 文件的必填字段包括：

• 来源名称
• 区域
• 来源虚拟机显示名或来源虚拟机 ID

如需详细了解可选字段，请参阅为迁移后的虚拟机配置目标。

注意：元数据值可能会很长，而且会包含换行符。导出和导入过程仅支持简单的单行值。如果迁移包含不支持的元数据值，则导出的 CSV 文件将被遮盖。重新导入同一 CSV 文件会忽略已隐去的元数据列。

模板文件

您可以导出模板文件，以帮助您定义 CSV 文件。模板 CSV 文件是空的，但标题行中详细说明了必填字段和可选字段，并且还具有一个示例行，其中提供了有关每一列应如何格式化的示例。在模板中，目标详细信息由 CSV 文件的列表示。

注意：模板提供的标题行是成功导入所必需的。

导出预填充的 CSV 文件

如需根据来源虚拟机创建迁移或更改现有迁移或迁移群组，您应首先导出表示迁移当前状态的 CSV 文件。

如需导出预填充的 CSV 文件，请按以下步骤操作：

1. 打开 Google Cloud 控制台中的 Migrate to Virtual Machines 页面。

2. 如需导出来源虚拟机列表，请执行以下操作：

   1. 选择来源标签页。
   2. 选择您要从清单中导出的来源虚拟机。
   3. 点击导出以下载 CSV 文件。

3. 如需导出现有迁移群组，请执行以下操作：

   1. 选择群组标签页。
   2. 从群组列表中选择要导出的群组。
   3. 点击导出以下载 CSV 文件。

导入 CSV 文件

上传 CSV 文件时，系统会验证该文件。如果文件中的某些行存在错误，则会显示这些错误，您可以选择跳过这些行并导入其余行。

上传经过验证的 CSV 文件时，系统将显示导入计划以获得批准。您的文件将在批准后导入。

如需导入 CSV 文件，请按以下步骤操作：

1. 打开 Google Cloud 控制台中的 Migrate to Virtual Machines 页面。
2. 选择群组标签页，然后选择导入。

3. 浏览您的导入文件。它必须为 CSV 文件，且不超过 100kB。

   提示：正在进行其他导入时，您无法上传 CSV 文件。

4. 选择上传。

   如果存在错误，系统会在此步骤中向您显示错误。您可以选择跳过错误并继续。

5. 然后，您会看到导入计划。这将详细说明正在调用哪些操作以及要引用哪些资源。

6. 选择开始导入以批准导入计划并开始导入。导入计划将根据每个步骤的进度进行更新。

7. 如果导入操作无法完成，请查看所提供的错误消息。任何一个步骤的失败都会停止整个序列。

8. 成功导入后，选择转到群组以返回群组页面，然后查看更新后的资源。

   注意：如果失败，您可以重试导入相同的 CSV 文件。鉴于导入过程的性质（其中 CSV 文件代表迁移的理想状态），导入和导出操作迁移过程将跳过已完成的操作，并从失败的位置继续。

查看您的导入计划

导入计划是根据导入文件中检测到的更改生成的操作列表。系统可能会列出以下类型的消息：

• 创建迁移。
• 创建群组。
• 从群组中移除迁移。
• 向群组添加迁移。
• 更新迁移的目标详情。

在接受导入计划后，每个项的状态都将在导入过程中更新。在报告中，您将看到状态，例如待处理、正在运行、完成和失败，因为它与每一项相关联。

导出迁移模板文件

您可以导出迁移模板文件，详细了解如何正确设置 CSV 文件的格式。

如需导出迁移模板文件，请按以下步骤操作：

1. 打开 Google Cloud 控制台中的 Migrate to Virtual Machines 页面。
2. 选择群组标签页。
3. 选择导入。
4. 选择导出模板，系统会提示您下载文件 Template.csv。