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

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

Požadavky

• Visual Studio 2022 s nainstalovaným vývojem ASP.NET a webem a nainstalovanou úlohou vývoje pro Azure

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

  Praktické školení, které zahrnuje nasazení služby App Service, najdete v tématu Vzdálené ladění ASP.NET Core v Azure.

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žní ladicímu programu sady Visual Studio připojit se 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 je instance služby App Service pojmenovaná. 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.

Konfigurace nastavení ladění

Před laděním aplikace v Azure se ujistěte, že jste dokončili následující kroky v sadě Visual Studio, abyste zajistili úspěch.

1. Nejprve se ujistěte, že jste úspěšně vytvořili projekt alespoň jednou. Úspěšné sestavení zajišťuje zdrojový kód a všechny potřebné kompilované soubory jsou připravené k přechodu. Pokud je vaše aplikace spuštěná místně, nezapomeňte ji zastavit.

   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á do nasazené aplikace.

2. V horní nabídce sady Visual Studio vyberte Možnosti ladění>. Ujistěte se, že políčko Povolit pouze můj kód není zaškrtnuto (jak je znázorněno níže) a pak vyberte OK.

   Změna tohoto nastavení umožňuje sadě Visual Studio ladit optimalizovaný kód nasazený do Azure pomocí potřebných souborů symbolů z místní složky bin. Soubory symbolů používá ladicí program jako most mezi kompilovaným, spouštěním kódu a zdrojovým kódem v sadě Visual Studio, což je důvod, proč je důležité, aby místní zdrojový kód odpovídal aplikaci pro nasazení.

   

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 a otevřete odpovídající dialogové okno. Pomocí tohoto okna se můžete připojit a připojit k různým cílů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 Služby Microsoft Aplikace Azure.

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

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

5. Tento w3wp.exe proces by se měl zobrazit v seznamu dostupných procesů pro připojení, což je hlavní proces služby Aplikace Azure, která hostuje nasazenou aplikaci. Vyberte tento proces a pak zvolte Připojit v pravém dolním rohu a připojte ladicí program sady Visual Studio.

   

6. V Index.cshtml.cs jiném souboru aplikace jazyka C# nastavte zarážku kliknutím na levý okraj. (Nebo klikněte pravým tlačítkem myši a zvolte Zarážka>Vložit zarážku.)

7. Volitelně můžete také ověřit, že sada Visual Studio načetla soubory symbolů pro relaci ladění. Přejděte do části Ladění > modulů systému Windows > a otevřete okno modulů. Toto okno by mělo indikovat, že soubory symbolů byly úspěšně načteny po změnách konfigurace kódu , které jste provedli dříve.