Felsöka dina appar via fjärranslutning i Azure Spring Apps

Kommentar

Basic-, Standard- och Enterprise-planerna kommer att vara inaktuella från och med mitten av mars 2025, med en 3-årig pensionsperiod. Vi rekommenderar att du övergår till Azure Container Apps. Mer information finns i meddelandet om azure Spring Apps-pensionering.

Standardförbrukningen och den dedikerade planen kommer att vara inaktuell från och med den 30 september 2024, med en fullständig avstängning efter sex månader. Vi rekommenderar att du övergår till Azure Container Apps. Mer information finns i Migrera Azure Spring Apps Standard-förbrukning och dedikerad plan till Azure Container Apps.

Den här artikeln gäller för: ✔️ Basic/Standard ✔️ Enterprise

Den här funktionen beskriver hur du aktiverar fjärrfelsökning av dina program i Azure Spring Apps.

Förutsättningar

• Azure CLI med Azure Spring Apps-tillägget. Använd följande kommando för att ta bort tidigare versioner och installera det senaste tillägget. Om du tidigare har installerat spring-cloud-tillägget avinstallerar du det för att undvika konfigurations- och versionsmatchningar.

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

• Ett distribuerat program i Azure Spring Apps.

Aktivera eller inaktivera fjärrfelsökning

Av säkerhetsskäl inaktiverar Azure Spring Apps fjärrfelsökning som standard. Baserat på din företagsprincip kan du aktivera fjärrfelsökning för din app själv eller se en administratör för att aktivera den åt dig. Du kan aktivera eller inaktivera fjärrfelsökning med hjälp av Azure CLI, Azure Portal eller VS Code-tillägget.

Azure-portalen

Använd följande steg för att aktivera fjärrfelsökning för ditt program med hjälp av Azure Portal:

1. Gå till programsidan.

2. Under Inställningar i det vänstra navigeringsfönstret väljer du Fjärrfelsökning.

3. På sidan Fjärrfelsökning aktiverar du fjärrfelsökning och anger felsökningsporten.

   

Azure CLI

Använd följande kommando för att aktivera fjärrfelsökning för ditt program med hjälp av Azure CLI:

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

Använd följande kommando för att inaktivera fjärrfelsökning för ditt program:

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

Använd följande kommando för att visa konfigurationen för fjärrfelsökning:

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

Tilldela en Azure-roll

Om du vill fjärrfelsöka en appinstans måste du beviljas rollen Azure Spring Apps Remote Debugging Role, som innehåller behörigheten Microsoft.AppPlatform/Spring/apps/deployments/remotedebugging/action dataåtgärd.

Du kan tilldela en Azure-roll med hjälp av Azure Portal eller Azure CLI.

Azure-portalen

Använd följande steg för att tilldela en Azure-roll med hjälp av Azure Portal.

1. Öppna Azure Portal.

2. Öppna din Azure Spring Apps-tjänstinstans.

3. I navigeringsfönstret väljer du Åtkomstkontroll (IAM).

4. På sidan Åtkomstkontroll (IAM) väljer du Lägg till och sedan Lägg till rolltilldelning.

   

5. På sidan Lägg till rolltilldelning i listan Namn söker du efter och väljer Fjärrfelsökningsroll för Azure Spring Apps och väljer sedan Nästa.

   

6. Välj Medlemmar och sök sedan efter och välj ditt användarnamn.

7. Välj Granska + tilldela.

Azure CLI

Använd följande kommando för att hämta fjärrfelsökningsrollen för Azure Spring Apps.

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

Felsöka en appinstans via fjärranslutning

Du kan felsöka en appinstans via fjärranslutning med Azure Toolkit for IntelliJ eller Azure Spring Apps for VS Code-tillägget.

Azure Toolkit for IntelliJ

I det här avsnittet beskrivs hur du felsöker en appinstans via fjärranslutning med Hjälp av Azure Toolkit for IntelliJ.

Förutsättningar

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

Aktivera eller inaktivera fjärrfelsökning

Använd följande steg för att aktivera eller inaktivera fjärrfelsökning:

1. Logga in på ditt Azure-konto i Azure Explorer.

2. Välj en appinstans och välj sedan Aktivera fjärrfelsökning.

   

Bifoga felsökningsprogram

Använd följande steg för att bifoga felsökningsprogrammet.

1. Välj en appinstans och välj sedan Bifoga felsökningsprogram. IntelliJ ansluter till appinstansen och startar fjärrfelsökning.

   

2. Azure Toolkit for IntelliJ skapar konfigurationen för fjärrfelsökning. Du hittar den under Remote Jvm Debug" Configure the module class path to the source code that you use for remote debugging ( Konfigurera modulklasssökvägen till den källkod som du använder för fjärrfelsökning).

   

Felsökning

Det här avsnittet innehåller felsökningsinformation.

• Utför följande åtgärder om du inte kan bifoga felsökningsprogrammet och får ett fel som liknar java.net.SocketException, connection reset eller Failed to attach to remote debugger, ClosedConnectionException:

  • Kontrollera RBAC-rollen för att se till att du har behörighet att fjärrfelsöka en appinstans.

  • Kontrollera att du ansluter till en giltig instans. Uppdatera distributionen för att hämta de senaste instanserna.

    

• Utför följande åtgärder om du har bifogat felsökningsprogrammet men inte kan felsöka appinstansen via fjärranslutning:

  • Kontrollera att din IDE innehåller den källkod som du vill felsöka.
  • Kontrollera att felsökningskonfigurationen har rätt modulklasssökväg.

VS Code-tillägg

I det här avsnittet beskrivs hur du felsöker en appinstans via fjärranslutning med hjälp av VS Code-tillägget.

Förutsättningar

• Azure Spring Apps för VS Code-plugin-program.
• Visual Studio Code.

Aktivera eller inaktivera fjärrfelsökning

Använd följande steg för att aktivera eller inaktivera fjärrfelsökning:

1. Logga in på din Azure-prenumeration.

2. Välj en appinstans och välj sedan Aktivera fjärrfelsökning.

   

Bifoga felsökningsprogram

Använd följande steg för att bifoga felsökningsprogrammet.

1. Välj en appinstans och välj sedan Bifoga felsökningsprogram. VS Code ansluter till appinstansen och startar fjärrfelsökning.

   

Felsökning

Det här avsnittet innehåller felsökningsinformation.

• Utför följande åtgärder om du inte kan bifoga felsökningsprogrammet och får ett fel som liknar java.net.SocketException, connection reset eller Failed to attach to remote debugger, ClosedConnectionException:

  • Kontrollera RBAC-rollen för att se till att du har behörighet att fjärrfelsöka en appinstans.

  • Kontrollera att du ansluter till en giltig instans. Uppdatera distributionen för att hämta de senaste instanserna.

    

• Utför följande åtgärd om du har bifogat felsökningsprogrammet men inte kan felsöka appinstansen via fjärranslutning:

  • Kontrollera att din IDE innehåller den källkod som du vill felsöka.

Begränsningar

Fjärrfelsökning stöds endast för Java-program.

Planera	Distributionstyp	Stöds
Standard och grundläggande plan	Burk	Ja
Standard och grundläggande plan	Källkod (Java)	Ja
Standard och grundläggande plan	Anpassad avbildning	Nej
Enterprise-plan	Java-program	Ja
Enterprise-plan	Källkod (Java)	Ja
Enterprise-plan	Anpassad avbildning	Nej

Tips

• Java-fjärrfelsökning är farligt eftersom det tillåter fjärrkörning av kod. Azure Spring Apps hjälper dig att skydda kommunikationen mellan din klient-IDE och fjärrappen. Du bör dock inaktivera fjärrfelsökning och ta bort RBAC-rollen när du är klar.
• Du bör skala i appinstansen till en för att säkerställa att trafiken kan gå till instansen.

Nästa steg

• Azure Spring Apps