Fouten opsporen in uw apps op afstand in Azure Spring Apps

Notitie

De Basic-, Standard- en Enterprise-abonnementen worden afgeschaft vanaf medio maart 2025, met een pensioenperiode van 3 jaar. We raden u aan om over te stappen naar Azure Container Apps. Zie de aankondiging over buitengebruikstelling van Azure Spring Apps voor meer informatie.

Het standaardverbruik en het speciale abonnement worden vanaf 30 september 2024 afgeschaft, met een volledige afsluiting na zes maanden. We raden u aan om over te stappen naar Azure Container Apps. Zie Azure Spring Apps Standard-verbruik en toegewezen abonnement migreren naar Azure Container Apps voor meer informatie.

Dit artikel is van toepassing op:✅ Basic/Standard ✅ Enterprise

In deze functie wordt beschreven hoe u externe foutopsporing van uw toepassingen inschakelt in Azure Spring Apps.

Vereisten

• Azure CLI met de Azure Spring Apps-extensie. Gebruik de volgende opdracht om eerdere versies te verwijderen en de nieuwste extensie te installeren. Als u de spring-cloud-extensie eerder hebt geïnstalleerd, verwijdert u deze om te voorkomen dat de configuratie en versie niet overeenkomen.

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

• Een geïmplementeerde toepassing in Azure Spring Apps.

Externe foutopsporing in- of uitschakelen

Om veiligheidsredenen schakelt Azure Spring Apps standaard externe foutopsporing uit. Op basis van uw bedrijfsbeleid kunt u zelf externe foutopsporing voor uw app inschakelen of een beheerder zien om deze voor u in te schakelen. U kunt externe foutopsporing in- of uitschakelen met behulp van Azure CLI, Azure Portal of de VS Code-extensie.

Azure-portal

Gebruik de volgende stappen om externe foutopsporing in te schakelen voor uw toepassing met behulp van Azure Portal:

1. Navigeer naar de toepassingspagina.

2. Selecteer externe foutopsporing onder Instellingen in het linkernavigatiedeelvenster.

3. Schakel op de pagina Externe foutopsporing externe foutopsporing in en geef de poort voor foutopsporing op.

   

Azure-CLI

Gebruik de volgende opdracht om externe foutopsporing voor uw toepassing in te schakelen met behulp van de Azure CLI:

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

Gebruik de volgende opdracht om externe foutopsporing voor uw toepassing uit te schakelen:

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

Gebruik de volgende opdracht om de configuratie voor externe foutopsporing weer te geven:

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

Een Azure-rol toewijzen

Als u op afstand fouten wilt opsporen in een app-exemplaar, moet u de rol Azure Spring Apps Remote Debugging Rolekrijgen, die de machtiging voor de Microsoft.AppPlatform/Spring/apps/deployments/remotedebugging/action gegevensactie bevat.

U kunt een Azure-rol toewijzen met behulp van Azure Portal of Azure CLI.

Azure-portal

Gebruik de volgende stappen om een Azure-rol toe te wijzen met behulp van Azure Portal.

1. Open de Azure Portal.

2. Open uw Azure Spring Apps-service-exemplaar.

3. Selecteer Toegangsbeheer (IAM) in het navigatiedeelvenster.

4. Selecteer Toevoegen op de pagina Toegangsbeheer (IAM) en selecteer vervolgens Roltoewijzing toevoegen.

   

5. Zoek en selecteer op de pagina Roltoewijzing toevoegen in de lijst Naam de rol Externe foutopsporing van Azure Spring Apps en selecteer vervolgens Volgende.

   

6. Selecteer Leden en zoek en selecteer uw gebruikersnaam.

7. Selecteer Controleren + toewijzen.

Azure-CLI

Gebruik de volgende opdracht om de rol Externe foutopsporing van Azure Spring Apps op te halen.

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

Fouten opsporen in een app-exemplaar op afstand

U kunt op afstand fouten opsporen in een app-exemplaar met behulp van de Azure-toolkit voor IntelliJ of de Azure Spring Apps for VS Code-extensie.

Azure-toolkit voor IntelliJ

In deze sectie wordt beschreven hoe u op afstand fouten kunt opsporen in een app-exemplaar met behulp van de Azure-toolkit voor IntelliJ.

Vereisten

• Azure Toolkit voor IntelliJ.
• IntelliJ IDEA, Ultimate of Community Edition.

Externe foutopsporing in- of uitschakelen

Gebruik de volgende stappen om externe foutopsporing in of uit te schakelen:

1. Meld u aan bij uw Azure-account in Azure Explorer.

2. Selecteer een app-exemplaar en selecteer externe foutopsporing inschakelen.

   

Foutopsporingsprogramma koppelen

Gebruik de volgende stappen om het foutopsporingsprogramma te koppelen.

1. Selecteer een app-exemplaar en selecteer vervolgens Foutopsporingsprogramma bijvoegen. IntelliJ maakt verbinding met het app-exemplaar en start externe foutopsporing.

   

2. Azure Toolkit voor IntelliJ maakt de configuratie voor externe foutopsporing. U vindt deze onder Externe Jvm-foutopsporing' Configureer het moduleklassepad naar de broncode die u gebruikt voor externe foutopsporing.

   

Probleemoplossing

Deze sectie bevat informatie over probleemoplossing.

• Voer de volgende acties uit als u het foutopsporingsprogramma niet kunt koppelen en een fout ontvangt die vergelijkbaar is met java.net.SocketException, connection reset of Failed to attach to remote debugger, ClosedConnectionException:

  • Controleer de RBAC-rol om ervoor te zorgen dat u bent gemachtigd om op afstand fouten op te sporen in een app-exemplaar.

  • Zorg ervoor dat u verbinding maakt met een geldig exemplaar. Vernieuw de implementatie om de nieuwste exemplaren op te halen.

    

• Voer de volgende acties uit als u het foutopsporingsprogramma hebt gekoppeld, maar het app-exemplaar niet op afstand kunt opsporen:

  • Zorg ervoor dat uw IDE de broncode bevat die u wilt opsporen.
  • Zorg ervoor dat de foutopsporingsconfiguratie het juiste moduleklassepad heeft.

VS Code-extensie

In deze sectie wordt beschreven hoe u op afstand fouten kunt opsporen in een app-exemplaar met behulp van de VS Code-extensie.

Vereisten

• Azure Spring Apps voor VS Code-invoegtoepassing.
• Visual Studio Code.

Externe foutopsporing in- of uitschakelen

Gebruik de volgende stappen om externe foutopsporing in of uit te schakelen:

1. Meld u aan bij uw Azure-abonnement.

2. Selecteer een app-exemplaar en selecteer externe foutopsporing inschakelen.

   

Foutopsporingsprogramma koppelen

Gebruik de volgende stappen om het foutopsporingsprogramma te koppelen.

1. Selecteer een app-exemplaar en selecteer vervolgens Foutopsporingsprogramma bijvoegen. VS Code maakt verbinding met het app-exemplaar en start externe foutopsporing.

   

Probleemoplossing

Deze sectie bevat informatie over probleemoplossing.

• Voer de volgende acties uit als u het foutopsporingsprogramma niet kunt koppelen en een fout ontvangt die vergelijkbaar is met java.net.SocketException, connection reset of Failed to attach to remote debugger, ClosedConnectionException:

  • Controleer de RBAC-rol om ervoor te zorgen dat u bent gemachtigd om op afstand fouten op te sporen in een app-exemplaar.

  • Zorg ervoor dat u verbinding maakt met een geldig exemplaar. Vernieuw de implementatie om de nieuwste exemplaren op te halen.

    

• Voer de volgende actie uit als u het foutopsporingsprogramma hebt gekoppeld, maar het app-exemplaar niet op afstand kunt opsporen:

  • Zorg ervoor dat uw IDE de broncode bevat die u wilt opsporen.

Beperkingen

Externe foutopsporing wordt alleen ondersteund voor Java-toepassingen.

Plannen	Implementatietype	Ondersteund
Standaard- en basisabonnement	Jar	Ja
Standaard- en basisabonnement	Broncode (Java)	Ja
Standaard- en basisabonnement	Aangepaste installatiekopie	Nee
Enterprise-abonnement	Java-toepassing	Ja
Enterprise-abonnement	Broncode (Java)	Ja
Enterprise-abonnement	Aangepaste installatiekopie	Nee

Tips

• Externe foutopsporing in Java is gevaarlijk omdat hiermee externe code kan worden uitgevoerd. Met Azure Spring Apps kunt u de communicatie tussen uw client-IDE en de externe toepassing beveiligen. U moet echter externe foutopsporing uitschakelen en de RBAC-rol verwijderen nadat u klaar bent.
• U moet inschalen in het app-exemplaar om ervoor te zorgen dat verkeer naar het exemplaar kan gaan.

Volgende stappen

• Azure Spring Apps