通过使用 Azure CLI 将 OS 磁盘附加到恢复 VM 来对 Linux VM 进行故障排除

项目
07/30/2024

适用于：✔️ Linux VM

如果 Linux 虚拟机 (VM) 遇到启动或磁盘错误，则可能需要对虚拟硬盘本身执行故障排除步骤。一个常见示例是 /etc/fstab 中存在无效条目，使 VM 无法成功启动。本文详细介绍如何使用 Azure CLI 将虚拟硬盘连接到另一个 Linux VM，以修复任何错误，然后重新创建原始 VM。

恢复过程概述

故障排除过程如下：

停止受影响的 VM。
从 VM 的 OS 磁盘拍摄快照。
从 OS 磁盘快照创建磁盘。
出于故障排除目的，将新的 OS 磁盘附加到另一个 Linux VM 并装载。
连接到故障排除 VM。编辑文件或运行任何工具来修复新 OS 磁盘上的问题。
从故障排除 VM 卸载并分离新的 OS 磁盘。
更改受影响 VM 的 OS 磁盘。

若要执行这些故障排除步骤，需要安装最新的 Azure CLI，并使用 az login 登录到 Azure 帐户。

可以使用 VM 修复命令自动执行步骤 1、2、3、4、6 和 7。有关更多文档和说明，请参阅使用 Azure 虚拟机修复命令修复 Linux VM。

重要

本文中的脚本仅适用于使用托管磁盘的 VM。

在以下示例中，将参数名称替换为自己的值，例如 myResourceGroup 和 myVM。

确定启动问题

检查串行输出以确定 VM 不能正常启动的原因。一个常见示例是 /etc/fstab 中存在无效条目，或底层虚拟硬盘已删除或移动。

使用 az vm boot-diagnostics get-boot-log 获取启动日志。以下示例从名为 myResourceGroup 的资源组中名为 myVM 的 VM 获取串行输出：

az vm boot-diagnostics get-boot-log --resource-group myResourceGroup --name myVM

检查串行输出，以确定 VM 无法启动的原因。如果串行输出未提供任何指示，则在将虚拟硬盘连接到故障排除 VM 后，可能需要查看 /var/log 中的日志文件。

停止 VM

以下示例在名为 myResourceGroup 的资源组中停止名为 myVM 的 VM：

az vm stop --resource-group MyResourceGroup --name MyVm

从受影响 VM 的 OS 磁盘拍摄快照

快照是 VHD 的完整只读副本。不能将其附加到 VM。下一步骤将从此快照创建磁盘。以下示例从 VM“myVM”的 OS 磁盘创建名为 mySnapshot 的快照。

#Get the OS disk Id 
$osdiskid=(az vm show -g myResourceGroup -n myVM --query "storageProfile.osDisk.managedDisk.id" -o tsv)

#creates a snapshot of the disk
az snapshot create --resource-group myResourceGroupDisk --source "$osdiskid" --name mySnapshot

从快照创建磁盘

此脚本从名为 mySnapshot 的快照创建名为 myOSDisk 的托管磁盘。

#Provide the name of your resource group
$resourceGroup="myResourceGroup"

#Provide the name of the snapshot that will be used to create Managed Disks
$snapshot="mySnapshot"

#Provide the name of the Managed Disk
$osDisk="myNewOSDisk"

#Provide the size of the disks in GB. It should be greater than the VHD file size.
$diskSize=128

#Provide the storage type for Managed Disk. Premium_LRS or Standard_LRS.
$storageType="Premium_LRS"

#Provide the OS type
$osType="linux"

#Get the snapshot Id 
$snapshotId=(az snapshot show --name $snapshot --resource-group $resourceGroup --query id -o tsv)

# Create a new Managed Disks using the snapshot Id.

az disk create --resource-group $resourceGroup --name $osDisk --sku $storageType --size-gb $diskSize --source $snapshotId

如果资源组和源快照不在同一区域中，则运行 az disk create时将收到“找不到资源”错误。在这种情况下，必须指定 --location <region> 将磁盘创建到源快照所在的同一区域中。

现在，可以创建原始 OS 磁盘的副本。可以将此新磁盘装载到另一个 Windows VM 进行故障排除。

将新的虚拟硬盘附加到另一个 VM

在后续几个步骤中，将使用另一个 VM 进行故障排除。将磁盘附加到此故障排除 VM，以浏览和编辑磁盘的内容。此过程允许更正任何配置错误，或查看其他应用程序或系统日志文件。

此脚本将磁盘 myNewOSDisk 附加到 VM MyTroubleshootVM：

# Get ID of the OS disk that you just created.
$myNewOSDiskid=(az disk show -g $resourceGroup -n $osDisk --query id -o tsv)

# Attach the disk to the troubleshooting VM
az vm disk attach --disk $myNewOSDiskid --resource-group $resourceGroup --size-gb $diskSize --sku $storageType --vm-name MyTroubleshootVM

装载附加的数据磁盘

注意

以下示例详细说明了在 Ubuntu VM 上需要执行的步骤。如果使用不同的 Linux 分发版（如 Red Hat Enterprise Linux 或 SUSE）日志文件位置和 mount 命令可能稍有不同。请参阅具体分发版的文档，了解命令中有哪些相应的变化。

使用适当的凭据通过 SSH 登录到故障排除 VM。如果此磁盘是附加到故障排除 VM 的第一个数据磁盘，则此磁盘可能已连接到 /dev/sdc。使用 dmesg 查看附加的磁盘：
```
dmesg | grep SCSI
```
输出类似于以下示例：
```
[    0.294784] SCSI subsystem initialized
[    0.573458] Block layer SCSI generic (bsg) driver version 0.4 loaded (major 252)
[    7.110271] sd 2:0:0:0: [sda] Attached SCSI disk
[    8.079653] sd 3:0:1:0: [sdb] Attached SCSI disk
[ 1828.162306] sd 5:0:0:0: [sdc] Attached SCSI disk
```
在前面的示例中，OS 磁盘位于 /dev/sda，为每个 VM 提供的临时磁盘位于 /dev/sdb。如果有多个数据磁盘，它们应位于 /dev/sdd、/dev/sde，依次类推。
创建一个目录来装载现有的虚拟硬盘。以下示例创建一个名为 troubleshootingdisk 的目录：
```
sudo mkdir /mnt/troubleshootingdisk
```
如果现有的虚拟硬盘上有多个分区，则装载所需的分区。以下示例在 /dev/sdc1 中装载第一个主分区：
```
sudo mount /dev/sdc1 /mnt/troubleshootingdisk
```
注意

最佳做法是使用虚拟硬盘的全局唯一标识符 (UUID) 装载 Azure 中 VM 上的数据磁盘。对于此简短的故障排除方案，不必要使用 UUID 装载虚拟硬盘。但是，在正常使用时，编辑 /etc/fstab 以使用设备名称（而不是 UUID）装载虚拟硬盘可能会导致 VM 无法启动。

修复新 OS 磁盘上的问题

装载现有虚拟硬盘后，可以根据需要执行任何维护和故障排除步骤。解决问题后，请继续执行以下步骤。

卸载并分离新的 OS 磁盘

解决错误后，可从故障排除 VM 中卸载并分离现有虚拟硬盘。在将虚拟硬盘附加到故障排除 VM 的租约释放前，不能将该虚拟硬盘用于任何其他 VM。

通过 SSH 会话登录到故障排除 VM 中，卸载现有的虚拟硬盘。首先更改出装入点的父目录：
```
cd /
```
现在卸载现有的虚拟硬盘。以下示例卸载 /dev/sdc1 中的设备：
```
sudo umount /dev/sdc1
```

现在从 VM 中分离虚拟硬盘。退出对故障排除 VM 的 SSH 会话：

az vm disk detach -g MyResourceGroup --vm-name MyTroubleShootVm --name myNewOSDisk

更改受影响 VM 的 OS 磁盘

可以使用 Azure CLI 交换 OS 磁盘。无需删除和重新创建 VM。

此示例停止名为 myVM 的 VM，并将名为 myNewOSDisk 的磁盘分配为新的 OS 磁盘。

# Stop the affected VM
az vm stop -n myVM -g myResourceGroup

# Get ID of the OS disk that is repaired.
$myNewOSDiskid=(az disk show -g $resourceGroup -n $osDisk --query id -o tsv)

# Change the OS disk of the affected VM to "myNewOSDisk"
az vm update -g myResourceGroup -n myVM --os-disk $myNewOSDiskid

# Start the VM
az vm start -n myVM -g myResourceGroup

后续步骤

如果在连接到 VM 时遇到问题，请参阅排查 Azure VM 的 SSH 连接问题。如果在访问 VM 上运行的应用时遇到问题，请参阅排查 Linux VM 上的应用程序连接问题。

联系我们寻求帮助

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

通过