Удаленная отладка ASP.NET Core в службе приложение Azure (Windows)

Статья
04/23/2024

В этой статье описывается, как подключить отладчик Visual Studio к приложению ASP.NET Core, работающему в службе приложение Azure. Следующие шаги позволяют отлаживать приложение, как если бы оно выполнялось локально.

Необходимые компоненты

Visual Studio 2022 с установленными ASP.NET и веб-разработками и рабочей нагрузкой разработки Azure.
Сначала необходимо развернуть приложение ASP.NET Core в службе приложение Azure (Windows) из Visual Studio, а приложение должно быть запущено.

Дополнительные сведения об обучении, включающем развертывание Служба приложений, см. в статье "Удаленная отладка ASP.NET Core" в Azure.

Включение удаленной отладки

Перед отладкой этой проблемы с помощью Visual Studio необходимо включить функцию удаленной отладки в Службе приложений. Этот параметр позволит отладчику Visual Studio подключиться к основному процессу веб-размещения Службы приложений.

Войдите в собственный портал Azure.

Найдите развернутое приложение на портале Azure. Вы можете найти приложение, перейдя на страницу Служба приложений и выбрав экземпляр Служба приложений. Вы также можете выполнить поиск экземпляра Служба приложений по имени в строке поиска вверху. (В этом примере экземпляр Служба приложений называется GitHubBrowser123.)
На странице параметров для экземпляра Служба приложений выберите "Конфигурация" в области навигации слева и перейдите на вкладку "Общие Параметры".
В нижней части страницы установите для функции удаленной отладки значение Вкл и выберите Visual Studio 2022 в качестве версии удаленного Visual Studio.
В верхней части страницы щелкните Сохранить, чтобы сохранить изменения.

Экземпляр службы приложений теперь поддерживает удаленную отладку с помощью Visual Studio.

Настройка параметров отладки

Перед отладкой приложения в Azure убедитесь, что вы выполнили следующие действия в Visual Studio, чтобы обеспечить успешное выполнение.

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

Примечание.

Убедитесь, что состояние локального кода соответствует развернутому в Azure. Это гарантирует, что локальные файлы символов и исходный код соответствуют развернутой версии приложения.
Выберите "Параметры отладки>" в верхнем меню Visual Studio. Убедитесь, что включить только мой код не проверка (как показано ниже), а затем нажмите кнопку "ОК".

Изменение этого параметра позволяет Visual Studio отладить оптимизированный код, развернутый в Azure, используя необходимые файлы символов из локальной папки bin. Файлы символов используются отладчиком в качестве моста между скомпилированным кодом, кодом выполнения и исходным кодом в Visual Studio, поэтому важно, чтобы локальный исходный код соответствовал приложению развертывания.

Подключение отладчика к Службе приложений

В главном меню в верхней части Visual Studio выберите Отладка —> подключение к процессу, чтобы открыть соответствующее диалоговое окно. С помощью этого окна можно подключиться к разным целевым объектам. В этом случае вы будете подключаться к экземпляру Службы приложений, созданному на предыдущем шаге.
Откройте раскрывающийся список Тип подключения и выберите параметр Служба приложений Microsoft Azure.
Выберите Найти... рядом с полем Целевой объект подключения, чтобы открыть диалоговое окно, которое позволяет просматривать подписки Azure и службы приложений.
Найдите и выберите экземпляр Служба приложений, созданный на предыдущем шаге, и нажмите кнопку "ОК".
Процесс w3wp.exe должен отображаться в списке доступных для подключения процессов, который является основным процессом Службы приложений Azure, где размещается развернутое приложение. Выберите этот процесс и нажмите Подключить в правом нижнем углу, чтобы подключить отладчик Visual Studio.
В Index.cshtml.cs или другом файле приложения C# задайте точку останова, щелкнув в левом поле. (Или щелкните правой кнопкой мыши и выберите Точка>останова Вставка точки останова.)
При необходимости можно также проверить, загрузил ли Visual Studio файлы символов для сеанса отладки. Перейдите в раздел Отладка > Windows> Модули, чтобы открыть окно модулей. В этом окне должно быть указано, что файлы символов были успешно загружены после изменения конфигурации кода , внесенных ранее.