Устранение неполадок с развертыванием виртуальных машин Linux в Azure

Область применения: ✔️ виртуальные машины Linux

Наиболее распространенные ошибки, возникающие при попытке создания новой виртуальной машины Azure, — ошибки подготовки и ошибки выделения.

• Ошибки подготовки возникают, когда образ операционной системы не удается загрузить из-за неправильных подготовительных действий или из-за выбора неправильных параметров во время записи образа на портале.
• Ошибки выделения возникают, когда кластер или регион не имеют доступных ресурсов или не поддерживают запрошенный размер виртуальной машины.

Сводка

Эта статья помогает диагностировать и устранять проблемы, возникающие при развертывании виртуальных машин Linux в Azure. Он фокусируется на определении того, где развертывание завершилось сбоем (развертывание, подготовка или загрузка ОС) и показывает , какие журналы и средства будут использоваться на каждом этапе.

Определение этапа сбоя развертывания виртуальной машины Linux

Перед устранением неполадок определите, где произошел сбой развертывания:

• Сбой развертывания: на портале Azure отображается сбой развертывания.
• Развертывание выполнено успешно, но виртуальная машина не запустится: виртуальная машина отображает остановленную или неудачную работу.
• Виртуальная машина запущена, но недоступна: сбой Secure Shell (SSH), зависание загрузки или сбой расширений.

Симптомы

Сбой настройки

При развертывании виртуальной машины из пользовательского образа Linux возникает типичный сбой подготовки ресурсов. В этом сценарии:

• Виртуальная машина остается в состоянии создания до 40 минут.
• Развертывание в конечном итоге завершается ошибкой.
• Azure сообщает об ошибке подготовки ОС.

В следующем примере показано следующее сообщение об ошибке:

Deployment failed. Correlation ID: aaaa0000-bb11-2222-33cc-444444dddddd. {
  "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."
      }
    ]
  }
}

При возникновении этой проблемы состояние виртуальной машины отображается как failed.

Дополнительные условия

Некоторые образы Marketplace (отличные от тех, которые требуются в Azure) требуют, чтобы пользователь принял условия для их развертывания.

Ниже приведено типичное сообщение об ошибке во время развертывания при использовании Azure CLI для развертывания таких образов Marketplace:

Message: Offer with PublisherId: 'xxxx', OfferId: 'XXXXlinux-aarch64' cannot be purchased due to validation errors. 
For more information see details. Correlation Id: 'aaaa0000-bb11-2222-33cc-444444dddddd' You have not accepted the legal terms on this subscription: 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx' 
for this plan. Before the subscription can be used, you need to accept the legal terms of the image. To read and accept legal terms, use the Azure CLI commands described at 
https://go.microsoft.com/fwlink/?linkid=2110637 or the PowerShell commands available at https://go.microsoft.com/fwlink/?linkid=862451. Alternatively, deploying via the Azure portal
provides a UI experience for reading and accepting the legal terms. Offer details: publisher='llll' offer = 'xxxxxxx', sku = 'xxxxx-xxx, 
Correlation Id: 'aaaa0000-bb11-2222-33cc-444444dddddd'...

Резолюция

Для решения используйте один из следующих вариантов:

• Используйте Azure CLI.
• Используйте Azure PowerShell.
• Разверните компьютер на портале Azure и примите условия во время процесса развертывания.

Почему происходит сбой развертывания виртуальных машин Linux

Сбои в предоставлении ресурсов обычно возникают по нескольким причинам, в том числе:

• Отсутствует настройка или неправильно настроенный агент

Убедитесь, что агент существует и работает правильно с помощью cloud-init. Если образ не поддерживает эту конфигурацию, просмотрите эти действия.

• Неправильная конфигурация образа

Рекомендации по настройке образов с помощью cloud-init см. в разделе "Требования к образам Azure".

• Не удалось принять условия для конкретного изображения

Примите условия с помощью PowerShell, Azure CLI или портала Azure.

Устранение сбоев подготовки

Чтобы определить причину сбоя управления, сначала изучите последовательный журнал. Вы можете получить доступ к этому журналу, развернув виртуальную машину с включенной диагностикой загрузки Azure.

Необходимо развернуть новую виртуальную машину с включенной диагностикой загрузки, чтобы виртуальная машина, использующая неисправный образ, могла получить доступ к событиям подготовки в последовательном журнале.

# 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 или Azure CLI.

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

Понимание журнала серийных событий для системных событий и событий настройки

При создании виртуальной машины cloud-init запускается и пытается выполнить следующие действия:

• Подключите ISO-файл.
• Установите сетевое подключение.
• Задайте свойства, которые передаются во время создания виртуальной машины.
• Подключите временный диск (на поддерживаемых размерах виртуальных машин).
• Уведомите платформу Azure о завершении начальной конфигурации ОС.

Как интерпретировать журнал последовательной консоли

Последовательная консоль записывает активность на раннем этапе загрузки, в том числе:

• Инициализация ядра
• Конфигурация сети
• Выполнение cloud-init
• запуск агента виртуальной машины Linux Azure

Вам не нужно понимать каждую запись. Вместо:

1. Определите последнюю успешную подсистему (сеть, cloud-init, SSH).
2. Сразу после этого проверьте наличие ошибок, таких как error, fail или exception.
3. Сопоставьте точку сбоя с разделом распространённых ошибок ниже.

Распространенные ошибки

Отключенный модуль универсального формата дисков (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. Для обеспечения виртуальные машины с cloud-init 21.1 или более ранних версий нуждаются в этом драйвере. Дополнительные сведения см. в разделе "Требования к изображениям".

Виртуальные машины с cloud-init 21.2 или более поздней версии успешно развертываются. Однако пользовательские данные недоступны для этих виртуальных машин, предотвращая развертывание паролей и других конфиденциальных данных.

При первой подготовке виртуальной машины в Azure узел Azure предоставляет виртуальной машине provisioning cdrom iso disk. Этот диск подготовки предоставляется виртуальной машине через /dev/sr0. На диске подготовки есть манифест подготовки, содержащий сведения о подготовке виртуальной машины. Ожидается, что агент подготовки в виртуальной машине подключает диск подготовки, считывает манифест подготовки и подготавливает виртуальную машину соответствующим образом.

Так как диск развертывания является диском cdrom iso disk, ядро Linux требует, чтобы драйвер UDF подключал этот диск. Документация Майкрософт по образам Linux ссылается на это требование. Для этой виртуальной машины журналы показывают, что диск для подготовки не был смонтирован, и подготовка виртуальной машины не удалась. Наиболее вероятной причиной является отсутствие или блокировка драйверов UDF.

Решение

Настройте драйвер UDF для загрузки ядром.

Распространенный способ блокировки драйверов UDF осуществляется через конфигурации в пределах /etc/modprobe.d/. Обратитесь к владельцу образа, чтобы убедиться, что драйверы UDF Linux присутствуют и не блокируются. Дополнительные сведения см. в этой статье о блокировке и разблокировки драйверов ядра.

Проблема с символами Юникода в тегах виртуальной машины

Ошибка в 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'

Причина

Эта проблема возникает из-за того, что теги виртуальных машин имеют символы, отличные от ASCII, и версия cloud-init выше 20.3.

Решение

Используйте или убедитесь, что образ поддерживает cloud-init 20.3 или более поздней версии или удалите символы, отличные от ASCII, из тегов виртуальной машины.

Пароль с символами Юникода

Ошибка в 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) используют протокол конфигурации динамического узла (DHCP) путем копирования и запуска dhclient в пределах /var/tmp. Если виртуальная машина монтирует /var/tmp как noexec (без выполнения), в DHCP происходит сбой, потому что у dhclient нет разрешений на выполнение в /var/tmp.

Cloud-init версии 20.3 и более поздние версии содержат исправление, которое возвращается к выполнению dhclient, не копируя и не выполняя в /var/tmp, если возникают проблемы с разрешениями.

Решение

Для виртуальных машин, выполняющих cloud-init до версии 20.3, настройте систему так, чтобы /var/tmp не подключался как noexec. Кроме того, обновите пакет cloud-init виртуальной машины до версии 20.3 или более поздней версии.

Получите дополнительные журналы для устранения сбоев подготовки виртуальных машин Linux

Если вам потребуется больше журналов из виртуальной машины для понимания проблем, используйте заранее настроенного пользователя для входа в последовательную консоль. Если у вас нет заранее настроенного пользователя, вы можете либо заново создать образ, чтобы добавить его, либо использовать средство восстановления AZ VM Repair для подключения диска ОС виртуальной машины, которая не была подготовлена, к другой виртуальной машине.

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

Общие сведения о cloud-init.log

Если у вас есть доступ к журналам cloud-init, ознакомьтесь с документацией по устранению неполадок с cloud-init.

Сбор журналов действий

Чтобы начать устранение неполадок, соберите журналы действий, чтобы определить ошибку, связанную с проблемой. Следующие ссылки содержат подробные сведения о следующем процессе.

Просмотр операций развертывания

Просмотр журналов действий для управления ресурсами Azure

Получите поддержку

Если вы ссылаетесь на рекомендации, но по-прежнему не можете устранить проблему, обратитесь в службу поддержки Майкрософт. Выберите соответствующий продукт и раздел поддержки, чтобы привлечь правильную службу поддержки.

Выбор продукта:

Product Family: Azure
Product: Virtual Machine Running Linux
Support Topic: <COMPLETE>
Support Subtopic: <COMPLETE>