排查部署 Linux 虚拟机时遇到的问题

适用于：✔️ Linux VM

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

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

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

现象

在创建自定义映像，然后从该映像部署虚拟机（VM）后，会出现典型的预配失败方案。 发生此故障时，VM 状态显示为 creating 最多 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."
      }
    ]
  }
}

出现此问题时，VM 状态显示为 failed。

预配失败的原因

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

• 缺少预配或配置不当的代理

  使用 cloud-init 验证代理是否存在并正常运行。 如果映像不支持此配置，请查看 这些步骤。

• 映像配置不正确

  有关使用 cloud-init 设置映像的指导，请参阅 Azure 映像要求。

排查预配失败问题

若要确定预配失败的原因，请首先检查串行日志。 可以通过部署 VM 以使用 Azure 启动诊断来提供此日志。

必须部署一个新 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

若要查看串行日志，请转到 Azure 门户，或运行以下命令下载 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 驱动程序未加载到内核中。 要对虚拟机进行预配需要先进行加载。 请参阅 映像要求。

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

由于预配磁盘是一个 cdrom iso disk，因此内核需要 Linux UDF 驱动程序才能成功装载此磁盘。 这在 Microsoft 针对 Linux 映像的文档中有引用。 对于此 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 将失败，因为 dhclient 无权在 /var/tmp 运行。

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 的操作系统磁盘挂载到另一个 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 资源

获取支持

如果参考了指南，但仍无法解决问题，请联系Microsoft支持部门。 选择适当的产品和支持主题以吸引正确的支持团队。

选择案例产品：

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

联系我们寻求帮助

如果有疑问，可以询问 Azure 社区支持。 你还可以将产品反馈提交到 Azure 反馈社区。