Zdalne debugowanie aplikacji w usłudze Azure Spring Apps

Uwaga

Plany Basic, Standardi Enterprise weszły w okres wycofywania 17 marca 2025 r. Aby uzyskać więcej informacji, zobacz ogłoszenie o wycofaniu usługi Azure Spring Apps.

Plan dotyczący zużycia standardowego oraz dedykowany plan zostały wycofane 30 września 2024 r., z całkowitym zamknięciem do końca marca 2025 r. Aby uzyskać więcej informacji, zobacz Migrowanie planu konsumpcji Standard i planu dedykowanego usługi Azure Spring Apps do usługi Azure Container Apps.

Ten artykuł dotyczy:✅ Podstawowa/Standardowa ✅ Enterprise

Ta funkcja opisuje sposób włączania zdalnego debugowania aplikacji w usłudze Azure Spring Apps.

Wymagania wstępne

• Interfejs wiersza polecenia platformy Azure z rozszerzeniem Azure Spring Apps. Użyj następującego polecenia, aby usunąć poprzednie wersje i zainstalować najnowsze rozszerzenie. Jeśli wcześniej zainstalowano rozszerzenie spring-cloud, odinstaluj je, aby uniknąć niezgodności konfiguracji i wersji.

  az extension remove --name spring
  az extension add --name spring
  az extension remove --name spring-cloud
  

• Wdrożona aplikacja w usłudze Azure Spring Apps.

Włączanie lub wyłączanie debugowania zdalnego

Ze względów bezpieczeństwa usługa Azure Spring Apps domyślnie wyłącza debugowanie zdalne. Na podstawie polityki firmy możesz samodzielnie włączyć zdalne debugowanie aplikacji lub skonsultować się z administratorem, aby włączył zdalne debugowanie. Możesz włączyć lub wyłączyć debugowanie zdalne przy użyciu interfejsu wiersza polecenia platformy Azure, witryny Azure Portal lub rozszerzenia programu VS Code.

Azure portal

Wykonaj następujące kroki, aby włączyć zdalne debugowanie aplikacji przy użyciu witryny Azure Portal:

1. Przejdź do strony aplikacji.

2. W obszarze Ustawienia w okienku nawigacji po lewej stronie wybierz pozycję Debugowanie zdalne.

3. Na stronie Debugowanie zdalne włącz zdalne debugowanie i określ port debugowania.

   

Interfejs wiersza polecenia platformy Azure

Użyj następującego polecenia, aby włączyć zdalne debugowanie aplikacji przy użyciu interfejsu wiersza polecenia platformy Azure:

az spring app enable-remote-debugging \
    --name <application-name> \
    --deployment <deployment-name> \
    --resource-group <resource-group-name> \
    --service <service-name> \
    --port <port>

Użyj następującego polecenia, aby wyłączyć zdalne debugowanie dla aplikacji:

az spring app disable-remote-debugging \
    --name <application-name> \
    --deployment <deployment-name> \
    --resource-group <resource-group-name> \
    --service <service-name> \

Użyj następującego polecenia, aby wyświetlić konfigurację debugowania zdalnego:

az spring app get-remote-debugging-config \
    --name <application-name> \
    --deployment <deployment-name> \
    --resource-group <resource-group-name> \
    --service <service-name> \

Przypisywanie roli platformy Azure

Aby zdalnie debugować wystąpienie aplikacji, musisz mieć przypisaną rolę Azure Spring Apps Remote Debugging Role, która obejmuje uprawnienie do akcji na danych Microsoft.AppPlatform/Spring/apps/deployments/remotedebugging/action.

Rolę platformy Azure można przypisać przy użyciu witryny Azure Portal lub interfejsu wiersza polecenia platformy Azure.

Portal Azure

Wykonaj poniższe kroki, aby przypisać rolę platformy Azure przy użyciu witryny Azure Portal.

1. Otwórz portal Azure.

2. Otwórz wystąpienie usługi Azure Spring Apps.

3. W okienku nawigacji wybierz pozycję Kontrola dostępu (IAM).

4. Na stronie Kontrola dostępu (IAM) wybierz Dodaj, a następnie wybierz Dodaj przypisanie roli.

   

5. Na stronie Dodawanie przypisania roli na liście Nazwa wyszukaj i wybierz pozycję Rola zdalnego debugowania usługi Azure Spring Apps, a następnie wybierz pozycję Dalej.

   

6. Wybierz pozycję Członkowie, a następnie wyszukaj i wybierz swoją nazwę użytkownika.

7. Wybierz Przejrzyj + przypisz.

Azure CLI

Użyj następującego polecenia, aby uzyskać rolę zdalnego debugowania usługi Azure Spring Apps.

az role assignment create \
    --role "Azure Spring Apps Remote Debugging Role" \
    --scope "<service-instance-resource-id>" \
    --assignee "<your-identity>"

Zdalnie debugować wystąpienie aplikacji

Można zdalnie debugować instancję aplikacji, korzystając z narzędzia Azure Toolkit for IntelliJ lub rozszerzenia Azure Spring Apps for VS Code.

Azure Toolkit for IntelliJ

W tej sekcji opisano sposób zdalnego debugowania wystąpienia aplikacji przy użyciu zestawu narzędzi Azure Toolkit for IntelliJ.

Wymagania wstępne

• Azure Toolkit for IntelliJ.
• IntelliJ IDEA, Ultimate lub Community Edition.

Włączanie lub wyłączanie debugowania zdalnego

Aby włączyć lub wyłączyć debugowanie zdalne, wykonaj następujące czynności:

1. Zaloguj się do konta platformy Azure w usłudze Azure Explorer.

2. Wybierz wystąpienie aplikacji, a następnie wybierz pozycję Włącz zdalne debugowanie.

   

Dołączanie debugera

Aby dołączyć debuger, wykonaj następujące kroki.

1. Wybierz wystąpienie aplikacji, a następnie wybierz pozycję Dołącz debuger. IntelliJ łączy się z instancją aplikacji i uruchamia zdalne debugowanie.

   

2. Zestaw narzędzi Azure Toolkit for IntelliJ tworzy konfigurację debugowania zdalnego. Możesz go znaleźć w obszarze Zdalne debugowanie Jvm" Konfigurowanie ścieżki klasy modułu do kodu źródłowego używanego do zdalnego debugowania.

   

Rozwiązywanie problemów

Ta sekcja zawiera informacje dotyczące rozwiązywania problemów.

• Wykonaj następujące czynności, jeśli nie można dołączyć debugera i wystąpi błąd podobny do java.net.SocketException, connection reset lub Failed to attach to remote debugger, ClosedConnectionException:

  • Sprawdź rolę RBAC, aby upewnić się, że masz uprawnienia do zdalnego debugowania wystąpienia aplikacji.

  • Upewnij się, że nawiązujesz połączenie z prawidłową instancją. Odśwież wdrożenie, aby uzyskać najnowsze wystąpienia.

    

• Jeśli pomyślnie dołączysz debuger, ale nie możesz zdalnie debugować wystąpienia aplikacji, wykonaj następujące czynności:

  • Upewnij się, że środowisko IDE zawiera kod źródłowy, który chcesz debugować.
  • Upewnij się, że konfiguracja debugowania ma poprawną ścieżkę klasy modułu.

Rozszerzenie programu VS Code

W tej sekcji opisano sposób zdalnego debugowania wystąpienia aplikacji przy użyciu rozszerzenia programu VS Code.

Wymagania wstępne

• Wtyczka Azure Spring Apps for VS Code.
• Visual Studio Code

Włączanie lub wyłączanie debugowania zdalnego

Aby włączyć lub wyłączyć debugowanie zdalne, wykonaj następujące czynności:

1. Zaloguj się do subskrypcji platformy Azure.

2. Wybierz wystąpienie aplikacji, a następnie wybierz pozycję Włącz zdalne debugowanie.

   

Dołączanie debugera

Aby dołączyć debuger, wykonaj następujące kroki.

1. Wybierz wystąpienie aplikacji, a następnie wybierz pozycję Dołącz debuger. Program VS Code łączy się z wystąpieniem aplikacji i uruchamia zdalne debugowanie.

   

Rozwiązywanie problemów

Ta sekcja zawiera informacje dotyczące rozwiązywania problemów.

• Wykonaj następujące czynności, jeśli nie można dołączyć debugera i wystąpi błąd podobny do java.net.SocketException, connection reset lub Failed to attach to remote debugger, ClosedConnectionException:

  • Sprawdź rolę RBAC, aby upewnić się, że masz uprawnienia do zdalnego debugowania wystąpienia aplikacji.

  • Upewnij się, że nawiązujesz połączenie z prawidłowym wystąpieniem. Odśwież wdrożenie, aby pobrać najnowsze wystąpienia.

    

• Wykonaj następującą akcję, jeśli pomyślnie dołączysz debuger, ale nie możesz zdalnie debugować wystąpienia aplikacji:

  • Upewnij się, że środowisko IDE zawiera kod źródłowy, który chcesz debugować.

Ograniczenia

Debugowanie zdalne jest obsługiwane tylko w przypadku aplikacji Java.

Planowanie	Typ wdrożenia	Wspierane
Plan standardowy i podstawowy	Słoik	Tak
Plan standardowy i podstawowy	Kod źródłowy (Java)	Tak
Plan standardowy i podstawowy	Obraz niestandardowy	Nie.
Plan przedsiębiorstwa	Aplikacja Java	Tak
Plan przedsiębiorstwa	Kod źródłowy (Java)	Tak
Plan przedsiębiorstwa	Niestandardowy obraz	Nie.

Wskazówki

• Zdalne debugowanie języka Java jest niebezpieczne, ponieważ umożliwia zdalne wykonywanie kodu. Usługa Azure Spring Apps pomaga zabezpieczyć komunikację między środowiskiem IDE klienta a aplikacją zdalną. Należy jednak wyłączyć zdalne debugowanie i usunąć rolę RBAC po zakończeniu.
• Należy skalować instancję aplikacji do jednego, aby zapewnić, że ruch może trafić do tej instancji.

Następne kroki

• Azure Spring Apps