Отладка облачной службы Azure в Visual Studio

Visual Studio предоставляет различные варианты отладки azure Облачные службы и виртуальных машин.

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

• Учетная запись Azure. Если у вас нет учетной записи Azure, активируйте преимущества Azure для подписчиков Visual Studio или зарегистрируйтесь для получения бесплатной пробной версии.

Отладка облачной службы на локальном компьютере

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

Эмулятор имитирует службу вычислений Azure и выполняется в локальной среде, благодаря чему можно осуществить тестирование и отладку облачной службы перед ее развертыванием. Эмулятор обрабатывает жизненный цикл экземпляров ролей и предоставляет доступ к имитируемым ресурсам, таким как локальное хранилище. При отладке или запуске службы в системе Visual Studio она автоматически запускает эмулятор в качестве фонового приложения, а затем выполняет развертывание службы в эмуляторе. Вы можете использовать эмулятор для просмотра службы, запущенной в локальной среде. Можно запустить полную версию или экспресс-версию эмулятора. Ознакомьтесь с разделом Использование эмулятора Emulator Express для запуска и отладки облачной службы в локальной среде.

Порядок отладки облачной службы на локальном компьютере

1. В строке меню выберите "Отладка запуска отладки>", чтобы запустить проект облачной службы Azure. Вы также можете нажать клавишу F5. Появится сообщение о запуске эмулятора вычислений. На запуск эмулятора указывает значок в области уведомлений.

   

2. Откройте пользовательский интерфейс эмулятора вычислений. Для этого в области уведомлений правой кнопкой мыши щелкните значок Azure и выберите пункт Show Compute Emulator UI (Показать пользовательский интерфейс эмулятора вычислений).

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

3. Пошаговые шаги по приложению, выбрав команды в меню отладки и установив точки останова в коде. По мере работы с приложением в отладчике в областях будет отображаться текущее состояние приложения. При остановке отладки развертывание приложения удаляется. Если приложение включает в себя веб-роль и было задано свойство Startup action для запуска веб-браузера, то Visual Studio запускает веб-приложение в браузере. Если вы изменили количество экземпляров роли в конфигурации службы, то необходимо остановить облачную службу и затем перезапустить отладку, чтобы можно было отлаживать эти новые экземпляры роли.

   Примечание.

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

Отладка облачной службы в Azure

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

Примечание.

При публикации облачной службы из Visual Studio можно включить IntelliTrace для всех ролей в этой службе, предназначенных для платформа .NET Framework 4 или платформа .NET Framework 4.x. С помощью IntelliTrace можно изучить события, произошедшие в экземпляре роли в прошлом, и воспроизвести контекст за тот период времени. Ознакомьтесь со статьями Отладка опубликованной облачной службы с помощью IntelliTrace и Visual Studio и Использование IntelliTrace.

Включение удаленной отладки для облачной службы (расширенная поддержка)

1. Добавьте конечную точку в serviceDefinition.csdef для порта msvsmon по умолчанию. Для Visual Studio 2022 это 4026; Для Visual Studio 2019 это 4024.

   <Endpoints>
      <InputEndpoint name="RemoteDebug" protocol="tcp" port="4026" localPort="4026" />
   </Endpoints>
   

   Примечание.

   Другие версии Visual Studio имеют разные порты назначения портов удаленного отладчика.

2. Если вы нацелены на .NET 4.8, откройте файл ServiceConfiguration.Cloud.cscfg и проверка значение osFamily атрибута в ServiceConfiguration элементе при публикации Облачные службы (расширенная поддержка). Для проекта .NET 4.8 используйте osFamily="7".

3. Откройте контекстное меню проекта Azure и выберите пункт Опубликовать.

4. Выберите элемент Промежуточная среда и конфигурацию Отладка.

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

   

5. Выполните обычные действия, описанные в Облачные службы (расширенная поддержка), но выберите пункт "Включить удаленный рабочий стол" для всех ролей проверка box.

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

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

7. Войдите в портал Azure и перейдите в облачную службу (расширенную поддержку), которую требуется выполнить отладку.

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

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

   

10. На виртуальной машине Удаленной машины Azure установите средства удаленной отладки Visual Studio 2022, как описано в удаленной отладке.

11. На рабочем столе на виртуальной машине выполните команду D:\Program Files\Microsoft Visual Studio 17.0\Common7\IDE\Remote Debugger\x64\msvsmon.exe. Не забудьте запустить как Администратор istrator.

12. Примите запросы на разрешение доступа через брандмауэр. Должно появиться сообщение, указывающее, что msvsmon.exe начал прослушивать подключения.

    

13. В портал Azure откройте группу ресурсов и получите общедоступный IP-адрес облачной службы (расширенная поддержка).

    

Подключение отладчика к облачной службе (расширенная поддержка) в Azure

Примечание.

По возможности следует выполнить отладку с конфигурацией отладки, выбранной в процессе публикации, но при отладке конфигурации выпуска в Visual Studio используйте ctrl+Q для поиска "Просто мой код" и un проверка Включить только мой код в общем отладчике>параметров>инструментов.> Сборки выпуска оптимизированы, поэтому не считаются "Мой код".

1. Выберите Отладка>Подключиться к процессу (или нажмите сочетание клавиш CTRL+ALT+P).

2. Сохраните тип подключения по умолчанию.

3. Введите целевой объект подключения, используя IP-адрес и порт: {ipaddress}:4026

4. Присвойте параметру "Подключиться" взначение "Автоматически".

5. Войдите, используя те же учетные данные, что и пользователь удаленного рабочего стола.

6. Выберите "Показать процесс" для всех пользователей. Если вы выполняете отладку рабочей роли, подключитесь к WaWorkerHost.exe; если выполняется отладка веб-роли, подключитесь к процессу w3wp.exe; для роли веб-API это WaIISHost.exe.

7. Задайте точки останова (перейдите к строке и нажмите клавишу F9), откройте общедоступный URL-адрес сайта и воспроизводите сценарий для отладки.

Ограничения удаленной отладки в Azure

Удаленная отладка имеет следующие ограничения:

• При включенной удаленной отладке нельзя опубликовать облачную службу, в которой любая роль содержит более 25 экземпляров.

• Отладчик использует порты 30400–30424, 31400–31424 и 32400–32424. Если вы попытаетесь использовать любой из этих портов, то не сможете опубликовать службу, а в журнале действий для Azure появится одно из следующих сообщений об ошибке:

  • Ошибка проверки CSCFG-файла на основе CSDEF-файла. Диапазон зарезервированных портов для конечной точки Microsoft.WindowsAzure.PlugIns.RemoteDebugger.Connector роли "роль" перекрывается с уже определенным портом или диапазоном.
  • Ошибка выделения. Повторите попытку позже, попробуйте уменьшить размер виртуальной машины или количество экземпляров ролей или попытаться развернуть в другом регионе.

Отладка службы приложение Azure

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

Примечание.

Это доступно только для службы приложение Azure начиная с Visual Studio 2022 17.1.

Отладка службы Windows приложение Azure

1. В разделе "Отладка" выберите "Присоединить к процессу".

2. Измените тип Подключение ion на Службы Microsoft приложение Azure, а затем выберите Find...

3. В открывшемся диалоговом окне выберите имя подписки.

   

   Примечание.

   Необходимо войти в учетную запись Майкрософт с доступом к подписке, содержащей службу приложение Azure.

4. Отфильтруйте представление по группе ресурсов или типу ресурсов или по имени.

5. Затем выберите Служба приложений, которые вы хотите отладить, а затем нажмите кнопку "ОК".

   Это обеспечивает удаленную отладку в Служба приложений и отображает список доступных процессов для присоединения.

   

6. Выберите процесс, к которому нужно присоединиться, а затем нажмите кнопку "Присоединить ", чтобы начать отладку.

Связанный контент

• Используйте Intellitrace для сбора данных журнала вызовов и событий с сервера выпуска. Ознакомьтесь со статьей Отладка опубликованной облачной службы с помощью IntelliTrace и Visual Studio.

• Используйте систему диагностики Azure для регистрации подробных сведений из кода, выполняющегося в ролях, независимо от того, запущены ли эти роли в среде разработки или в Azure. Ознакомьтесь со статьей Включение системы диагностики Azure в облачных службах Azure.

• Сведения о других сценариях удаленной отладки см. в разделе "Удаленная отладка".