从经典部署模型迁移到 Azure Resource Manager 部署模型的过程中出现的常见错误

本文编录了将 IaaS 资源从 Azure 经典部署模型迁移到 Azure Resource Manager 堆栈期间的最常见错误和缓解措施。

错误列表

错误字符串	缓解措施
内部服务器错误	在某些情况下，这是重试时消失的暂时性错误。 如果该错误仍然存在，请联系 Azure 支持人员，因为它需要调查平台日志。  注意：支持团队跟踪事件后，请不要尝试任何自我缓解措施，因为这可能会对你的环境造成意想不到的后果。
HostedService {hosted-service-name} 中的部署 {deployment-name} 不支持迁移，因为它是 PaaS 部署（Web/辅助角色）。	当部署包含 Web/辅助角色时，会发生这种情况。 由于仅虚拟机支持迁移，请从部署中删除 Web/辅助角色，然后重试迁移。
模板 {template-name} 部署失败。 CorrelationId={guid}	在迁移服务的后端，我们将使用 Azure Resource Manager 模板在 Azure Resource Manager 堆栈中创建资源。 由于模板是幂等的，通常你可以安全地重试迁移操作，以忽略此错误。 如果此错误仍然存在，请联系 Azure 支持人员，并向他们提供 CorrelationId。  注意： 由支持团队跟踪事件后，请不要尝试任何自我缓解措施，因为这可能会对你的环境产生意想不到的后果。
虚拟网络 {virtual-network-name} 不存在。	如果在新的 Azure 门户中创建虚拟网络，可能会发生这种情况。 实际的虚拟网络名称遵循模式“Group * ”
托管服务 {hosted-service-name} 中的 VM {vm-name} 包含 Azure Resource Manager 不支持的扩展 {extension-name}。 建议先从 VM 中卸载该扩展，然后再继续进行迁移。	Azure Resource Manager 不支持 XML 扩展（例如 BGInfo 1.*）。 因此，无法迁移这些扩展。 如果将这些扩展保留安装在虚拟机上，则在完成迁移之前会自动将其卸载。
托管服务 {hosted-service-name} 中的 VM {vm-name} 包含迁移当前不支持的扩展 VMSnapshot/VMSnapshotLinux。 请从 VM 中卸载该扩展，在迁移完成后再使用 Azure Resource Manager 重新添加它	这是为 Azure 备份配置虚拟机的方案。
托管服务 {hosted-service-name} 中的 VM {vm-name} 包含未从 VM 报告其状态的扩展 {extension-name}。 因此，此 VM 无法迁移。 确保 VM 报告该扩展状态或从 VM 中卸载该扩展，然后重试迁移。  托管服务 {hosted-service-name} 中的 VM {vm-name} 包含报告处理程序状态：{handler-status} 的扩展 {extension-name}。 因此，此 VM 无法迁移。 确保所报告的扩展处理程序状态为 {handler-status} 或从 VM 中卸载该扩展，然后重试迁移。  托管服务 {hosted-service-name} 中 VM {vm-name} 的 VM 代理报告的总体代理状态为“未就绪”。 因此，该 VM 可能不会迁移（如果它包含可迁移的扩展）。 请确保 VM 代理将总体代理状态报告为“就绪”。 请参阅 https://www.azure.cn/documentation/articles/virtual-machines-windows-migration-classic-resource-manager/#frequently-asked-questions 。	Azure 来宾代理和 VM 扩展需要对 VM 存储帐户进行出站 Internet 访问以填充其状态。 状态失败的常见原因包括 阻止出站访问 Internet 的网络安全组如果 VNET 有本地 DNS 服务器并且 DNS 连接已丢失  如果仍然看到不支持的状态，则可以卸载该扩展以跳过此检查并继续进行迁移。
托管服务 {hosted-service-name} 中的部署 {deployment-name} 不支持迁移，因为它具有多个可用性集。	目前，仅具有 1 个或更少可用性集的托管服务可以迁移。 若要解决此问题，请将其他可用性集和这些可用性集中的虚拟机移到其他托管服务。
托管服务 {hosted-service-name} 中的部署 {deployment-name} 不支持迁移，因为它包含的 VM 不属于可用性集，尽管该托管服务包含一个可用性集。	这种情况的解决方法是将所有虚拟机都移到单个可用性集中，或者从托管服务的可用性集中删除所有虚拟机。
存储帐户/托管服务/虚拟网络 {virtual-network-name} 正处于迁移过程中，因此无法更改	当资源已完成“准备”迁移操作并触发了对资源进行更改的操作时，会发生此错误。 由于“准备”操作完成后对管理平面进行了锁定，将阻止对资源进行任何更改。 若要解锁管理平面，可以运行“提交”迁移操作以完成迁移，或者运行“中止”迁移操作以回退“准备”操作。
托管服务 {hosted-service-name} 不允许迁移，因为它包含的 VM {vm-name} 处于状态: RoleStateUnknown。 仅当 VM 处于以下状态（“正在运行”、“已停止”、“已停止已解除分配”）之一时，才允许迁移。	该 VM 可能正在进行状态转换，通常在对托管服务进行更新操作（如重新启动，扩展安装等）期间会发生这种情况。建议先对托管服务完成更新操作，然后再尝试迁移。
HostedService {hosted-service-name} 中的部署 {deployment-name} 包含 VM {vm-name}，该 VM 的数据磁盘 {data-disk-name} 的物理 Blob 大小 {size-of-the-vhd-blob-backing-the-data-disk} 字节与 VM 数据磁盘逻辑大小 {size-of-the-data-disk-specified-in-the-vm-api} 字节不匹配。 迁移将继续，而无需指定 Azure Resource Manager VM 的数据磁盘的大小。 如果你想要在继续迁移之前更正数据磁盘大小，请访问 https://www.azure.cn/documentation/articles/virtual-machines-migration-errors/#vm-with-data-disk-whose-physical-blob-size-bytes-does-not-match-the-vm-data-disk-logical-size-bytes 。	如果已调整 VHD Blob 的大小，而没有更新 VM API 模型中的大小，将发生此错误。 详细的缓解措施步骤如下所述。
在云服务 {云服务名称} 中使用媒体链接 {数据磁盘 URI} 为 VM {VM 名称} 验证数据磁盘 {数据磁盘名称} 时发生存储异常。 请确保该虚拟机可以访问 VHD 媒体链接	如果 VM 的磁盘已被删除或不再可访问，则可能发生此错误。 请确保 VM 磁盘存在。
HostedService {cloud-service-name} 中的 VM {vm-name} 包含具有 blob 名称为 {vhd-blob-name} 的 MediaLink {vhd-uri} 的磁盘，这在 Azure Resource Manager 中不受支持。	当 Blob 的名称包含“/”（这当前在计算资源提供程序中不支持）时，将出现此错误。
HostedService {cloud-service-name} 中的部署 {deployment-name} 不允许迁移，因为不在区域范围内。 请参阅 http://aka.ms/regionalscope ，了解如何将该部署移至区域范围。	在 2014 年，Azure 宣布：网络资源将从群集级别范围移至区域范围。 请参阅 [http://aka.ms/regionalscope] ，了解更多详细信息 (http://aka.ms/regionalscope). 当要迁移的部署尚未进行更新操作（自动将其移至区域范围）时，将会发生此错误。 最好的解决办法是向 VM 添加终结点，或者向 VM 添加数据磁盘，然后重试迁移。  请参阅如何在 Azure 中的经典 Windows 虚拟机上设置终结点或将数据磁盘附加到使用经典部署模型创建的 Windows 虚拟机

详细的缓解措施

VM 中数据磁盘的物理 Blob 字节大小与 VM 数据磁盘的逻辑字节大小不匹配。

当数据磁盘逻辑大小与实际 VHD Blob 大小不同步时，将发生这种情况。 可以轻松使用以下命令验证这种问题：

验证问题

PowerShell
复制

# Store the VM details in the VM object
$vm = Get-AzureVM -ServiceName $servicename -Name $vmname

# Display the data disk properties
# NOTE the data disk LogicalDiskSizeInGB below which is 11GB. Also note the MediaLink Uri of the VHD blob as we'll use this in the next step
$vm.VM.DataVirtualHardDisks

HostCaching         : None
DiskLabel           :
DiskName            : coreosvm-coreosvm-0-201611230636240687
Lun                 : 0
LogicalDiskSizeInGB : 11
MediaLink           : https://contosostorage.blob.core.chinacloudapi.cn/vhds/coreosvm-dd1.vhd SourceMediaLink     :
IOType              : Standard
ExtensionData       :

# Now get the properties of the blob backing the data disk above
# NOTE the size of the blob is about 15 GB which is different from LogicalDiskSizeInGB above
$blob = Get-AzureStorageblob -Blob "coreosvm-dd1.vhd" -Container vhds

$blob

ICloudBlob        : Microsoft.WindowsAzure.Storage.Blob.CloudPageBlob
BlobType          : PageBlob
Length            : 16106127872
ContentType       : application/octet-stream
LastModified      : 11/23/2016 7:16:22 AM +00:00
SnapshotTime      :
ContinuationToken :
Context           : Microsoft.WindowsAzure.Commands.Common.Storage.AzureStorageContext
Name              : coreosvm-dd1.vhd

缓解问题

PowerShell
复制

# Convert the blob size in bytes to GB into a variable which we'll use later
$newSize = [int]($blob.Length / 1GB)

# See the calculated size in GB
$newSize

15

# Store the disk name of the data disk as we'll use this to identify the disk to be updated
$diskName = $vm.VM.DataVirtualHardDisks[0].DiskName

# Identify the LUN of the data disk to remove
$lunToRemove = $vm.VM.DataVirtualHardDisks[0].Lun

# Now remove the data disk from the VM so that the disk isn't leased by the VM and it's size can be updated
Remove-AzureDataDisk -LUN $lunToRemove -VM $vm | Update-AzureVm -Name $vmname -ServiceName $servicename

OperationDescription OperationId                          OperationStatus
-------------------- -----------                          ---------------
Update-AzureVM       213xx1-b44b-1v6n-23gg-591f2a13cd16   Succeeded

# Verify we have the right disk that's going to be updated
Get-AzureDisk -DiskName $diskName

AffinityGroup        :
AttachedTo           :
IsCorrupted          : False
Label                :
Location             : China East
DiskSizeInGB         : 11
MediaLink            : https://contosostorage.blob.core.chinacloudapi.cn/vhds/coreosvm-dd1.vhd DiskName             : coreosvm-coreosvm-0-201611230636240687
SourceImageName      :
OS                   :
IOType               : Standard
OperationDescription : Get-AzureDisk
OperationId          : 0c56a2b7-a325-123b-7043-74c27d5a61fd
OperationStatus      : Succeeded

# Now update the disk to the new size
Update-AzureDisk -DiskName $diskName -ResizedSizeInGB $newSize -Label $diskName

OperationDescription OperationId                          OperationStatus
-------------------- -----------                          ---------------
Update-AzureDisk     cv134b65-1b6n-8908-abuo-ce9e395ac3e7 Succeeded

# Now verify that the "DiskSizeInGB" property of the disk matches the size of the blob
Get-AzureDisk -DiskName $diskName

AffinityGroup        :
AttachedTo           :
IsCorrupted          : False
Label                : coreosvm-coreosvm-0-201611230636240687
Location             : China East
DiskSizeInGB         : 15
MediaLink            : https://contosostorage.blob.core.chinacloudapi.cn/vhds/coreosvm-dd1.vhd DiskName             : coreosvm-coreosvm-0-201611230636240687
SourceImageName      :
OS                   :
IOType               : Standard
OperationDescription : Get-AzureDisk
OperationId          : 1v53bde5-cv56-5621-9078-16b9c8a0bad2
OperationStatus      : Succeeded

# Now we'll add the disk back to the VM as a data disk. First we need to get an updated VM object
$vm = Get-AzureVM -ServiceName $servicename -Name $vmname

Add-AzureDataDisk -Import -DiskName $diskName -LUN 0 -VM $vm -HostCaching ReadWrite | Update-AzureVm -Name $vmname -ServiceName $servicename

OperationDescription OperationId                          OperationStatus
-------------------- -----------                          ---------------
Update-AzureVM       b0ad3d4c-4v68-45vb-xxc1-134fd010d0f8 Succeeded

完成迁移后，将 VM 移动到其他订阅中

完成迁移过程后，建议将 VM 移动到另一个订阅中。 但是，如果在引用 Key Vault 资源的 VM 上有密钥/证书，则当前不支持移动。 可按照以下说明解决此问题。

PowerShell

PowerShell
复制

$vm = Get-AzureRmVM -ResourceGroupName "MyRG" -Name "MyVM"
Remove-AzureRmVMSecret -VM $vm
Update-AzureRmVM -ResourceGroupName "MyRG" -VM $vm

Azure CLI 2.0

bash
复制

az vm update -g "myrg" -n "myvm" --set osProfile.Secrets=[]

后续步骤

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