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

Pokud chcete ladit aplikaci ASP.NET Core 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 ze sady Visual Studio.

Komponenty vzdáleného ladicího programu

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 ze sady Visual Studio. Pokud chcete vzdáleně ladit ASP.NET 4.8, přečtěte si téma Vzdálené ladění ASP.NET na počítači se službou IIS. Službu IIS můžete také nasadit a ladit pomocí Azure. Informace o službě Aplikace Azure naleznete v tématu Vzdálené ladění ASP.NET Core v Azure nebo v případě sady Visual Studio Enterprise použijte snapshot Debugger (vyžaduje se .NET 4.6.1).

Požadavky

K provedení kroků uvedených v tomto článku se vyžaduje Visual Studio 2019 nebo novější verze.

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

Síťové požadavky

Ladění mezi dvěma počítači připojenými přes proxy server se nepodporuje. Ladění s vysokou latencí nebo připojením s nízkou šířkou pásma, jako je například vytáčení internetu nebo přes internet v různých zemích nebo oblastech, se nedoporučuje a může selhat nebo být nepřijatelné. Ú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 ze sady 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 jenom stáhnout vzdálený ladicí program a spustit ladění, přejděte do části Stažení a instalace vzdálených nástrojů 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 se sadou Visual Studio

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

    V sadě Visual Studio zvolte okno Spustit soubor>, abyste otevřeli okno Start, a pak zvolte Vytvořit nový projekt. Do vyhledávacího pole zadejte webovou aplikaci, zvolte jazyk C# , pak zvolte ASP.NET Základní webová aplikace (Model-View-Controller) a pak zvolte Další. Na další obrazovce pojmenujte projekt MyASPApp a pak zvolte Další.

    Zvolte buď doporučenou cílovou architekturu, nebo .NET 8, a pak zvolte Vytvořit. Verze se musí shodovat s verzí nainstalovanou na serveru.

  2. Otevřete soubor HomeController.cs ve složce Kontrolery a nastavte zarážku v return View; příkazu v Privacy metodě.

    Ve starších šablonách otevřete soubor Privacy.cshtml.cs a nastavte zarážku v OnGet 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 naleznete v tématu Publikování do služby IIS nebo IIS 8.0 pomocí ASP.NET 3.5 a ASP.NET 4.5.

V případě operačních systémů Windows Server použijte průvodce Přidat role a funkce prostřednictvím odkazu Spravovat nebo řídicího panelu v Správce serveru. V kroku Role serveru zaškrtněte políčko u možnosti Webový server (služba IIS).

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

(Windows Server 2022) V zobrazeném dialogovém okně zvolte Přidat funkce a přidejte konzolu pro správu služby IIS.

V kroku Služby rolí vyberte služby role IIS, které chcete, nebo přijměte poskytnuté výchozí služby rolí. 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
  • Konzola pro správu služby 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 weby důvěryhodných webů >zabezpečení internetu > >. 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 možnost Přidat .

Instalace ASP.NET Core na Windows Serveru

  1. Nainstalujte v hostitelském systému sadu pro hosting .NET Core. Tato sada nainstaluje modul runtime .NET, knihovnu .NET Core a modul ASP.NET Core. Podrobnější pokyny najdete v tématu Publikování do služby IIS.

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

    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 hostování windows serveru .NET Core.

    Poznámka:

    Pokud systém nemá připojení k internetu, před instalací sady .NET Core Windows Server Hosting získejte a nainstalujte Distribuovatelné součásti Microsoft Visual C++ 2015.

  2. Restartujte systém (nebo spuštění net stop bylo /y následované příkazem net start w3svc z příkazového řádku pro vyzvednutí změny v systémové CESTě).

Výběr 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 sadě 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 sady 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 Konfigurace ASP.NET webu).

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 verzi .NET CLR na Žádný spravovaný kód. 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 22. 7. 22. Další informace najdete v tématu Instalační program webové platformy – ukončení podpory a ukončení kanálu produktu nebo 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 Možnost Vybrat role>serveru Webový server (IIS)>Nástroje pro správu a potom vyberte roli Skripty a nástroje pro správu služby IIS, klepněte na tlačítko 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í.

    Ujistěte se, že jste nainstalovali také službu pro správu a konzolu pro správu služby IIS (možná už jsou nainstalované).

  2. Na Windows Serveru stáhněte web Deploy 4.0.

  3. Spusťte instalační program Nasazení webu a ujistěte se, že jste místo typické instalace vybrali možnost Dokončit instalaci.

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

    Snímek obrazovky s komponentami Nasazení webu 4.0

  4. (Volitelné) Ověřte, že je nasazení webu správně spuštěné, a to tak, že otevřete službu nástroje pro správu >systému a zabezpečení > Ovládací panely > a ujistěte se, že:

    • Služba agenta nasazení webu je spuštěná (název služby se ve starších verzích liší).

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

    Pokud není spuštěná některá ze služeb agenta, restartujte službu agenta nasazení webu.

    Pokud služba agenta nasazení webu vůbec není k dispozici, přejděte na Ovládací panely > Programy > Odinstalovat program, vyhledejte verzi> Microsoft Web Deploy<. Zvolte změnit instalaci a ujistěte se, že jste zvolili Možnost Bude nainstalována na místní pevný disk pro součásti Nasazení webu. 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 na výchozí web a zvolte Nasadit publikování nasazení> webu.

    Konfigurace nasazení webu

    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ě Konfigurovat publikování nasazení webu zkontrolujte nastavení.

  4. Klikněte na možnost Nastavení.

    Na panelu Výsledky výstup ukazuje, že přístupová práva jsou udělena zadanému uživateli a že se vygeneroval 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 publishUrl je dynamicky vygenerovaný soubor obslužné rutiny HTTP pro nasazení webu. (Pro účely http://myhostname:8172 testování obecně funguje také.)

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

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

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

      Poznámka:

      Pokud publikujete 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í port pro nasazení webu a službu IIS. Podrobné informace najdete v tématu Otevření portů pro virtuální počítač.

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

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

  1. Na počítači, na kterém máte otevřený projekt ASP.NET v sadě Visual Studio, klikněte pravým tlačítkem myši na projekt v Průzkumník řešení a zvolte Publikovat.

    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 tlačítko Importovat profil.

    Zvolte Publikovat.

  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í přejděte na profil, který jste vytvořili v předchozí části, a klikněte na Otevřít.

    Chcete-li uložit profil publikování, klepněte na tlačítko Dokončit a klepněte na tlačítko 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 Upravit další akce>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.

    Úprava 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 pole Fondu aplikací pro DefaultAppPool je nastavené na Bez spravovaného kódu.

Až budete připraveni, přepněte na konfiguraci 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žnosti>upravit a pak vyberte Nastavení.
  2. Vyberte Uložit a pak aplikaci znovu publikujte.
  3. Vyberte konfiguraci ladění a pak v možnostech publikování souborů vyberte Odebrat další soubory v cíli.
  1. Chcete-li upravit profil, vyberte Upravit a pak vyberte Nastavení.
  2. Vyberte Uložit a pak aplikaci znovu publikujte.
  3. Vyberte konfiguraci ladění a pak v možnostech publikování souborů vyberte Odebrat další soubory v cíli.

(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, která se použije k nasazení projektu ASP.NET Core.

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

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

  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í web 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 Fondu aplikací na Žádný spravovaný kód.

  8. Klikněte pravým tlačítkem myši na nový web ve Správci služby IIS, zvolte Upravit oprávnění 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 spuš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 číst a spouštět.

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

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

  1. V Průzkumník řešení klikněte pravým tlačítkem na uzel projektu a vyberte Publikovat (pro webové formuláře, publikovat webovou aplikaci).

    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ázet a vytvořte novou složku C:\Publish.

    Snímek obrazovky s dialogovým oknem Vybrat cíl publikování v sadě Visual Studio s vybranou složkou C:\Publish jako cíl publikování

    Kliknutím na tlačítko Dokončit uložíte profil publikování.

    Snímek obrazovky s dialogovým oknem Vybrat cíl publikování v sadě Visual Studio s vybranou složkou C:\Publish jako cíl publikování

    Kliknutím na tlačítko Dokončit uložíte profil publikování.

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

    Zvolte Upravit , chcete-li upravit profil, a pak zvolte Nastavení. Zvolte konfiguraci ladění a potom v části Možnosti publikování souborů zvolte Odebrat další soubory v cíli.

    Snímek obrazovky s kartou Nastavení v dialogovém okně Publikovat Konfigurace je nastavená na Ladit a je vybráno 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 ladění projektu do místní složky. Průběh se zobrazí v okně Výstup.

  5. Zkopírujte adresář projektu ASP.NET z počítače sady 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.

    Upozornění

    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, při pokusu o ladění procesu se v sadě Visual Studio zobrazí cannot find or open the PDB file upozornění.

  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 se sadou 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 sady Visual Studio.

Na vzdáleném zařízení nebo serveru, na který chcete ladit, a ne na počítači se sadou Visual Studio, 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 sady Visual Studio. Starší verze vzdálených nástrojů nejsou kompatibilní s novějšími verzemi sady 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 Notes
Visual Studio 2022 Vzdálené nástroje Kompatibilní se všemi verzemi sady Visual Studio 2022. 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 najdete nápovědu ke stažení vzdálených nástrojů v části Odblokování stahování souboru.
Visual Studio 2019 Vzdálené nástroje Nástroje remote tools for Visual Studio 2019 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í ID předplatného sady 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 najdete nápovědu ke stažení vzdálených nástrojů v části Odblokování stahování souboru.
Visual Studio 2017 Vzdálené nástroje Nástroje remote tools for Visual Studio 2017 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í ID předplatného sady 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 Windows Serveru najdete nápovědu ke stažení vzdálených nástrojů v části Odblokování stahování souboru.
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í ID předplatného sady Visual Studio. Na Windows Serveru najdete nápovědu ke stažení vzdálených nástrojů v části Odblokování stahování souboru.
Visual Studio 2013 Vzdálené nástroje Stránka ke stažení v dokumentaci k sadě Visual Studio 2013
Visual Studio 2012 Vzdálené nástroje Stránka ke stažení v dokumentaci k sadě Visual Studio 2012
Verze Odkaz Notes
Visual Studio 2019 Vzdálené nástroje Kompatibilní se všemi verzemi sady Visual Studio 2019. Stáhněte si verzi odpovídající operačnímu systému vašeho zařízení (x86, x64 (AMD64) nebo ARM64. Na Windows Serveru najdete nápovědu ke stažení vzdálených nástrojů v části Odblokování stahování souboru. Nejnovější verzi vzdálených nástrojů otevřete v sadě Visual Studio 2022.
Visual Studio 2017 Vzdálené nástroje Kompatibilní se všemi verzemi sady Visual Studio 2017. Stáhněte si verzi odpovídající operačnímu systému vašeho zařízení (x86, x64 (AMD64) nebo ARM64. Na Windows Serveru najdete nápovědu ke stažení vzdálených nástrojů v části Odblokování stahování souboru.
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í ID předplatného sady Visual Studio. Na Windows Serveru najdete nápovědu ke stažení vzdálených nástrojů v části Odblokování stahování souboru.
Visual Studio 2013 Vzdálené nástroje Stránka ke stažení v dokumentaci k sadě Visual Studio 2013
Visual Studio 2012 Vzdálené nástroje Stránka ke stažení v dokumentaci k sadě Visual Studio 2012

Vzdálený ladicí program můžete spustit zkopírováním msvsmon.exe do vzdáleného počítače místo instalace 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 najdete v tématu (Volitelné) Konfigurace vzdáleného ladicího programu jako služby.

Poznámka:

  • Pokud chcete ladit aplikace pro Windows 10 nebo novější na zařízeních ARM, použijte ARM64, který je k dispozici s nejnovější verzí vzdálených nástrojů.
  • Pokud chcete ladit aplikace pro Windows 10 na zařízeních s Windows RT, použijte ARM, který je dostupný jenom ve stažení vzdálených nástrojů sady Visual Studio 2015.
  • Pokud chcete ladit aplikace x64 v operačním systému ARM64, spusťte msvsmon.exe x64, který je 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ý ladicí program 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 na aplikaci Vzdálený ladicí program 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 Vzdáleného ladicího programu a vyberte Spustit jako správce. Další informace naleznete v tématu Spuštění vzdáleného ladicího programu jako správce.

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

    Ve většině scénářů zvolte Další , dokud se nedostanete na stránku Konfigurovat bránu Windows Firewall v průvodci.

    Snímek obrazovky s konfigurací vzdáleného ladicího programu

    Snímek obrazovky s konfigurací vzdáleného ladicího programu

    Pokud není nainstalované rozhraní API webových služeb systému Windows, ke kterému dochází pouze v systému Windows Server 2008 R2, vyberte tlačítko Instalovat .

  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.

    Dále vyberte Konfigurovat vzdálené ladění a spusťte vzdálený ladicí program.

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

    Snímek obrazovky s oknem vzdáleného ladicího programu

    Snímek obrazovky s oknem vzdáleného ladicího programu

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

Pokud chcete vzdálený ladicí program zastavit, vyberte Ukončit soubor>. 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ěňte 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 naleznete 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 sady Visual Studio

Počínaje sadou 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í sady Visual Studio 2019 (selektor verze vlevo nahoře v článku).

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

  2. V sadě Visual Studio vyberte Připojit k procesu ladění > (Ctrl + Alt + P).

    Tip

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

  3. Nastavte typ připojení na vzdálený (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 Enter.

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

    V sadě 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ě.

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

  2. V sadě Visual Studio vyberte Připojit k procesu ladění > (Ctrl + Alt + P).

    Tip

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

  3. Nastavte pole kvalifikátoru na <název> vzdáleného počítače a stiskněte Enter.

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

    V sadě Visual Studio 2019 by se měl zobrazit <název> vzdáleného počítače:4024

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

  1. Vyberte Aktualizovat.

    V okně Dostupné procesy by se měly zobrazit některé procesy.

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

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

  2. Zkontrolujte procesy show od všech uživatelů.

  3. 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ý w3wp.exe proces. 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

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

  4. Vyberte možnost Připojit.

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

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

  6. Ve spuštěné ASP.NET aplikaci vyberte odkaz na stránku Ochrana osobních údajů .

    Zarážka by měla být v sadě Visual Studio nalezena.

    Pokud se vám nedaří připojit nebo stisknout zarážku, přečtěte si téma Ř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 potřeba zajistit, aby pole Fondu aplikací pro Fond výchozích aplikací bylo nastaveno na Bez spravovaného kódu.
  • Ověřte, že verze ASP.NET použitá v aplikaci je stejná jako verze, kterou jste nainstalovali na server. Pro aplikaci můžete zobrazit a nastavit verzi 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 projektu 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 sadě 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í ze sady Visual Studio 2022 (další informace najdete v tématu Přiřazení portů vzdáleného ladicího programu).
  • 4024: Požadováno pro vzdálené ladění ze sady Visual Studio 2019 (další informace najdete v tématu Přiřazení portů vzdáleného ladicího programu).
  • UDP 3702: (Volitelné) Port zjišťování umožňuje použít tlačítko Najít při připojování ke vzdálenému ladicím programu v sadě Visual Studio.

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

  • 8172: (Volitelné) Povinné pro nasazení webu k nasazení aplikace ze sady Visual Studio

Otevření portu

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

    Pro bránu firewall v programu Windows Defender zvolte Upřesnit nastavení.

  2. Pak zvolte Příchozí pravidla > Nový port pravidla > a pak vyberte Další. (Pro UDP 3702 zvolte Místo toho pravidla odchozích přenosů .)

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

  4. Vyberte Povolit připojení a 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, Nasazení webu nebo 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.