Удаленная отладка приложений в Azure Spring Apps
Примечание.
Планы "Базовый", "Стандартный" и "Корпоративный" будут устарели начиная с середины марта 2025 г. с 3-летнего периода выхода на пенсию. Рекомендуется перейти в приложения контейнеров Azure. Дополнительные сведения см. в объявлении о выходе на пенсию в Azure Spring Apps.
Стандартный план потребления и выделенного плана будет устарел с 30 сентября 2024 г. с полным завершением работы после шести месяцев. Рекомендуется перейти в приложения контейнеров Azure. Дополнительные сведения см. в статье "Миграция потребления Azure Spring Apps Standard" и выделенного плана в приложения контейнеров Azure.
Эта статья относится к:✅ Basic/Standard ✅ Enterprise
Эта функция описывает, как включить удаленную отладку приложений в Azure Spring Apps.
Необходимые компоненты
Azure CLI с расширением Azure Spring Apps. Используйте следующую команду, чтобы удалить предыдущие версии и установить последнее расширение. Если вы ранее установили расширение Spring-Cloud, удалите его, чтобы избежать несоответствий конфигурации и версий.
az extension remove --name spring az extension add --name spring az extension remove --name spring-cloudРазвернутое приложение в Azure Spring Apps.
Включение или отключение удаленной отладки
По соображениям безопасности Azure Spring Apps по умолчанию отключает удаленную отладку. В соответствии с политикой компании вы можете включить удаленную отладку для вашего приложения или увидеть администратора, чтобы включить его для вас. Вы можете включить или отключить удаленную отладку с помощью Azure CLI, портал Azure или расширения VS Code.
Выполните следующие действия, чтобы включить удаленную отладку для приложения с помощью портал Azure:
Перейдите на страницу приложения.
В разделе "Параметры " в области навигации слева выберите "Удаленная отладка".
На странице удаленной отладки включите удаленную отладку и укажите порт отладки.
Назначение роли Azure
Для удаленной отладки экземпляра приложения необходимо предоставить роль Azure Spring Apps Remote Debugging Role, включающую Microsoft.AppPlatform/Spring/apps/deployments/remotedebugging/action разрешение действия данных.
Вы можете назначить роль Azure с помощью портал Azure или Azure CLI.
Чтобы назначить роль Azure с помощью портал Azure, выполните следующие действия.
Откройте портал Azure.
Откройте экземпляр службы Azure Spring Apps.
В области навигации выберите контроль доступа (IAM).
На странице контроль доступа (IAM) выберите "Добавить" и выберите "Добавить назначение роли".
На странице "Добавление назначения ролей" в списке "Имя" найдите и выберите роль удаленной отладки Azure Spring Apps, а затем нажмите кнопку "Далее".
Выберите "Участники", а затем найдите и выберите имя пользователя.
Выберите Проверить + назначить.
Удаленная отладка экземпляра приложения
Вы можете удаленно отлаживать экземпляр приложения с помощью набора средств Azure для IntelliJ или расширения Azure Spring Apps для VS Code.
В этом разделе описывается удаленное отладка экземпляра приложения с помощью набора средств Azure для IntelliJ.
Необходимые компоненты
- Набор средств Azure для IntelliJ.
- IntelliJ IDEA, Ultimate или Community edition.
Включение или отключение удаленной отладки
Чтобы включить или отключить удаленную отладку, выполните следующие действия.
Войдите в учетную запись Azure в Azure Explorer.
Выберите экземпляр приложения и нажмите кнопку "Включить удаленную отладку".
Подключение отладчика
Чтобы подключить отладчик, выполните следующие действия.
Выберите экземпляр приложения и нажмите кнопку "Подключить отладчик". IntelliJ подключается к экземпляру приложения и запускает удаленную отладку.
Набор средств Azure для IntelliJ создает конфигурацию удаленной отладки. Его можно найти в разделе "Удаленная отладка Jvm" Настройте путь класса модуля к исходному коду, используемому для удаленной отладки.
Устранение неполадок
В этом разделе содержатся сведения об устранении неполадок.
Выполните следующие действия, если не удается подключить отладчик и получить ошибку, аналогичную
java.net.SocketException, connection resetилиFailed to attach to remote debugger, ClosedConnectionException:Проверьте роль RBAC, чтобы убедиться, что вы авторизованы для удаленной отладки экземпляра приложения.
Убедитесь, что вы подключаетесь к допустимому экземпляру. Обновите развертывание, чтобы получить последние экземпляры.
Выполните следующие действия, если вы успешно подключили отладчик, но не сможете удаленно выполнить отладку экземпляра приложения:
- Убедитесь, что интегрированная среда разработки содержит исходный код, который требуется выполнить отладку.
- Убедитесь, что конфигурация отладки имеет правильный путь к классу модуля.
Ограничения
Удаленная отладка поддерживается только для приложений Java.
| Планирование | Тип развертывания | Поддерживается |
|---|---|---|
| Стандартный и базовый план | Jar | Да |
| Стандартный и базовый план | Исходный код (Java) | Да |
| Стандартный и базовый план | Пользовательский образ | No |
| План "Корпоративный" | Приложение Java | Да |
| План "Корпоративный" | Исходный код (Java) | Да |
| План "Корпоративный" | Пользовательский образ | No |
Советы
- Удаленная отладка Java опасна, так как она позволяет выполнять удаленный код. Azure Spring Apps помогает защитить обмен данными между интегрированной средую разработки клиента и удаленным приложением. Однако после завершения необходимо отключить удаленную отладку и удалить роль RBAC.
- Необходимо масштабировать в экземпляре приложения до одного, чтобы убедиться, что трафик может перейти к экземпляру.