Vzdálené ladění ASP.NET Core ve službě Azure App Service (Windows)

Tento článek popisuje, jak připojit ladicí program sady Visual Studio k aplikaci ASP.NET Core běžící ve službě Azure App Service. Následující kroky umožňují ladit aplikaci, jako by byla spuštěná místně.

Požadavky

• Visual Studio 2022 s nainstalovanou úlohou vývoje ASP.NET a webového vývoje a úlohou vývoje pro Azure

• Nejprve musíte nasadit aplikaci ASP.NET Core do služby Azure App Service (Windows) ze sady Visual Studio a aplikace musí být spuštěná.

• Profil publikování v sadě Visual Studio musí být před spuštěním publikování nastaven na Ladění místo režimu Release.

Povolení vzdáleného ladění

Než budete moct tento problém ladit pomocí sady Visual Studio, musíte ve službě App Service povolit funkci vzdáleného ladění. Toto nastavení umožňuje, aby se ladicí program sady Visual Studio připojil k hlavnímu procesu hostování webu služby App Service.

1. Přihlaste se k vlastnímu webu Azure Portal.

   Vyhledejte nasazenou aplikaci na webu Azure Portal. Aplikaci najdete tak, že přejdete na stránku Služby App Services a vyberete instanci služby App Service. Instanci služby App Service můžete také vyhledat přímo podle názvu na panelu hledání v horní části. (V tomto příkladu má instance služby App Service název GitHubBrowser123.)

   

2. Na stránce nastavení instance služby App Service vyberte v levém navigačním panelu možnost Konfigurace a pak zvolte kartu Obecné nastavení .

3. V dolní části stránky nezapomeňte nastavit funkci Vzdálené ladění na Zapnuto a jako verzi vzdálené sady Visual Studio vyberte Visual Studio 2022.

   

4. Výběrem možnosti Uložit v horní části stránky uložte provedené změny.

Instance služby App Service teď podporuje vzdálené ladění prostřednictvím sady Visual Studio.

Nakonfigurujte nastavení ladění

1. Sestavte aplikaci bez chyb. Pokud je aplikace spuštěná místně, zastavte ji.

   Poznámka:

   Ujistěte se, že stav místního kódu odpovídá tomu, co bylo nasazeno do Azure. Tím zajistíte, že se místní soubory symbolů a zdrojový kód zarovná se nasazenou aplikací.

2. V horní nabídce sady Visual Studio vyberte Možnosti ladění>. Ujistěte se, že je nezaškrtnutá možnostPovolit pouze můj kód (jak je znázorněno na následujícím obrázku) a pak vyberte OK.

   Změna tohoto nastavení umožňuje Visual Studio ladit optimalizovaný kód nasazený do Azure pomocí potřebných souborů symbolů z místní složky 'bin'. Soubory symbolů slouží ladicímu programu jako most mezi kompilovaným a zpracovávaným kódem a zdrojovým kódem v prostředí Visual Studio. Pro vzdálené ladění se vyžadují odpovídající soubory symbolů.

   

Připojení ladicího programu ke službě App Service

1. V hlavní nabídce v horní části sady Visual Studio vyberte Ladit Připojit k procesu, aby se otevřelo odpovídající dialogové okno. Pomocí tohoto okna se můžete připojit a připojit se k různým cílovým zařízením. V tomto případě se připojíte k instanci služby App Service, kterou jste vytvořili v předchozím kroku.

2. Vyberte rozevírací seznam Typ připojení a zvolte možnost Microsoft Azure App Services .

3. Vyberte Najít.. Vedle pole Cíl připojení otevřete dialogové okno, ve které můžete procházet předplatná Azure a aplikační služby.

   Pokud ještě nejste přihlášení pomocí svého předplatného Azure, vyberte Najít... a pak se můžete přihlásit.

4. Vyhledejte a vyberte instanci služby App Service, kterou jste vytvořili v předchozím kroku, a pak zvolte OK.

5. Proces w3wp.exe by se měl zobrazit v seznamu dostupných procesů pro připojení. w3wp.exe je hlavním procesem služby Azure App Service, která hostuje nasazenou aplikaci. w3wp.exe Vyberte proces a pak zvolte Připojit v pravém dolním rohu.

   

6. V souboru aplikace jazyka C#, například Index.cshtml.cs, nastavte zarážku kliknutím na levý okraj. Alternativně klikněte pravým tlačítkem myši a vyberte Zarážka>Vložit zarážku.

7. Ve webové aplikaci přejděte ke koncovému bodu se zarážkou. Pokud jste k procesu připojeni, ale nemůžete se dostat na zarážku, ujistěte se, že je profil publikování v sadě Visual Studio nastavený na konfiguraci ladění místo konfigurace vydané verze.

8. Volitelné: Chcete-li ověřit, zda Visual Studio načetlo soubory symbolů pro vaši relaci ladění. Přejděte do části Ladění > modulů systému Windows > a otevřete okno modulů. Toto okno označuje, že soubory symbolů byly úspěšně načteny po změně nastavení Just my code, kterou jste provedli dříve.

   

Poznámka:

Pro následné ladění služby App Service vyberte možnost Znovu připojit k>w3wp.exe nebo použijte klávesové zkratky Shift+Alt+P.