排查部署 Linux 虚拟机时出现的问题

适用于：✔️ Linux VM

尝试创建新的 Azure 虚拟机 (VM) 时，遇到的常见错误是预配失败或分配失败。

• 当由于准备步骤不当，或者在从门户捕获映像期间选择了错误的设置而导致 OS 映像无法加载时，将发生预配失败。
• 当群集或区域没有可用的资源或无法支持所请求的 VM 大小时，将发生分配失败。

如果本文未解决 Azure 问题，请访问 MSDN 和 Stack Overflow 上的 Azure 论坛。 可将问题发布到这些论坛上，或发布到 Twitter 上的 @AzureSupport。 还可提交 Azure 支持请求。 若要提交支持请求，请在 Azure 支持页上，选择“获取支持”。

现象

在创建自定义映像后，会出现典型的预配失败情况，然后从中部署 VM，然后遇到未显示 creatingVM 状态的 40 分钟，并看到以下错误消息：

Provisioning state Provisioning failed. 
OS Provisioning for VM 'sentilo' did not finish in the allotted time. 
The VM may still finish provisioning successfully. Please check provisioning state later. 
Also, make sure the image has been properly prepared (generalized). * Instructions for Windows: https://azure.microsoft.com/documentation/articles/virtual-machines-windows-upload-image/ * Instructions for Linux: https://azure.microsoft.com/documentation/articles/virtual-machines-linux-capture-image/.

或：

Deployment failed. Correlation ID: f9dcb33a-4e6e-45c5-9c9d-b29dd73da2e0. {
  "status": "Failed",
  "error": {
    "code": "ResourceDeploymentFailure",
    "message": "The resource operation completed with terminal provisioning state 'Failed'.",
    "details": [
      {
        "code": "OSProvisioningInternalError",
        "message": "OS Provisioning failed for VM 'iWishThisWouldCreateVM01' due to an internal error: The VM encountered an error during deployment. Please visit https://aka.ms/linuxprovisioningerror for more information on remediation."
      }
    ]
  }
}

然后，会看到标记为“ failedVM”状态。

为何会发生预配失败？

通常，预配失败的原因有多种，例如：

• 缺少预配/配置错误代理

  需要确保代理存在且正常运行，应使用 cloud-init，或者映像不支持此功能，可以查看这些步骤。

• 映像配置不正确

  我们有有关如何使用 cloud-init 和其他 Azure 映像要求设置映像的指导，请查看这一点。

排查预配失败问题

若要确定预配失败的原因，需要从串行日志开始，可以使用 Azure 启动诊断部署 VM。

需要为 VM 部署启用了启动诊断的新 VM，该 VM 的映像失败，才能访问串行日志中的预配事件。

# create resource group
resourceGroup=myBrokenImageRG
location=westus2
az group create --name $resourceGroup --location $location
# create storage account
storageacct=mydiagdata$RANDOM
az storage account create \
  --resource-group $resourceGroup \
  --name $storageacct \
  --sku Standard_LRS \
  --location $location
# create VM
vmName=iWishThisWouldCreateVM01
brokenImageName=<ResourceID of brokenImage>
sshPubkeyPath=""
az vm create \
    --resource-group $resourceGroup \
    --name $vmName \
    --image $brokenImageName \
    --admin-username azadmin \
    --ssh-key-value $sshPubkeyPath \
    --boot-diagnostics-storage $storageacct

若要查看串行日志，可以转到门户，或运行以下命令以下载 serialConsoleLogBlobUri 日志：

az vm boot-diagnostics get-boot-log-uris --name $vmName --resource-group $resourceGroup

了解系统事件和预配事件的串行日志

首次创建 VM 时，cloud-init 将启动并尝试装载 ISO、建立网络连接、设置在创建 VM 期间传递的属性、装载临时磁盘（在受支持的 VM 大小上），并向 Azure 平台发出信号，指出初始 OS 配置已完成。

常见错误

禁用的 UDF 模块

串行日志中的错误 ：

[   10.855501] cloud-init[732]: Cloud-init v. 20.4.1-0ubuntu1~18.04.1 running 'init-local' at Thu, 28 Jan 2021 23:43:02 +0000. Up 10.68 seconds.
[   10.869581] cloud-init[732]: 2021-01-28 23:43:03,097 - azure.py[WARNING]: /dev/sr0 was not mountable
[   10.875608] cloud-init[732]: 2021-01-28 23:43:03,106 - azure.py[ERROR]: No Azure metadata found
[   10.885776] cloud-init[732]: 2021-01-28 23:43:03,107 - azure.py[ERROR]: Could not crawl Azure metadata: No Azure metadata found
[   14.634117] cloud-init[732]: 2021-01-28 23:43:06,876 - azure.py[WARNING]: Reported failure to Azure fabric.

waagent.log错误：

"UDF driver Blocklisted 2020/09/11 19:16:40.240016 ERROR Daemon Provisioning failed: [ProtocolError] [CopyOvfEnv] Error mounting dvd: [OSUtilError] Failed to mount dvd deviceInner error: [mount -o ro -t udf,iso9660 /dev/sr0 /mnt/cdrom/secure] returned 32: mount: /mnt/cdrom/secure: wrong fs type, bad option, bad superblock on /dev/sr0, missing codepage or helper program, or other error."

原因：UDF 驱动程序未加载到内核中，这是 VM 预配所必需的，请参阅 映像要求。

首次在 Azure 上预配 VM 时，Azure 主机向 VM 提供“预配 cdrom iso 磁盘”。 此预配磁盘通常通过 /dev/sr0 提供给 VM。 在预配磁盘中，有一个预配清单，其中包含 VM 的预配信息。 VM 内预配代理应装载预配磁盘、读取预配清单并相应地预配 VM。

由于预配磁盘是一个 cdrom iso disk，因此内核需要 Linux UDF 驱动程序才能成功装载此磁盘。 Linux 映像上的Microsoft文档中引用了这一点。 对于此 VM，日志指示预配磁盘无法装载，这导致 VM 预配失败。 最有可能的原因是 UDF 驱动程序缺失或被阻止。

解决方案：确保 UDF 驱动程序配置为在内核中加载。

阻止 UDF 驱动程序的一种常见方法是通过内部 /etc/modprobe.d/的配置。 请与客户/映像所有者合作，确保 Linux UDF 驱动程序存在且未阻止。 有关阻止/取消阻止内核驱动程序，请参阅本文。

VM 标记中的 Unicode 字符问题

cloud-init.log错误：

  File "/usr/lib/python2.7/site-packages/cloudinit/sources/DataSourceAzure.py", line 1316, in _get_metadata_from_imds
    except json.decoder.JSONDecodeError:
AttributeError: 'module' object has no attribute 'JSONDecodeError'

原因：发生这种情况是因为 VM 标记具有非 ascii 字符，cloud-init 的版本早于 20.3。

解决方案：使用或确保映像支持 cloud-init 20.3 或更高版本，或者从 VM 标记中删除非 ascii 字符。

包含 unicode 字符的密码

cloud-init.log错误：

File "/usr/lib/python2.7/site-packages/cloudinit/sources/DataSourceAzure.py", line 1153, in encrypt_pass
    return crypt.crypt(password, salt_id + util.rand_str(strlen=16))
  File "/usr/lib64/python2.7/crypt.py", line 55, in crypt
    return _crypt.crypt(word, salt)
UnicodeEncodeError: 'ascii' codec can't encode characters in position 10-11: ordinal not in range(128)

原因：发生这种情况是因为提供的密码具有不受支持的字符（非 ascii）。

解决方案：提供仅包含 ascii 字符的密码。

Dhclient 权限

cloud-init.log错误：

Command: ['/var/tmp/cloud-init/cloud-init-dhcp-yd8mvxud/dhclient', '-1', '-v', '-lf', '/var/tmp/cloud-init/cloud-init-dhcp-yd8mvxud/dhcp.leases', '-pf', '/var/tmp/cloud-init/cloud-init-dhcp-yd8mvxud/dhclient.pid', 'eth0', '-sf', '/bin/true']
Exit code: -
Reason: [Errno 13] Permission denied: b'/var/tmp/cloud-init/cloud-init-dhcp-yd8mvxud/dhclient'

原因：较旧版本的 cloud-init（版本 20.3 之前）通过复制和执行 dhclient 内部 /var/tmp执行 DHCP。 如果 /var/tmp VM 装载为noexec（无执行），则 DHCP 将因无权在内部/var/tmp执行而失败dhclient。

Cloud-init 版本 >= 20.3 包含一个修复程序，它回退并执行 dhclient “原样”（如果不复制并执行它， /var/tmp 如果存在权限问题）。

解决方案：对于运行低于版本 20.3 的 cloud-init 的 VM，请配置 VM， /var/tmp 使其未装载为 noexec。 或者，将 VM 的 cloud-init 包升级到版本 >= 20.3。

获取更多日志

如果发现需要 VM 中的更多日志来了解问题，则可以使用 烘焙到映像的用户通过串行控制台 通过 SSH 连接到 VM。 如果没有用户烘焙，则可以使用用户重新创建映像，或使用 AZ VM 修复工具 将无法预配的 VM 的 OS 磁盘装载到另一个 VM。

az vm repair create  \
    --resource-group $resourceGroup \
    --name $vmName \
    --repair-username repairadm \
    --repair-password AnotherPassword123! \
    --repair-vm-name repairVM \
    --verbose

了解cloud-init.log

当有权访问 cloud-init 日志时，请查看 cloud-init 故障排除文档。

收集活动日志

若要开始故障排除，请收集活动日志，以识别与问题相关的错误。 以下链接包含有关要遵循的过程的详细信息。

查看部署操作

通过查看活动日志管理 Azure 资源

获取支持

如果你已经参考了本指南，面仍无法排查出问题，则可以开启支持案例。 执行此操作时，请选择正确的产品和支持主题，这样做将吸引正确的支持团队。

选择案例产品：

Product Family: Azure
Product: Virtual Machine Running (Window\Linux)
Support Topic: <COMPLETE>
Support Subtopic: <COMPLETE>

联系我们寻求帮助

如果你有任何疑问或需要帮助，请创建支持请求或联系 Azure 社区支持。 你还可以将产品反馈提交到 Azure 反馈社区。