使用 Azure CLI 将 IaaS 资源从经典部署模型迁移到 Azure Resource Manager 部署模型

以下步骤演示如何使用 Azure 命令行接口 (CLI) 命令将基础结构即服务 (IaaS) 资源从经典部署模型迁移到 Azure Resource Manager 部署模型。本文中的操作需要 Azure CLI。

Note

此处描述的所有操作都是幂等的。如果你遇到功能不受支持或配置错误以外的问题，建议你重试准备、中止或提交操作。然后平台将重试操作。

下面是一个流程图，用于确定在迁移过程中需要执行步骤的顺序

步骤 1：准备迁移

下面是建议你在将 IaaS 资源从经典部署模型迁移到 Resource Manager 部署模型时遵循的一些最佳实践：

请参阅不受支持的配置或功能的列表。如果虚拟机使用不受支持的配置或功能，建议你等到我们宣布支持该功能/配置时再进行迁移。或者，可以删除该功能或移出该配置，以利迁移进行（如果这样做符合要求）。
如果你通过自动化脚本来部署目前的基础结构和应用程序，则可尝试使用这些脚本进行迁移，以便创建类似的测试性设置。也可以使用 Azure 门户设置示例环境。

Important

目前不支持通过应用程序网关从经典部署模型迁移到 Resource Manager 部署模型。若要迁移带应用程序网关的经典虚拟网络，请先删除该网关，然后运行准备操作来移动网络。完成迁移后，在 Azure Resource Manager 中重新连接该网关。

无法自动迁移其他订阅中连接到 ExpressRoute 线路的 ExpressRoute 网关。此类情况下，请删除 ExpressRoute 网关、迁移虚拟网络并重新创建网关。有关详细信息，请参阅将 ExpressRoute 线路和关联的虚拟网络从经典部署模型迁移到 Resource Manager 部署模型。

步骤 2：设置订阅并注册提供程序

对于迁移方案，需要针对经典部署模型和 Resource Manager 部署模型设置环境。安装 Azure CLI 并选择订阅。

登录到帐户。

复制

azure login -e AzureChinaCloud

使用以下命令选择 Azure 订阅。

复制

azure account set "<azure-subscription-name>"

Note

注册是一次性步骤，但必须在尝试迁移之前完成。如果不注册，你会看到以下错误消息

BadRequest : Subscription is not registered for migration.

使用以下命令向迁移资源提供程序注册。请注意，在某些情况下，此命令会超时。但是，注册会成功。

复制

azure provider register Microsoft.ClassicInfrastructureMigrate

请等五分钟让注册完成。可以使用以下命令来检查审批状态。请确保在继续操作之前，RegistrationState 为 Registered 。

复制

azure provider show Microsoft.ClassicInfrastructureMigrate

现在请将 CLI 切换到 asm 模式。

复制

azure config mode asm

步骤 3：请确保在当前部署或 VNET 的 Azure 区域中有足够的 Azure Resource Manager 虚拟机核心

要执行此步骤，需要切换到 arm 模式。使用以下命令执行此操作。

复制

azure config mode arm

可以使用以下 CLI 命令检查当前 Azure Resource Manager 中已有的核心数量。若要了解有关核心配额的详细信息，请参阅限制和 Azure Resource Manager。

复制

azure vm list-usage -l "<Your VNET or Deployment's Azure region"

验证完此步骤后，可以切换回 asm 模式。

复制

azure config mode asm

步骤 4：选项 1 - 迁移云服务中的虚拟机

使用以下命令获取云服务列表，然后选取要迁移的云服务。请注意，如果云服务中的 VM 在虚拟网络中或者具有 Web/辅助角色，你将收到错误消息。

复制

azure service list

运行以下命令，从详细输出中获取云服务的部署名称。在大多数情况下，部署名称与云服务名称相同。

复制

azure service show <serviceName> -vv

首先，使用以下命令验证用户是否可以迁移云服务：

shell复制

azure service deployment validate-migration <serviceName> <deploymentName> new "" "" ""

准备迁移云服务中的虚拟机。可以从两个选项中进行选择。

如果你想要将 VM 迁移到平台所创建的虚拟网络上，请使用以下命令。

复制

azure service deployment prepare-migration <serviceName> <deploymentName> new "" "" ""

如果你想要迁移到 Resource Manager 部署模型中的现有虚拟网络，请使用以下命令。

复制

azure service deployment prepare-migration <serviceName> <deploymentName> existing <destinationVNETResourceGroupName> <subnetName> <vnetName>

准备操作成功后，可以查看详细输出，以获取 VM 的迁移状态，并确保其处于 Prepared 状态。

复制

azure vm show <vmName> -vv

使用 CLI 或 Azure 门户查看准备好的资源的配置。如果你尚未做好迁移准备，因此想要回到旧的状态，请使用以下命令。

复制

azure service deployment abort-migration <serviceName> <deploymentName>

如果准备好的配置看起来没问题，则可继续进行，使用以下命令提交资源。

复制

azure service deployment commit-migration <serviceName> <deploymentName>

步骤 4：选项 2 - 迁移虚拟网络中的虚拟机

选取要迁移的虚拟网络。请注意，如果虚拟网络包含的 Web/辅助角色或 VM 的配置不受支持，你将收到验证错误消息。

使用以下命令获取订阅中的所有虚拟网络。

复制

azure network vnet list

输出将如下所示：

在上面的示例中，virtualNetworkName 是完整名称 "Group classicubuntu16 classicubuntu16"。

首先，请使用以下命令验证用户是否可以迁移虚拟网络：

shell复制

azure network vnet validate-migration <virtualNetworkName>

使用以下命令来准备要迁移的所选虚拟网络。

复制

azure network vnet prepare-migration <virtualNetworkName>

使用 CLI 或 Azure 门户查看准备好的虚拟机的配置。如果你尚未做好迁移准备，因此想要回到旧的状态，请使用以下命令。

复制

azure network vnet abort-migration <virtualNetworkName>

如果准备好的配置看起来没问题，则可继续进行，使用以下命令提交资源。

复制

azure network vnet commit-migration <virtualNetworkName>

步骤 5：迁移存储帐户

完成虚拟机迁移之后，建议你迁移存储帐户。

使用以下命令来准备要迁移的存储帐户

复制

azure storage account prepare-migration <storageAccountName>

使用 CLI 或 Azure 门户查看准备就绪的存储帐户的配置。如果你尚未做好迁移准备，因此想要回到旧的状态，请使用以下命令。

复制

azure storage account abort-migration <storageAccountName>

如果准备好的配置看起来没问题，则可继续进行，使用以下命令提交资源。

复制

azure storage account commit-migration <storageAccountName>

后续步骤

平台支持的从经典部署模型到 Azure Resource Manager 部署模型的 IaaS 资源迁移概述
有关平台支持的从经典部署模型到 Azure Resource Manager 部署模型的迁移的技术深入探讨
规划从经典部署模型到 Azure Resource Manager 的 IaaS 资源迁移
使用 PowerShell 将 IaaS 资源从经典部署模型迁移到 Azure Resource Manager
用于帮助将 IaaS 资源从经典部署模型迁移到 Azure Resource Manager 部署模型的社区工具
查看最常见的迁移错误
查看有关将 IaaS 资源从经典部署模型迁移到 Azure Resource Manager 部署模型的最常见问题立即访问http://market.azure.cn