Vzdálené ladění ASP.NET Core na vzdáleném počítači se službou IIS v Visual Studio

Pokud chcete ladit ASP.NET Core aplikaci nasazenou do služby IIS, nainstalujte a spusťte vzdálené nástroje na počítači, na kterém jste aplikaci nasadili, a pak se připojte ke spuštěné aplikaci z Visual Studio.

komponenty vzdáleného ladicího programuRemote_debugger_components

Tato příručka vysvětluje, jak nastavit a nakonfigurovat Visual Studio ASP.NET Core, nasadit ho do služby IIS a připojit vzdálený ladicí program z Visual Studio. Pokud chcete vzdáleně ladit ASP.NET 4.8, přečtěte si téma Remote Debug ASP.NET na počítači se službou IIS. Službu IIS můžete také nasadit a ladit pomocí Azure. Pro Azure App Service viz Vzdálené ladění ASP.NET Core na Azure nebo pro Visual Studio Enterprise použijte ladicí program Snapshot Debugger (.NET 4.6.1 vyžadováno).

Požadavky

Visual Studio 2019 nebo novější verzi je nutné postupovat podle kroků uvedených v tomto článku.

Tyto postupy byly testovány na těchto konfiguracích serveru:

• Windows Server 2022 a IIS 10
• Windows Server 2019 a IIS 10
• Windows Server 2016 a IIS 10

Požadavky na síť

Nedochází k podpoře ladění mezi dvěma počítači připojenými přes proxy server. Ladění při vysoké latenci nebo připojení s nízkou šířkou pásma, jako je například vytáčené připojení k internetu, nebo přes internet mezi různými zeměmi/regiony, se nedoporučuje a může selhat nebo být nepřijatelně pomalé. Úplný seznam požadavků najdete v tématu Požadavky.

Aplikace už běží ve službě IIS?

Tento článek obsahuje postup nastavení základní konfigurace služby IIS na Windows Serveru a nasazení aplikace z Visual Studio. Tyto kroky jsou zahrnuty, aby se zajistilo, že server má nainstalované požadované součásti, že aplikace může běžet správně a že jste připraveni ke vzdálenému ladění.

• Pokud je vaše aplikace spuštěná ve službě IIS a chcete stáhnout vzdálený ladicí program a spustit ladění, přejděte na Stáhnout a nainstalovat vzdálené nástroje na Windows Server.

• Pokud chcete pomoct zajistit, aby vaše aplikace byla ve službě IIS nastavená, nasazená a spuštěná správně, abyste ji mohli ladit, postupujte podle všech kroků v tomto článku.

Vytvoření aplikace ASP.NET Core na počítači Visual Studio

1. Vytvořte novou ASP.NET Core webovou aplikaci.

   V Visual Studio zvolte Soubor>Okno Start, abyste otevřeli okno Start, a poté zvolte Vytvořit nový projekt. Do vyhledávacího pole zadejte webovou aplikaci, pak jako jazyk zvolte C# a pak zvolte ASP.NET Core Web Application (Model–View-Controller) a pak zvolte Dalši. Na další obrazovce pojmenujte project MyASPApp a pak zvolte Dalši.

   Zvolte doporučenou cílovou architekturu nebo .NET 10 a pak zvolte Create. Verze se musí shodovat s verzí nainstalovanou na serveru.

2. Otevřete soubor HomeController.cs ve složce Controllers a nastavte zarážku v příkazu v metodě .

   Ve starších šablonách otevřete soubor Privacy.cshtml.cs a nastavte zarážku v metodě .

Instalace a konfigurace služby IIS na Windows Serveru

Tyto kroky zobrazují pouze základní konfiguraci služby IIS. Podrobnější informace nebo instalaci na stolní počítač s Windows najdete v tématu Publishing do služby IIS nebo IIS 8.0 pomocí ASP.NET 3.5 a ASP.NET 4.5.

Pro operační systémy Windows Server použijte průvodce Přidat role a funkce prostřednictvím odkazu Manage nebo odkazu Dashboard v Server Manager. Na kroku Role serveru zaškrtněte políčko u Web Server (IIS).

snímek obrazovky znázorňující roli IIS webového serveru vybranou v kroku Vybrat role serveru

(Windows Server 2022) V dialogovém okně, které se zobrazí, zvolte Přidat funkce přidat konzolu pro správu služby IIS.

V kroku Služby rolí vyberte služby role IIS, které chcete, nebo přijměte výchozí služby rolí, které jsou poskytovány. Pokud chcete povolit nasazení pomocí nastavení publikování a nasazení webu, ujistěte se, že jsou vybrané následující funkce:

• skripty a nástroje pro správu služby IIS
• Služba pro správu
• Správce konzoly IIS

Snímek obrazovky zobrazující vybrané skripty a nástroje pro správu služby IIS

Pokračujte postupem potvrzení instalace role a služeb webového serveru. Po instalaci role Webového serveru (IIS) není vyžadováno restartování serveru nebo služby IIS.

Aktualizace nastavení zabezpečení prohlížeče ve Windows Serveru

Pokud používáte starší verzi Windows Serveru, možná budete muset přidat některé domény jako důvěryhodné weby, abyste mohli stáhnout některé součásti webového serveru. Přidejte důvěryhodné weby tak, že přejdete na Možnosti internetu zabezpečení důvěryhodné servery weby. Přidejte následující domény.

• microsoft.com
• go.microsoft.com
• download.microsoft.com
• iis.net

Při stahování softwaru můžete získat žádosti o udělení oprávnění k načtení různých skriptů a prostředků webu. Některé z těchto prostředků se nevyžadují, ale chcete-li proces zjednodušit, vyberte po zobrazení výzvy Přidat.

Instalace ASP.NET Core na Windows Server

1. Nainstalujte sadu hostování .NET Core do hostitelského systému. Balíček nainstaluje .NET Core Runtime, .NET Core Library a ASP.NET Core modul. Podrobnější pokyny najdete v tématu Publikování do služby IIS.

   Pro aktuální sadu hostování .NET Core nainstalujte sadu ASP.NET Core Hosting Bundle.

   Poznámka

   Pokud jste dříve nainstalovali službu IIS, nainstaluje se modul ASP.NET Core IIS s ASP.NET Core. Jinak nainstalujte modul ASP.NET Core IIS ručně.

   Pro .NET Core 2 nainstalujte .NET Core Windows Server Hosting.

   Poznámka

   Pokud systém nemá připojení Inte rnet, před instalací sady .NET Core Windows Server Hosting získejte a nainstalujte Microsoft Visual C++ 2015 Redistributable.

2. Restartujte systém (nebo spusťte net stop was /y následovaný net start w3svc z příkazového řádku, aby se projevila změna v systémové PATH).

Volba možnosti nasazení

Pokud potřebujete pomoc s nasazením aplikace do služby IIS, zvažte tyto možnosti:

• Nasaďte ho vytvořením souboru nastavení publikování ve službě IIS a importem nastavení v Visual Studio. V některých scénářích je to rychlý způsob nasazení aplikace. Při vytváření souboru nastavení publikování se oprávnění automaticky nastaví ve službě IIS.

• Nasaďte publikováním do místní složky a zkopírováním výstupu upřednostňovanou metodou do připravené složky aplikace ve službě IIS.

(Volitelné) Nasazení pomocí souboru nastavení publikování

Tuto možnost můžete použít k vytvoření souboru nastavení publikování a jeho importu do Visual Studio.

Poznámka

Pokud chcete nasazení webu nakonfigurovat ručně místo importu nastavení publikování, musíte se ujistit, že je na serveru nakonfigurovaná složka aplikace se správnými hodnotami a oprávněními (viz Configure ASP.NET Web).

Konfigurace webu ASP.NET Core

1. Ve Správci služby IIS v levém podokně v části Připojenívyberte Fondy aplikací. Otevřete DefaultAppPool a nastavte .NET verzi CLR na No Managed Code. To se vyžaduje pro ASP.NET Core. Výchozí web používá DefaultAppPool.

2. Zastavte a restartujte DefaultAppPool.

Instalace a konfigurace nasazení webu na Windows Serveru

Nasazení webu poskytuje další konfigurační funkce, které umožňují vytvoření souboru nastavení publikování z uživatelského rozhraní.

Poznámka

Instalační program webové platformy dosáhl konce životnosti 1. 7. 2022. Další informace zjistíte v části Web Platform Installer - Konec podpory a ukončení kanálu produktu/aplikace. Web Deploy 4.0 můžete přímo nainstalovat a vytvořit soubor nastavení publikování.

1. Pokud jste ještě nenainstalovali skripty a nástroje pro správu služby IIS, nainstalujte ho teď.

   Přejděte na Vyberte role serveruwebový server (IIS)Nástroje pro správua pak vyberte role Skripty a nástroje pro správu služby IIS, klikněte na Dalšía potom nainstalujte roli.

   instalace skriptů a nástrojů pro správu služby IIS

   Skripty a nástroje jsou potřeba k povolení generování souboru nastavení publikování.

   Nezapomeňte také nainstalovat služby pro správu a konzolu pro správu služby IIS (možná už jsou nainstalované).

2. Ve Windows Serveru stáhněte Web Deploy 4.0.

3. Spusťte instalační program Web Deploy a ujistěte se, že jste místo typické instalace vybrali Kompletní instalaci.

   Po dokončení instalace získáte komponenty, které potřebujete k vygenerování souboru nastavení publikování. (Pokud místo toho zvolíte Vlastní, zobrazí se seznam součástí, jak je znázorněno na následujícím obrázku.)

   snímek obrazovky zobrazující komponenty Nasazení webu 4.0

4. (Volitelné) Ověřte, že je nasazení webu správně spuštěné, otevřete Control Panel > Systém a zabezpečení > Nástroje systému Windows > Services a ujistěte se, že:

   • webový nasazovací agent je spuštěný (název služby se liší ve starších verzích).

   • služba pro správu webu je spuštěná.

   Pokud není spuštěná některá ze služeb agenta, restartujte službu Web Deployment Agent Service.

   Pokud služba agenta nasazení webu vůbec není, přejděte na Control Panel > Programy > Odinstalovat program vyhledejte Microsoft Web Deploy <version>. Zvolte možnost Změnit instalaci a ujistěte se, že vyberete Bude nainstalováno na místní pevný disk pro komponenty Web Deploy. Dokončete kroky instalace změn.

Vytvoření souboru nastavení publikování ve službě IIS na Windows Serveru

1. Zavřete a znovu otevřete konzolu pro správu služby IIS a zobrazte aktualizované možnosti konfigurace v uživatelském rozhraní.

2. Ve službě IIS klikněte pravým tlačítkem myši na Výchozí web, zvolte NasaditKonfigurovat publikování pomocí nástroje Web Deploy.

   Konfigurujte webové nasazení

   Pokud nabídku Deploy nevidíte, podívejte se do předchozí části a ověřte, že je nasazení webu spuštěné.

3. V dialogovém okně Nastavení nasazení webu zkontrolujte nastavení.

4. Klepněte na tlačítko Nastavení.

   V panelu Results se zobrazuje, že přístupová práva jsou udělena zadanému uživateli a že byl vygenerován soubor s příponou .publishsettings v umístění zobrazeném v dialogovém okně.

   <?xml version="1.0" encoding="utf-8"?>
   <publishData>
     <publishProfile
       publishUrl="https://myhostname:8172/msdeploy.axd"
       msdeploySite="Default Web Site"
       destinationAppUrl="http://myhostname:80/"
       profileName="Default Settings"
       publishMethod="MSDeploy"
       userName="myhostname\myusername" />
   </publishData>
   

   V závislosti na konfiguraci Windows Serveru a služby IIS se v souboru XML zobrazí různé hodnoty. Tady je několik podrobností o zobrazených hodnotách:

   • Soubor msdeploy.axd odkazovaný v atributu je dynamicky vygenerovaný soubor obslužné rutiny HTTP pro nasazení webu. (Pro účely testování obecně funguje také.)

   • port je nastavený na port 8172, což je výchozí nastavení pro nasazení webu.

   • Port je nastavený na port 80, což je výchozí hodnota pro službu IIS.

   • Pokud se v pozdějších krocích nemůžete připojit ke vzdálenému hostiteli z Visual Studio pomocí názvu hostitele, otestujte IP adresu serveru místo názvu hostitele.

     Poznámka

     Pokud používáte službu IIS spuštěnou na virtuálním počítači Azure, musíte ve skupině zabezpečení sítě otevřít příchozí porty pro Web Deploy a IIS. Podrobné informace najdete v tématu Otevření portů do virtuálního počítače.

5. Zkopírujte tento soubor do počítače, na kterém používáte Visual Studio.

Import nastavení publikování v Visual Studio a nasazení

1. V počítači, na kterém máte asp.NET project otevřený v Visual Studio, klikněte pravým tlačítkem na project v Solution Explorer a zvolte Publish.

   Pokud jste dříve nakonfigurovali profily publikování, zobrazí se podokno Publikovat . Klikněte na Nový nebo Vytvořit nový profil.

2. Vyberte možnost importu profilu.

   V dialogovém okně Publikovat klepněte na Importovat profil.

   Zvolit publikování

3. Přejděte do umístění souboru nastavení publikování, který jste vytvořili v předchozí části.

4. V dialogovém okně Importovat soubor nastavení publikování najděte a vyberte profil, který jste vytvořili v předchozí části, a klikněte na tlačítko Otevřít.

   Kliknutím na Dokončit uložte profil publikování a potom klikněte na Publikovat.

   Visual Studio zahájí proces nasazení a v okně Výstup se zobrazí průběh a výsledky.

   Pokud dojde k chybám nasazení, klikněte na Další akceUpravit a upravte nastavení. Upravte nastavení a kliknutím na Ověřit otestujte nová nastavení. Pokud se název hostitele nenajde, zkuste IP adresu místo názvu hostitele v polích Adresa URL serveru i cíle .

   Upravit nastavení v nástroji Publikovat

Po úspěšném nasazení by se aplikace měla spustit automaticky.

• Pokud se aplikace po nasazení nespustí, spusťte aplikaci ve službě IIS a ověřte, že běží správně.
• V případě ASP.NET Core se ujistěte, že je pole Fondu aplikací pro DefaultAppPool nastaveno na No Managed Code.

Až budete připraveni, přepněte na mód ladění.

Důležitý

Pokud se rozhodnete ladit konfiguraci vydané verze, zakážete ladění v souboru web.config při publikování.

1. Chcete-li upravit profil, vyberte Další možnostiUpravit a pak vyberte Nastavení.
2. Vyberte Uložit a pak aplikaci znovu publikujte.
3. Vyberte konfiguraci ladění a potom v možnostech Publikování souboru vyberte Odebrat další soubory v cílovém umístění.

Varování

Použití přihlašovacích údajů pro uživatelské jméno a heslo (základní ověřování) není nejbezpečnější metodou ověřování. Kdykoli je to možné, použijte alternativní metody. Zvažte například publikování balíčku z Visual Studio a pak pomocí příkazu WebDeploy.exe z příkazového řádku balíček nasaďte. Pomocí této metody můžete pomocí Správce služby IIS nakonfigurovat autorizované uživatele systému Windows, kteří mohou publikovat na webový server, a spustit WebDeploy.exe v rámci daného uživatelského účtu systému Windows. Viz Instalace a konfigurace nasazení webu ve službě IIS 8.0 nebo novější. Pokud používáte přihlašovací údaje pro heslo, nezapomeňte použít silné heslo a zabezpečit heslo před únikem nebo sdílením hesla.

(Volitelné) Nasazení publikováním do místní složky

Tuto možnost můžete použít k nasazení aplikace, pokud chcete aplikaci zkopírovat do služby IIS pomocí PowerShellu, RoboCopy nebo chcete soubory zkopírovat ručně.

Konfigurace webu ASP.NET Core na počítači s Windows Serverem

1. Otevřete Průzkumníka Windows a vytvořte novou složku C:\Publish, abyste mohli nasadit ASP.NET Core project.

2. Pokud ještě není otevřen, otevřete Správce internetových informačních služeb (IIS). (V levém podokně Server Manager vyberte IS. Klikněte pravým tlačítkem na server a vyberte Správce internetové informační služby (IIS).)

3. V části Připojení v levém podokně přejděte na Stránky.

4. Vyberte Výchozí web, zvolte Základní nastavenía nastavte Fyzickou cestu na C:\Publish.

5. Klikněte pravým tlačítkem myši na uzel výchozího webu a vyberte Přidat aplikaci.

6. Nastavte pole Alias na MyASPApp, přijměte výchozí fond aplikací (DefaultAppPool) a nastavte fyzickou cestu na C:\Publish.

7. V části Připojenívyberte fondy aplikací. Otevřete DefaultAppPool a nastavte pole Fond aplikací na Bez spravovaného kódu.

8. Klikněte pravým tlačítkem myši na nový web ve Správci služby IIS, zvolte Edit Permissions a ujistěte se, že IUSR, IIS_IUSRS nebo uživatel nakonfigurovaný pro přístup k webové aplikaci je autorizovaným uživatelem s právy ke čtení a spouštění.

   Pokud nevidíte jednoho z těchto uživatelů s přístupem, projděte si postup přidání IUSR jako uživatele s právy ke čtení a spuštění.

Důležitý

Informace o zabezpečení související s předdefinovanými účty najdete v tématu Porozumění Built-In uživatelským a skupinovým účtům ve službě IIS 7.

Publikování a nasazení aplikace publikováním do místní složky z Visual Studio

Aplikaci můžete také publikovat a nasadit pomocí systému souborů nebo jiných nástrojů.

1. V Solution Explorer klikněte pravým tlačítkem na uzel project a vyberte Publish (pro webové formuláře, Publish Web App).

   Pokud jste dříve nakonfigurovali profily publikování, zobrazí se podokno Publikovat. Klikněte na Nový profil.

2. V dialogovém okně Publikovat vyberte složku, klikněte na Procházeta vytvořte novou složku C:\Publish.

   

   Kliknutím na Dokončit uložíte publikační profil.

3. Přepněte na konfiguraci ladění.

   Chcete-li upravit profil, zvolte Upravit a pak zvolte Nastavení. Zvolte konfiguraci Debug a potom v možnostech Publikování souborů zvolte Odebrat další soubory v cílovém umístění.

   Snímek obrazovky s kartou Nastavení v dialogovém okně Publikovat. Konfigurace je nastavena na režim Ladění a je stisknuto tlačítko Publikovat.

   Poznámka

   Pokud používáte sestavení vydané verze, zakážete ladění v souboru web.config při publikování.

4. Klikněte na Publikovat.

   Aplikace publikuje konfiguraci Debug project do místní složky. Průběh se zobrazí v okně Výstup.

5. Zkopírujte adresář ASP.NET project z počítače Visual Studio do místního adresáře nakonfigurovaného pro aplikaci ASP.NET (v tomto příkladu C:\Publish) na počítači s Windows Serverem. V tomto kurzu předpokládáme, že kopírujete ručně, ale můžete použít jiné nástroje, jako je PowerShell, Xcopy nebo Robocopy.

   Opatrnost

   Pokud potřebujete provést změny kódu nebo opětovného sestavení, musíte tento krok znovu publikovat a opakovat. Spustitelný soubor, který jste zkopírovali do vzdáleného počítače, musí přesně odpovídat místnímu zdroji a symbolům. Pokud to neuděláte, zobrazí se při pokusu o ladění procesu upozornění cannot find or open the PDB file v Visual Studio.

6. Na Windows Serveru ověřte, že aplikaci můžete správně spustit tak, že ji otevřete v prohlížeči.

   Pokud se aplikace nespustí správně, může dojít k neshodě mezi verzí ASP.NET nainstalovanou na serveru a počítačem Visual Studio nebo může dojít k problému s konfigurací služby IIS nebo webu. Znovu zkontrolujte předchozí kroky.

Stažení a instalace vzdálených nástrojů na Windows Serveru

Stáhněte si verzi vzdálených nástrojů, která odpovídá vaší verzi Visual Studio.

Na vzdáleném zařízení nebo serveru, na které chcete ladit, místo Visual Studio počítače stáhněte a nainstalujte správnou verzi vzdálených nástrojů z odkazů v následující tabulce.

• Stáhněte si nejnovější aktualizaci vzdálených nástrojů pro vaši verzi Visual Studio. Vzdálené nástroje pro Visual Studio 2022 a 2026 je možné použít s některou verzí Visual Studio. Verze vzdálených nástrojů starší než Visual Studio 2022 ale nejsou kompatibilní s novějšími verzemi Visual Studio. (Pokud například používáte Visual Studio 2019, stáhněte si nejnovější aktualizaci vzdálených nástrojů pro Visual Studio 2019. V tomto scénáři nestahujte vzdálené nástroje pro Visual Studio 2022.)

• Stáhněte si vzdálené nástroje se stejnou architekturou jako počítač, na který je instalujete. Pokud například chcete ladit aplikace x86 na vzdáleném počítači s operačním systémem x64, nainstalujte vzdálené nástroje x64. Pokud chcete ladit aplikace x86, ARM nebo x64 v operačním systému ARM64, nainstalujte vzdálené nástroje ARM64.

Verze	Odkaz	Poznámky
Visual Studio 2026	vzdálené nástroje	Kompatibilní s Visual Studio 2022 a novějšími verzemi. Stáhněte si verzi odpovídající operačnímu systému vašeho zařízení (x86, x64 (AMD64) nebo ARM64. Ve starších verzích Windows Serveru se podívejte na Odblokování stahování souboru pro pomoc se stahováním vzdálených nástrojů.
Visual Studio 2022	vzdálené nástroje	Vzdálené nástroje pro Visual Studio 2022 jsou k dispozici v My.VisualStudio.com. Pokud se zobrazí výzva, připojte se k bezplatnému programu Visual Studio Dev Essentials nebo se přihlaste pomocí SVÉHO ID předplatného Visual Studio. Stáhněte si verzi odpovídající operačnímu systému vašeho zařízení (x86, x64 (AMD64) nebo ARM64. Ve starších verzích Windows Serveru se podívejte na Odblokování stahování souboru pro pomoc se stahováním vzdálených nástrojů.
Visual Studio 2019	vzdálené nástroje	Dálkové nástroje pro Visual Studio 2019 jsou k dispozici na My.VisualStudio.com. Pokud se zobrazí výzva, připojte se k bezplatnému programu Visual Studio Dev Essentials nebo se přihlaste pomocí SVÉHO ID předplatného Visual Studio. Stáhněte si verzi odpovídající operačnímu systému vašeho zařízení (x86, x64 (AMD64) nebo ARM64. Ve starších verzích Windows Serveru se podívejte na Odblokování stahování souboru pro pomoc se stahováním vzdálených nástrojů.
Visual Studio 2017	vzdálené nástroje	Vzdálené nástroje pro Visual Studio 2017 jsou k dispozici na My.VisualStudio.com. Pokud se zobrazí výzva, připojte se k bezplatnému programu Visual Studio Dev Essentials nebo se přihlaste pomocí SVÉHO ID předplatného Visual Studio. Stáhněte si verzi odpovídající operačnímu systému vašeho zařízení (x86, x64 (AMD64) nebo ARM64. Na serveru Windows, se podívejte na Odblokujte stahování souboru pro nápovědu ke stažení vzdálených nástrojů.
Visual Studio 2015	vzdálené nástroje	Vzdálené nástroje pro Visual Studio 2015 jsou k dispozici v My.VisualStudio.com. Pokud se zobrazí výzva, připojte se k bezplatnému programu Visual Studio Dev Essentials nebo se přihlaste pomocí SVÉHO ID předplatného Visual Studio. Na serveru Windows, se podívejte na Odblokujte stahování souboru pro nápovědu ke stažení vzdálených nástrojů.
Visual Studio 2013	vzdálené nástroje	Stránka ke stažení v dokumentaci k Visual Studio 2013
Visual Studio 2012	vzdálené nástroje	Stránka ke stažení v dokumentaci k Visual Studio 2012

Vzdálený ladicí program můžete spustit zkopírováním msvsmon.exe do vzdáleného počítače, nikoli instalací vzdálených nástrojů. Průvodce konfigurací vzdáleného ladicího programu (rdbgwiz.exe) je však k dispozici pouze při instalaci vzdálených nástrojů. Pokud chcete spustit vzdálený ladicí program jako službu, možná budete muset použít průvodce pro konfiguraci. Další informace naleznete v tématu (volitelné) Konfigurace vzdáleného ladicího programu jako služby.

Poznámka

• K ladění Windows 10 nebo novějších aplikací na zařízeních ARM použijte ARM64, který je k dispozici s nejnovější verzí vzdálených nástrojů.
• Pokud chcete ladit Windows 10 aplikace na zařízeních Windows RT, použijte ARM, který je k dispozici pouze ve stažení vzdálených nástrojů Visual Studio 2015.
• Pokud chcete ladit aplikace x64 v operačním systému ARM64, spusťte msvsmon.exe x64 nainstalované se vzdálenými nástroji ARM64.

Nastavení vzdáleného ladicího programu na Windows Serveru

1. Na vzdáleném počítači vyhledejte a spusťte vzdáleného ladicího programu z nabídky Start.

   Pokud nemáte oprávnění správce na vzdáleném počítači, klikněte pravým tlačítkem myši na aplikaci vzdáleného ladicího programu a vyberte Spustit jako správce. V opačném případě ho jednoduše zahajte normálně.

   Pokud se chystáte připojit k procesu, který běží jako správce nebo běží pod jiným uživatelským účtem (například IIS), klikněte pravým tlačítkem na aplikaci Remote Debugger a vyberte Spustit jako správce. Další informace viz Spusťte vzdálený debugger jako správce.

2. Při prvním spuštění vzdáleného debuggeru (nebo před jeho nakonfigurováním) se zobrazí průvodce konfigurací vzdáleného debuggeru.

   Ve většině scénářů zvolte Konfigurovat vzdálené ladění.

   Snímek obrazovky konfigurace vzdáleného ladicího programu.Konfigurace vzdáleného ladicího programu

3. Vyberte aspoň jeden typ sítě, na který chcete používat vzdálené nástroje. Pokud jsou počítače připojené přes doménu, musíte zvolit první položku. Pokud jsou počítače připojené přes pracovní skupinu nebo domácí skupinu, podle potřeby zvolte druhou nebo třetí položku.

   Potom vyberte Dokončit a spusťte vzdálený ladicí program.

4. Po dokončení konfigurace se zobrazí okno vzdáleného ladicího programu.

   snímek obrazovky okna vzdáleného ladicího programuokno vzdáleného ladicího programu

   Vzdálený ladicí program teď čeká na připojení. K nastavení konfigurace vzdáleného připojení v Visual Studio použijte název serveru a číslo portu.

Pokud chcete vzdálený ladicí program zastavit, vyberte SouborUkončit. Můžete ho restartovat z nabídky Start nebo z příkazového řádku:

<Remote debugger installation directory>\msvsmon.exe

Poznámka

Pokud potřebujete přidat oprávnění pro další uživatele, změnit režim ověřování nebo číslo portu vzdáleného ladicího programu, přečtěte si téma Konfigurace vzdáleného ladicího programu.

Informace o spuštění vzdáleného ladicího programu jako služby najdete v tématu Spuštění vzdáleného ladicího programu jako služby.

Připojení k aplikaci ASP.NET Core z počítače Visual Studio

Od Visual Studio 2022 verze 17.10 Preview 2 se změnilo dialogové okno Připojit k procesu. Pokud potřebujete pokyny, které odpovídají staršímu dialogovému oknu, přepněte do zobrazení Visual Studio 2019 (selektor verze vlevo nahoře v článku).

1. Na počítači Visual Studio otevřete řešení, které se pokoušíte ladit (MyASPApp pokud postupujete podle všech kroků v tomto článku).

2. V Visual Studio vyberte Debug > Připojit k procesu (Ctrl + Alt + P).

   Spropitné

   V aplikaci Visual Studio 2017 a novějších verzích se můžete znovu připojit ke stejnému procesu, ke kterému jste se dříve připojili, pomocí Debug > Znovu připojit k procesu... (Shift+Alt+P).

3. Nastavte typ připojení na Na dálku (Windows).

   Zobrazí se možnost cíl připojení.

   Nastavte cíl připojení na název vzdáleného počítače a stiskněte klávesu Enter.

   Ověřte, že Visual Studio přidá požadovaný port do názvu počítače, který se zobrazí ve formátu: <vzdálený název počítače>:port

   Ve Visual Studio 2022 by se měl zobrazit název vzdáleného počítače<:4026>

   Port je povinný. Pokud číslo portu nevidíte, přidejte ho ručně.

4. Vyberte Aktualizovat.

   Některé procesy by se měly zobrazit v okně Dostupné procesy.

   Pokud nevidíte žádné procesy, zkuste místo názvu vzdáleného počítače použít IP adresu (port je povinný). K získání adresy IPv4 můžete použít na příkazovém řádku.

   Pokud chcete použít tlačítko Najít, možná budete muset na serveru otevřít odchozí port UDP 3702.

5. Zkontrolujte Zobrazit procesy všech uživatelů.

6. Pokud chcete rychle najít aplikaci, zadejte první písmeno názvu procesu.

   • Pokud používáte model hostování v procesu ve službě IIS, vyberte správný proces w3wp.exe. Počínaje .NET Core 3 je tento proces výchozím nastavením.

   • V opačném případě vyberte proces dotnet.exe. (Jedná se o model hostování mimo proces.)

   Pokud máte více procesů, které zobrazují w3wp.exe nebo dotnet.exe, zkontrolujte sloupec uživatelské jméno. V některých scénářích se ve sloupci uživatelské jméno zobrazuje název fondu aplikací, například IIS APPPOOL\DefaultAppPool. Pokud se zobrazí fond aplikací, ale není jedinečný, vytvořte nový pojmenovaný fond aplikací pro instanci aplikace, kterou chcete ladit, a pak ho snadno najdete ve sloupci uživatelské jméno.

   Snímek obrazovky s dialogovým oknem Připojit k procesu.RemoteDBG_AttachToProcess

7. Vyberte Připojit.

8. Otevřete web vzdáleného počítače. V prohlížeči přejděte na http://název vzdáleného počítače.

   Měla by se zobrazit webová stránka ASP.NET.

9. Ve spuštěné aplikaci ASP.NET vyberte odkaz na stránku Privacy.

   Zarážka by měla být aktivována ve Visual Studiu.

   Pokud se vám nedaří připojit nebo stisknout zarážku, přečtěte si Řešení potíží se vzdáleným laděním.

Řešení potíží s nasazením služby IIS

• Pokud se nemůžete připojit k hostiteli pomocí názvu hostitele, zkuste místo toho IP adresu.
• Ujistěte se, že jsou na vzdáleném serveru otevřené požadované porty.
• V případě ASP.NET Core je nutné zajistit, aby bylo pole Fondu aplikací pro DefaultAppPool nastaveno na Bez spravovaného kódu.
• Ověřte, že verze ASP.NET použitá ve vaší aplikaci je stejná jako verze, kterou jste nainstalovali na server. Pro vaši aplikaci můžete verzi zobrazit a nastavit na stránce Vlastnosti. Pokud chcete aplikaci nastavit na jinou verzi, musí být tato verze nainstalovaná.
• Pokud se aplikace pokusila otevřít, ale zobrazí se upozornění na certifikát, zvolte důvěryhodnost webu. Pokud jste upozornění už zavřeli, můžete upravit profil publikování, soubor *.pubxml v project a přidat následující prvek (pouze pro testování): <AllowUntrustedCertificate>true</AllowUntrustedCertificate>
• Po nasazení spusťte aplikaci ve službě IIS a otestujte, že je správně nasazená.
• V okně Výstup v Visual Studio vyhledejte informace o stavu a zkontrolujte chybové zprávy.

Otevření požadovaných portů na Windows Serveru

Ve většině nastavení jsou požadované porty otevřeny instalací ASP.NET a vzdáleného ladicího programu. Možná ale budete muset ověřit, že jsou otevřené porty.

Poznámka

Na virtuálním počítači Azure musíte otevřít porty prostřednictvím skupiny zabezpečení sítě.

Požadované porty:

• 80: Požadováno pro službu IIS (HTTP).

• 4026: Požadováno pro vzdálené ladění ve Visual Studio 2022 (viz Přiřazení portů pro vzdálené ladění pro více informací).

• UDP 3702: (Volitelné) Detekční port umožňuje použít tlačítko Find při připojování ke vzdálenému ladicímu programu ve Visual Studio.

Kromě toho by už tyto porty měly být otevřeny instalací ASP.NET:

• 8172: (Volitelné) Povinné pro Web Deploy k nasazení aplikace z Visual Studia

Otevření portu

1. Pokud chcete otevřít port v systému Windows Server, otevřete nabídku Start, vyhledejte bránu Windows Defender Firewall nebo bránu Windows Firewall s pokročilým zabezpečením.

   Pro firewall programu Windows Defenderzvolte Upřesnit nastavení.

2. Potom zvolte Příchozí pravidla Nové pravidlo Porta pak vyberte Další. (Pro UDP 3702 zvolte místo toho odchozí pravidla.)

3. V části Konkrétní místní portyzadejte číslo portu a vyberte Další.

4. Vyberte Povolit připojení, vyberte Další.

5. Vyberte jeden nebo více typů sítě, které chcete povolit pro port, a vyberte Další.

   Typ, který vyberete, musí obsahovat síť, ke které je vzdálený počítač připojený.

6. Přidejte název (například IIS, Web Deploynebo msvsmon) pro příchozí pravidlo a vyberte Dokončit.

   Nové pravidlo by se mělo zobrazit v seznamu Příchozí pravidla nebo Odchozí pravidla.

   Pokud chcete další podrobnosti o konfiguraci brány Windows Firewall, přečtěte si téma Konfigurace brány Windows Firewall pro vzdálené ladění.

7. Vytvořte další pravidla pro ostatní požadované porty.