Устранение проблем с расширениями виртуальных машин серверов с поддержкой Azure Arc

В этой статье содержатся сведения об устранении неполадок и устранении проблем, которые могут возникнуть при попытке развернуть или удалить расширения Azure виртуальных машин на серверах с поддержкой Azure Arc. Для получения общей информации см. раздел Управление расширениями виртуальных машин с поддержкой Azure Arc.

Общие действия по устранению неполадок

Данные о состоянии развертываний расширений можно получить на портале Azure, выбрав соответствующий компьютер, а затем Settings > Расширения.

Для общего устранения неполадок выполните следующие действия. Эти действия применяются ко всем расширениям виртуальной машины.

  1. Убедитесь, что агент Azure Connected Machine (azcmagent) подключен и зависимые службы запущены/активны.

    Выполните команду azcmagent show и проверьте выходные данные состояния (Azure Arc Proxy можно игнорировать):

    Снимок экрана: таблица с состоянием зависимых служб как запущенных или остановленных.

    Если какие-либо службы, кроме Azure Arc Proxy, остановлены, перезапустите их, чтобы возобновить операции расширения.

  2. Повторная установка расширения.

    Расширения могут застрять в неудавшихся или других состояниях по различным причинам. Если состояние расширения не указано как успешное, удалите расширение и установите его еще раз. Для удаления расширения можно использовать следующую команду Azure PowerShell:

    Remove-AzConnectedMachineExtension -Name <Extension Name> -ResourceGroupName <RG Name> -MachineName <Machine Name>

  3. Проверьте журнал гостевого агента и просмотрите действия после подготовки расширения. Для Windows проверьте в %SystemDrive%\ProgramData\GuestConfig\ext_mgr_logs, а для Linux проверьте в /var/lib/GuestConfig/ext_mgr_logs.

  4. Проверьте журналы логов для конкретного расширения для получения более подробной информации.

    Для Windows компьютеров:

    • Журналы хранятся в C:\ProgramData\GuestConfig
    • Параметры расширения и файлы состояния находятся в C:\Packages\Plugins

    Для компьютеров Linux:

    • Журналы хранятся в /var/lib/GuestConfig
    • Параметры расширения и файлы состояния находятся в /var/lib/waagent

    Журналы службы расширений записываются в …GuestConfig\ext_mgr_logs\gc_ext.log. Отображаются ошибки при скачивании или проверке пакетов.

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

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

Флаг noexec установлен для пути расширения.

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

Extension failed to install. Extension returned non-zero exit code for Install: 64. Extension error 
output: Extension path '<full_path>' has the 'noexec' flag set. Extension exit code: 64

Эта ошибка возникает, когда агент Azure Arc пытается установить или запустить расширение из пути к файловой системе, подключенному с флагом noexec, в этом случае это путь расширения, указанный в сообщении об ошибке. Параметр noexec подключения запрещает выполнение двоичных файлов или скриптов из этой файловой системы. Расширения должны выполнять скрипты установки в рамках установки; Поэтому установка завершается ошибкой, если рабочий каталог расширения находится на подключении noexec .

Это чаще всего видно в защищенных средах Linux, где пути, такие как /var, /var/lib, /opt или пользовательские точки подключения, явно подключены по noexec соображениям безопасности. Чтобы разблокировать установку расширений, необходимо убедиться, что файловая система, используемая Azure Arc для установки расширений, разрешает выполнение программ.

Повторное подключение файловой системы с помощью exec Чтобы разблокировать установку расширений, обновите конфигурацию монтирования так, чтобы файловая система, на которой размещен путь расширения, разрешала выполнение программ. Если это разрешено политикой безопасности, повторно подключите затронутую файловую систему без флага noexec , используя приведенную ниже команду.

sudo mount -o remount,exec <mount-point>

Если устройство монтирования определено /etc/fstab, обновите запись для удаления noexec и повторно подключите файловую систему, чтобы изменения сохранялись при перезагрузке; в противном случае может потребоваться повторное подключение всякий раз, когда нужно обновить расширение. Это изменение применяется только к файловым системам, где выполнение двоичных файлов приемлемо в соответствии с требованиями к безопасности вашей организации.

После обновления конфигурации подключения повторите установку расширения.

Известные проблемы

Файл HandlerManifest.json не существует для расширения

Расширение зависает в Deleting состоянии. В журнале службы расширений (gc_ext.log) появится следующая ошибка:

HandlerManifest.json file does not exist for extension

Анализ

В расширении отсутствует файл HandlerManifest.json. Это может произойти, если расширение не было удалено должным образом.

Solution

  1. Чтобы удалить расширение, используйте az connectedmachine extension delete с параметрами --extension-name, --machine-name, и --resource-group.

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

    Для Windows компьютеров:

    • Перейдите на C:\Packages\Plugins\
    • Удаление папки, соответствующей расширению

    Для компьютеров Linux:

    • Перейдите на /var/lib/waagent/
    • Удаление папки, соответствующей расширению

  3. Удалите расширение из Azure и переустановите его.

Дальнейшие шаги

Если вы не нашли здесь свою проблему или не можете её решить, обратитесь за поддержкой через один из следующих каналов:

  • Получите ответы от экспертов Azure через Microsoft Q& A.
  • Откройте запрос на поддержку, чтобы получить помощь. Дополнительные сведения см. в разделе Создание запроса поддержка Azure.
  • Last updated on