Távoli hibakeresés az ASP.NET Core alkalmazáson az IIS-en egy Azure-beli virtuális gép használatával a Visual Studio segítségével

Ez az útmutató bemutatja, hogyan állíthat be és konfigurálhat Egy Visual Studio ASP.NET Core-alkalmazást, hogyan helyezheti üzembe az IIS-ben egy Azure-beli virtuális gép használatával, és hogyan csatolhatja a távoli hibakeresőt a Visual Studióból.

IIS-forgatókönyvek esetén a Linux nem támogatott.

Az IIS Azure-beli virtuális gépeken való hibakereséséhez kövesse a cikkben ismertetett lépéseket. Ezzel a módszerrel az IIS testre szabott konfigurációját használhatja, de a telepítési és üzembe helyezési lépések bonyolultabbak. Ha nem kell testre szabnia az IIS-t a forgatókönyvéhez, egyszerűbb módszereket is választhat az alkalmazás üzemeltetéséhez és hibakereséséhez Azure App Service-.

Azure-beli virtuális gépek esetén telepítenie kell az alkalmazást a Visual Studióból az Azure-ba, és manuálisan kell telepítenie az IIS-szerepkört és a távoli hibakeresőt is, ahogy az alábbi ábrán látható.

Figyelmeztetés

Mindenképpen törölje a létrehozott Azure-erőforrásokat, amikor elvégezte az oktatóanyag lépéseit. Így elkerülheti a szükségtelen díjak felmerülését.

Ezeket az eljárásokat az alábbi kiszolgálókonfigurációkon teszteltük:

• Windows Server 2022 és IIS 10
• Windows Server 2019 és IIS 10
• Windows Server 2016 és IIS 10

Előfeltételek

A Cikkben ismertetett lépések végrehajtásához a Visual Studio 2019 vagy újabb verzióira van szükség.

Hálózati követelmények

A proxyn keresztül csatlakoztatott két számítógép közötti hibakeresés nem támogatott. A magas késleltetésű vagy alacsony sávszélességű kapcsolaton, például tárcsázós interneten vagy országok/régiók közötti internetkapcsolaton keresztüli hibakeresés nem ajánlott, mivel sikertelen lehet, vagy elfogadhatatlanul lassú. A követelmények teljes listáját a Követelményekcímű témakörben találja.

Az alkalmazás már fut az IIS-ben az Azure-beli virtuális gépen?

Ez a cikk az IIS alapkonfigurációjának windowsos kiszolgálón történő beállításával és az alkalmazás Visual Studióból való üzembe helyezésével kapcsolatos lépéseket tartalmazza. Ezek a lépések biztosítják, hogy a kiszolgáló telepítve legyen a szükséges összetevőkkel, hogy az alkalmazás megfelelően fusson, és készen álljon a távoli hibakeresésre.

• Ha az alkalmazás az IIS-ben fut, és le szeretné tölteni a távoli hibakeresőt a hibakeresés megkezdéséhez, lépjen a Távoli eszközök letöltése és telepítése Windows Serveroldalra.

• Ha segítségre van szüksége annak biztosításához, hogy az alkalmazás megfelelően legyen beállítva, üzembe helyezve és megfelelően futjon az IIS-ben, hogy hibakeresést végezhet, kövesse a jelen cikk összes lépését.

  • Mielőtt hozzákezdene, kövesse Windows rendszerű virtuális gép létrehozásacímű cikkben leírt lépéseket, amelyek tartalmazzák az IIS-webkiszolgáló telepítéséhez szükséges lépéseket.

  • Győződjön meg arról, hogy megnyitja a 80-as portot az Azure Hálózati biztonsági csoport-ben. Ha ellenőrzi, hogy a 80-s port nyitva van-e, nyissa meg a megfelelő portot a távoli hibakeresőhöz (4026, 4024 vagy 4022). Így később nem kell megnyitnia. Ha a Web Deploy szolgáltatást használja, nyissa meg a 8172-s portot is.

A ASP.NET Core-alkalmazás létrehozása a Visual Studio számítógépén

1. Hozzon létre egy új ASP.NET Core-webalkalmazást.

   A Visual Studióban válassza Fájl>Start ablak lehetőséget a Start ablak megnyitásához, majd válassza Új projekt létrehozásalehetőséget. A keresőmezőbe írja be webalkalmazás, majd válassza C# nyelvként, majd válassza ASP.NET Core Web Application (Model-View-Controller), majd válassza a Továbblehetőséget. A következő képernyőn nevezze el a projektet MyASPApp, majd válassza a Továbblehetőséget.

   Válassza ki az ajánlott cél keretrendszert vagy a .NET 8-at, majd válassza a Létrehozáslehetőséget. A verziónak meg kell egyeznie a kiszolgálón telepített verzióval.

2. Nyissa meg a HomeController.cs fájlt a Vezérlők mappában, és állítson be egy töréspontot a return View; utasításban a Privacy metódusban.

   Régebbi sablonokban nyissa meg a Privacy.cshtml.cs fájlt, és állítson be töréspontot a OnGet metódusban.

Böngésző biztonsági beállításainak frissítése a Windows Serveren

Ha a Windows Server régebbi verzióját használja, előfordulhat, hogy megbízható helyként kell hozzáadnia néhány tartományt, hogy lehetővé tegye a webkiszolgáló egyes összetevőinek letöltését. Adja hozzá a megbízható webhelyeket, ha a Internetbeállítások menüpontra lép, majd a > Biztonsági, > Megbízható helyek, > Webhelyek szakasznál folytatja. Adja hozzá a következő tartományokat.

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

A szoftver letöltésekor különböző webhelyszkriptek és -erőforrások betöltésére vonatkozó engedély megadására vonatkozó kérelmeket kaphat. Ezen erőforrások némelyike nem szükséges, de a folyamat leegyszerűsítéséhez válassza a hozzáadása lehetőséget, amikor a rendszer kéri.

A ASP.NET Core telepítése Windows Serveren

1. Telepítse a .NET Core-tárhelycsomagot az üzemeltetési rendszerre. A csomag telepíti a .NET Core-futtatókörnyezetet, a .NET Core-kódtárat és a ASP.NET Core-modult. További részletes útmutatásért lásd: Közzététel az IIS-ben.

   Az aktuális .NET Core-üzemeltetési csomaghoz telepítse a ASP.NET Core Hosting Bundle.

   Jegyzet

   Ha korábban telepítette az IIS-t, a ASP.NET Core IIS-modul a ASP.NET Core-val lesz telepítve. Ellenkező esetben telepítse manuálisan a ASP.NET Core IIS-modult.

   A .NET Core 2 esetén telepítse a .NET Core Windows Server Hosting.

   Jegyzet

   Ha a rendszer nem rendelkezik internetkapcsolattal, a .NET Core Windows Server Hosting csomag telepítése előtt szerezze be és telepítse a Microsoft Visual C++ 2015 Terjeszthető.

2. Indítsa újra a rendszert (vagy hajtsa végre net stop was /y, majd net start w3svc egy parancssorból, hogy felvegye a rendszer PATH módosítását).

Üzembe helyezési lehetőség kiválasztása

Ha segítségre van szüksége az alkalmazás IIS-ben való üzembe helyezéséhez, fontolja meg az alábbi lehetőségeket:

• Üzembe helyezés: hozzon létre egy közzétételi beállításokat tartalmazó fájlt az IIS-ben, és importálja a beállításokat a Visual Studióban. Bizonyos esetekben ez a megközelítés gyors módszer az alkalmazás üzembe helyezésére. A közzétételi beállításfájl létrehozásakor az engedélyek automatikusan be lesznek állítva az IIS-ben.

• Üzembe helyezés egy helyi mappában való közzétételsel és a kimenet egy előnyben részesített módszerrel történő másolásával az IIS előkészített alkalmazásmappájába.

(Nem kötelező) Üzembe helyezés közzétételi beállításfájl használatával

Ezzel a beállítással létrehozhat egy közzétételi beállításfájlt, és importálhatja azt a Visual Studióba.

Jegyzet

Ez az üzembe helyezési módszer a webtelepítést használja, amelyet telepíteni kell a kiszolgálón. Ha a beállítások importálása helyett manuálisan szeretné konfigurálni a Web Deploy szolgáltatást, a Web Deploy 3.6 helyett a Web Deploy 3.6-ot telepítheti a webkiszolgálókhoz. Ha azonban manuálisan konfigurálja a Webes üzembe helyezést, győződjön meg arról, hogy a kiszolgáló egyik alkalmazásmappája a megfelelő értékekkel és engedélyekkel van konfigurálva (lásd: ASP.NET webhely konfigurálása).

A ASP.NET Core-webhely konfigurálása

1. Az IIS Manager bal oldali ablaktábláján, a Kapcsolatokalatt válassza Alkalmazáskészleteklehetőséget. Nyissa meg a DefaultAppPool elemet, és állítsa a .NET CLR verziót a Felügyelet nélküli kódértékre. Ez a ASP.NET Core esetében szükséges. Az alapértelmezett webhely a DefaultAppPoolt használja.

2. Állítsa le és indítsa újra a DefaultAppPoolt.

Webes üzembe helyezés telepítése és konfigurálása Windows Serveren

A Web Deploy további konfigurációs funkciókat biztosít, amelyek lehetővé teszik a közzétételi beállítások fájljának létrehozását a felhasználói felületen.

Jegyzet

A webplatform-telepítő 22.07.12-én elérte az élettartam végét. További információ: Webplatform-telepítő – a támogatás megszűnése és a termék-/alkalmazáscsatorna megszüntetése. A közzétételi beállítások fájljának létrehozásához közvetlenül telepítheti a Web Deploy 4.0-t.

1. Ha még nem telepítette IIS felügyeleti szkripteket és eszközöket, telepítse most.

   Nyissa meg Kiszolgálói szerepkörök kiválasztása>Webkiszolgáló (IIS)>Felügyeleti eszközök, majd válassza ki a IIS felügyeleti szkriptek és eszközök szerepkört, kattintson a Továbbgombra, majd telepítse a szerepkört.

   

   A közzétételi beállítások fájljának létrehozásához szkriptekre és eszközökre van szükség.

   Győződjön meg arról, hogy telepíti a Felügyeleti szolgáltatás és IIS felügyeleti konzol is (lehet, hogy már telepítve vannak).

2. Windows Serveren töltse le a Web Deploy 4.0-t .

3. Futtassa a Web Deploy telepítőprogramot, és győződjön meg arról, hogy egy tipikus telepítés helyett Teljes telepítést választja.

   A teljes telepítéssel lekérheti a közzétételi beállításfájl létrehozásához szükséges összetevőket. (Ha ehelyett Egyéni választ, az összetevők listája látható az alábbi ábrán látható módon.)

   

4. (Nem kötelező) Ellenőrizze, hogy a Web Deploy megfelelően működik-e a Vezérlőpultrendszer > és a Biztonsági > Windows Tools > Services megnyitásával, majd győződjön meg arról, hogy:

   • Web Deployment Agent Service fut (a szolgáltatás neve a régebbi verziókban eltérő).

   • Web Management Service működik.

   Ha az egyik ügynökszolgáltatás nem fut, indítsa újra a Web Deployment Agent Service.

   Ha a Web Deployment Agent szolgáltatás egyáltalán nem található, lépjen Vezérlőpult > Programok > Program eltávolításaelemre, és keresse meg Microsoft Web Deploy <verzió>. Válassza A telepítés módosítása lehetőséget, és győződjön meg arról, hogy a A webtelepítés összetevőinek helyi merevlemezére lesz telepítve. Végezze el a módosítás telepítési lépéseit.

A közzétételi beállítások fájljának létrehozása az IIS-ben Windows Serveren

1. Zárja be és nyissa meg újra az IIS felügyeleti konzolt a frissített konfigurációs beállítások megjelenítéséhez a felhasználói felületen.

2. Az IIS-ben kattintson a jobb gombbal az Alapértelmezett webhelyelemre, válassza a Üzembe helyezés>Webes közzététel konfigurálásalehetőséget.

   konfigurálása

   Ha nem látja a Üzembe helyezés menüt, az előző szakaszban ellenőrizheti, hogy a Web Deploy fut-e.

3. A Webes közzététel beállításainak konfigurálása párbeszédpanelen vizsgálja meg a beállításokat.

4. Kattintson Beállításgombra.

   Az Eredmények panelen a kimenet azt mutatja, hogy a hozzáférési jogosultságok a megadott felhasználónak vannak megadva, és hogy egy fájlkiterjesztéssel rendelkező .publishsettings fájl lett létrehozva a párbeszédpanelen látható helyen.

   <?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>
   

   A Windows Server és az IIS konfigurációjától függően különböző értékek láthatók az XML-fájlban. Íme néhány részlet a megjelenő értékekről:

   • A attribútumban hivatkozott publishUrl fájl egy dinamikusan létrehozott HTTP-kezelőfájl a Web Deploy számára. (Tesztelési célokra általában http://myhostname:8172 is működik.)

   • A publishUrl port a 8172-s portra van állítva, amely a Web Deploy alapértelmezett értéke.

   • A destinationAppUrl port a 80-ra van állítva, ami az IIS alapértelmezett értéke.

   • Ha a későbbi lépésekben nem tud csatlakozni a távoli gazdagéphez a Visual Studióból a gazdagépnév használatával, tesztelje a kiszolgáló IP-címét a gazdagép neve helyett.

     Jegyzet

     Ha Azure-beli virtuális gépen futó IIS-ben tesz közzé, meg kell nyitnia egy bejövő portot a Web Deploy és az IIS számára a Hálózati biztonsági csoportban. További információ: Portok megnyitása virtuális gépeken.

5. Másolja ezt a fájlt arra a számítógépre, amelyen a Visual Studiót futtatja.

A közzétételi beállítások importálása a Visual Studióban és üzembe helyezés

1. Azon a számítógépen, amelyen meg van nyitva a ASP.NET projekt a Visual Studióban, kattintson a jobb gombbal a projektre a Megoldáskezelőben, és válassza a Közzététellehetőséget.

   Ha korábban bármilyen közzétételi profilt konfigurált, megjelenik a Közzététel panel. Kattintson az Új vagy az Új profil létrehozásalehetőségre.

2. Válassza ki a profil importálásának lehetőségét.

   A Közzététel párbeszédpanelen kattintson Profil importálásagombra.

   lehetőséget

3. Keresse meg az előző szakaszban létrehozott közzétételi beállításfájl helyét.

4. A Importálási közzétételi beállítások fájl párbeszédpanelen keresse meg és jelölje ki az előző szakaszban létrehozott profilt, majd kattintson a Megnyitásgombra.

   A közzétételi profil mentéséhez kattintson a Befejezés gombra, majd a Közzétételgombra.

   A Visual Studio megkezdi az üzembe helyezési folyamatot, a Kimenet ablakban pedig az előrehaladás és az eredmények láthatók.

   Ha telepítési hibák merülnek fel, a beállítások szerkesztéséhez kattintson a További műveletek>szerkesztése gombra. Módosítsa a beállításokat, és kattintson a ellenőrzése gombra az új beállítások teszteléséhez. Ha a gazdagép neve nem található, próbálkozzon az IP-címmel a kiszolgáló és a cél URL-mezője helyett.

   

Jegyzet

Ha újraindít egy Azure-beli virtuális gépet, az IP-cím megváltozhat.

Az alkalmazás sikeres üzembe helyezése után automatikusan el kell indulnia.

• Ha az alkalmazás nem indul el az üzembe helyezés után, indítsa el az alkalmazást az IIS-ben, hogy ellenőrizze, hogy megfelelően fut-e.
• Az ASP.NET Core esetében győződjön meg arról, hogy a DefaultAppPool alkalmazáskészlet mezője Nincs felügyelt kód.

Ha elkészült, váltson hibakeresési konfigurációra.

Fontos

Ha a kiadási konfiguráció hibakeresését választja, a közzétételkor letiltja a hibakeresést a web.config fájlban.

1. A profil szerkesztéséhez válassza a További beállítások>, majd a Szerkesztése lehetőséget, végül válassza a Beállításoklehetőséget.
2. Válassza a Mentés lehetőséget, majd tegye közzé újra az alkalmazást.
3. Válasszon egy Hibakeresési konfigurációt, majd válassza a További fájlok eltávolítása a célhelyen lehetőséget a Fájl közzététele beállítások alatt.

Figyelmeztetés

A felhasználónév és a jelszó hitelesítő adatainak használata (alapszintű hitelesítés) nem a legbiztonságosabb hitelesítési módszer. Ha lehetséges, használjon alternatív módszereket. Fontolja meg például a csomagként való közzétételt a Visual Studióból, majd használja a parancssorból a WebDeploy.exe a csomag üzembe helyezéséhez. Ezzel a módszerrel az IIS Manager használatával konfigurálhatja a webkiszolgálón közzétehető jogosult Windows-felhasználókat, és a WebDeploy.exe-t futtathatja azon Windows-felhasználói fiók alatt. Lásd: Webes üzembe helyezés telepítése és konfigurálása az IIS 8.0-s vagy újabb verzióján. Ha jelszó-hitelesítő adatokat használ, ügyeljen arra, hogy erős jelszót használjon, és gondoskodjon arról, hogy a jelszó ne szivárogjon ki vagy ne legyen megosztva.

(Nem kötelező) Üzembe helyezés helyi mappában való közzétételsel

Ezzel a beállítással telepítheti az alkalmazást, ha a PowerShell, a RoboCopy vagy a fájlok manuális másolásával szeretné az alkalmazást az IIS-be másolni.

A ASP.NET Core-webhely konfigurálása a Windows Server számítógépen

Ha közzétételi beállításokat importál, kihagyhatja ezt a szakaszt.

1. Nyissa meg az Internet Information Services (IIS) Felügyeleti konzolt, és menjen a Webhelyekrészhez.

2. Kattintson a jobb gombbal az Alapértelmezett webhely csomópontra, és válassza Alkalmazás hozzáadásalehetőséget.

3. Állítsa a Alias mezőt a MyASPApp értékre, az Alkalmazáskiszolgáló mezőt pedig úgy, hogy Nincs felügyelt kód. A fizikai elérési út értékét állítsa a C:\Publish értékre (ahol később üzembe helyezi az ASP.NET Core projektet).

4. Ha az IIS-kezelőben kijelölt webhelyet választja, válassza az Engedélyek szerkesztéselehetőséget, és győződjön meg arról, hogy az IUSR, IIS_IUSRS vagy az alkalmazáskészlethez konfigurált felhasználó jogosult felhasználó olvasási & végrehajtási jogosultságokkal.

   Ha nem látja a hozzáféréssel rendelkező felhasználók egyikét, végezze el az IUSR felhasználóként való hozzáadását olvasási & végrehajtási jogosultságokkal.

Fontos

A beépített fiókokkal kapcsolatos biztonsági információkért lásd: Built-In Felhasználói és csoportfiókok ismertetése az IIS 7.

(Nem kötelező) Az alkalmazás közzététele és üzembe helyezése helyi mappában való közzétételsel a Visual Studióból

Ha nem a Web Deploy szolgáltatást használja, közzé kell tennie és üzembe kell helyeznie az alkalmazást a fájlrendszerrel vagy más eszközökkel. Első lépésként hozzon létre egy csomagot a fájlrendszer használatával, majd helyezze üzembe manuálisan a csomagot, vagy használjon más eszközöket, például a PowerShellt, a Robocopyt vagy az XCopyt. Ebben a szakaszban feltételezzük, hogy manuálisan másolja a csomagot, ha nem a Web Deploy szolgáltatást használja.

1. A Megoldáskezelőbenkattintson a jobb gombbal a projekt elemére, és válassza a Közzététel lehetőséget (Webes űrlapok esetén a Webalkalmazás közzétételeopciót).

   Ha korábban már konfigurált közzétételi profilokat, megjelenik a Közzététel panel. Kattintson Új profilelemre.

2. A Közzététel párbeszédpanelen válassza a Mappalehetőséget, kattintson a Tallózáselemre, és hozzon létre egy új mappát, C:\Publish.

   

   Kattintson Befejezés gombra a közzétételi profil mentéséhez.

3. Váltson hibakeresési konfigurációra.

   A profil szerkesztéséhez válassza a Szerkesztés lehetőséget, majd válassza a Beállításoklehetőséget. Válasszon egy Hibakeresési konfigurációt, majd válassza További fájlok eltávolítása a célhelyen lehetőséget a Fájl közzététele beállításnál.

   

   Jegyzet

   Kiadási build használata esetén a közzétételkor letiltja a hibakeresést a web.config fájlban.

4. Kattintson Közzétételgombra.

   Az alkalmazás közzéteszi a projekt hibakeresési konfigurációját a helyi mappában. A folyamat a Kimenet ablakban jelenik meg.

5. Másolja a ASP.NET projektkönyvtárat a Visual Studio számítógépről a ASP.NET alkalmazáshoz konfigurált helyi könyvtárba (ebben a példában C:\Publish) a Windows Server-számítógépen. Ebben az oktatóanyagban feltételezzük, hogy manuálisan másol, de más eszközöket is használhat, például a PowerShellt, a Xcopyt vagy a Robocopyt.

   Figyelem

   Ha módosítania kell a kódot vagy átdolgozást kell végeznie, újraközzé kell tennie, és meg kell ismételnie ezt a lépést. A távoli gépre másolt végrehajtható fájlnak pontosan meg kell egyeznie a helyi forrással és szimbólumokkal. Ha ezt nem teszi meg, cannot find or open the PDB file figyelmeztetés jelenik meg a Visual Studióban, amikor megpróbál hibakeresést végezni a folyamaton.

6. A Windows Serveren ellenőrizze, hogy megfelelően tudja-e futtatni az alkalmazást az alkalmazás böngészőben való megnyitásával.

   Ha az alkalmazás nem fut megfelelően, előfordulhat, hogy a kiszolgálón és a Visual Studio-gépen telepített ASP.NET verziója nem egyezik, vagy probléma merülhet fel az IIS vagy a webhely konfigurációjával kapcsolatban. Ellenőrizze újra a korábbi lépéseket.

A távoli eszközök letöltése és telepítése Windows Serveren

Töltse le a Visual Studio verziójának megfelelő távoli eszközök verzióját.

A Visual Studio-gép helyett a hibakeresésre használni kívánt távoli eszközön vagy kiszolgálón töltse le és telepítse a távoli eszközök megfelelő verzióját az alábbi táblázat hivatkozásaiból.

• Töltse le a Visual Studio verziójához tartozó távoli eszközök legújabb frissítését. A Visual Studio 2022 és 2026 távoli eszközei a Visual Studio bármelyik verziójával használhatók. A Visual Studio 2022-nél korábbi távoli eszközök verziói azonban nem kompatibilisek a Visual Studio későbbi verzióival. (Ha például a Visual Studio 2019-et használja, töltse le a Visual Studio 2019 távoli eszközeinek legújabb frissítését. Ebben a forgatókönyvben ne töltse le a Visual Studio 2022 távoli eszközeit.)

• Töltse le a távoli eszközöket ugyanazzal az architektúrával, mint a számítógépre, amelyre telepíti őket. Ha például x64 operációs rendszert futtató távoli számítógépen szeretné hibakeresésre használni az x86-alkalmazásokat, telepítse az x64 távoli eszközöket. Az x86-os, ARM- vagy x64-alkalmazások ARM64 operációs rendszeren való hibakereséséhez telepítse az ARM64 távoli eszközeit.

Verzió	Hivatkozás	Jegyzetek
Visual Studio 2022	Távoli eszközök	Kompatibilis az összes Visual Studio 2022-verzióval. Töltse le az eszköz operációs rendszerének megfelelő verziót (x86, x64 (AMD64) vagy ARM64. A Windows Server régebbi verzióiban a távoli eszközök letöltésével kapcsolatos segítségért tekintse meg a A fájlletöltési tiltásának feloldása című témakört.
Visual Studio 2019	Távoli eszközök	A Visual Studio 2019 távoli eszközei My.VisualStudio.com érhetők el. Ha a rendszer kéri, csatlakozzon az ingyenes Visual Studio Dev Essentials programhoz, vagy jelentkezzen be a Visual Studio-előfizetés azonosítójával. Töltse le az eszköz operációs rendszerének megfelelő verziót (x86, x64 (AMD64) vagy ARM64. A Windows Server régebbi verzióiban a távoli eszközök letöltésével kapcsolatos segítségért tekintse meg a A fájlletöltési tiltásának feloldása című témakört.
Visual Studio 2017	Távoli eszközök	A Visual Studio 2017 távoli eszközei My.VisualStudio.com érhetők el. Ha a rendszer kéri, csatlakozzon az ingyenes Visual Studio Dev Essentials programhoz, vagy jelentkezzen be a Visual Studio-előfizetés azonosítójával. Töltse le az eszköz operációs rendszerének megfelelő verziót (x86, x64 (AMD64) vagy ARM64. Windows Serveren a távoli eszközök letöltésével kapcsolatos segítségért tekintse meg A fájlletöltési tiltásának feloldása című témakört.
Visual Studio 2015	Távoli eszközök	A Visual Studio 2015 távoli eszközei My.VisualStudio.com érhetők el. Ha a rendszer kéri, csatlakozzon az ingyenes Visual Studio Dev Essentials programhoz, vagy jelentkezzen be a Visual Studio-előfizetés azonosítójával. Windows Serveren a távoli eszközök letöltésével kapcsolatos segítségért tekintse meg A fájlletöltési tiltásának feloldása című témakört.
Visual Studio 2013	Távoli eszközök	Oldal letöltése a Visual Studio 2013 dokumentációjában
Visual Studio 2012	Távoli eszközök	Oldal letöltése a Visual Studio 2012 dokumentációjában

A távoli hibakeresőt úgy futtathatja, hogy a távoli eszközök telepítése helyett msvsmon.exe a távoli számítógépre másolja. A Távoli hibakereső konfigurációs varázslója (rdbgwiz.exe) azonban csak a távoli eszközök telepítésekor érhető el. Előfordulhat, hogy a varázslót kell használnia a konfigurációhoz, ha a távoli hibakeresőt szolgáltatásként szeretné futtatni. További információért lásd: (Nem kötelező) A távoli hibakereső konfigurálása szolgáltatásként.

Jegyzet

• A Windows 10-es vagy újabb alkalmazások ARM-eszközökön való hibakereséséhez használja az ARM64-et, amely a távoli eszközök legújabb verziójával érhető el.
• Windows 10-alkalmazások Windows RT-eszközökön való hibakereséséhez használja az ARM-t, amely csak a Visual Studio 2015 távoli eszközeinek letöltésében érhető el.
• Az ARM64 operációs rendszeren futó x64-alkalmazások hibakereséséhez használja azt az x64 msvsmon.exe-t, amely az ARM64 távoli eszközökkel van telepítve.

A távoli hibakereső beállítása Windows Serveren

1. A távoli számítógépen keresse meg és indítsa el a Távoli hibakereső a Start menüből.

   Ha nem rendelkezik rendszergazdai engedélyekkel a távoli számítógépen, kattintson a jobb gombbal a Távoli hibakereső alkalmazásra, és válassza a Futtatás rendszergazdailehetőséget. Ellenkező esetben csak indítsa el a szokásos módon.

   Ha rendszergazdaként futó vagy másik felhasználói fiók (például IIS) alatt futó folyamathoz szeretne csatolni, kattintson a jobb gombbal a Távoli hibakereső alkalmazásra, és válassza a Futtatás rendszergazdakéntlehetőséget. További információért lásd: A távoli hibakereső futtatása rendszergazdai jogosultsággal.

2. A távoli hibakereső első indításakor (vagy a konfigurálás előtt) megjelenik a Távoli hibakeresési konfiguráció varázsló.

   A legtöbb esetben válassza a Következő lehetőséget, amíg el nem éri a varázsló A Windows Tűzfal beállítása oldalát.

   

3. Válasszon ki legalább egy hálózati típust, amelyen a távoli eszközöket használni szeretné. Ha a számítógépek tartományon keresztül csatlakoznak, ki kell választania az első elemet. Ha a számítógépek munkacsoporton vagy otthoni csoporton keresztül csatlakoznak, szükség szerint válassza a második vagy a harmadik elemet.

   Ezután válassza a Befejezés lehetőséget a távoli hibakereső elindításához.

4. Ha a konfiguráció befejeződött, megjelenik a Távoli hibakereső ablak.

   

   A távoli hibakereső most egy kapcsolatra vár. A Távoli kapcsolat konfigurációjának beállításához használja a megjelenített kiszolgálónevet és portszámot a Visual Studióban.

A távoli hibakereső leállításához válassza Fájl>Kilépéslehetőséget. Újraindíthatja a Start menüből vagy a parancssorból:

<Remote debugger installation directory>\msvsmon.exe

Jegyzet

Ha további felhasználók engedélyeit kell hozzáadnia, módosítsa a hitelesítési módot vagy a távoli hibakereső portszámát, olvassa el A távoli hibakereső konfigurálásacímű témakört.

Csatolás a ASP.NET Core-alkalmazáshoz a Visual Studio számítógépről

A Visual Studio 2022 17.10 Preview 2-es verziójától kezdve a Folyamat csatolása párbeszédpanel megváltozott. Ha a régebbi párbeszédpanelnek megfelelő utasításokra van szüksége, váltson a Visual Studio 2019 nézetre (a cikk bal felső verzióválasztója).

1. Nyissa meg a Visual Studio számítógépen a hibakeresésre használt megoldást (MyASPApp, ha a cikkben szereplő összes lépést követi).

2. A Visual Studio alkalmazásban válassza a Hibakeresés > Csatolás folyamathoz (Ctrl + Alt + P) lehetőséget.

   Borravaló

   A Visual Studio 2017 és újabb verzióiban újra csatlakozhat ugyanahhoz a folyamathoz, amelyhez korábban csatlakozott a Hibakeresés > Újra csatlakozás a folyamathoz... (Shift + Alt + P) használatával.

3. Állítsa a csatlakozási típustTávoli (Windows).

   Megjelenik a kapcsolati cél lehetőség.

   Állítsa be a kapcsolati cél<távoli számítógép nevét>, majd nyomja le Enterbillentyűt.

   Ellenőrizze, hogy a Visual Studio hozzáadja-e a szükséges portot a számítógép nevéhez, amely a következő formátumban jelenik meg: <távoli számítógép neve>:p ort

   A Visual Studio 2022-ben <távoli számítógép neve>:4026

   A portra szükség van. Ha nem látja a portszámot, adja hozzá manuálisan.

4. Válassza a Frissítéslehetőséget.

   Néhány folyamatnak meg kell jelennie az Elérhető folyamatok ablakban.

   Ha nem lát folyamatokat, próbálja meg az IP-címet használni a távoli számítógép neve helyett (a port megadása kötelező). Az IPv4-cím lekéréséhez használhatja a ipconfig parancssorban.

   Ha a Keresés gombot szeretné használni, előfordulhat, hogy meg kell nyitnia a 3702- kimenő UDP-portot a kiszolgálón.

5. Ellenőrizze az összes felhasználó folyamatainak megjelenítését .

6. Gépelje be a folyamat neve első betűjét az alkalmazás gyors megtalálásához.

   • Ha a folyamatban lévő üzemeltetési modellt használja az IIS-en, válassza ki a megfelelő w3wp.exe folyamatot. A .NET Core 3-tól kezdődően ez a folyamat az alapértelmezett.

   • Ellenkező esetben válassza ki a dotnet.exe folyamatot. (Ez a folyamaton kívüli üzemeltetési modell.)

   Ha több folyamat is w3wp.exe vagy dotnet.exejelenik meg, ellenőrizze a felhasználónév oszlopot. Bizonyos esetekben a Felhasználónév oszlop az alkalmazáskészlet nevét jeleníti meg, például IIS APPPOOL\DefaultAppPool. Ha megjelenik az alkalmazáskészlet, de nem egyedi, hozzon létre egy új nevű alkalmazáskészletet a hibakeresésre használni kívánt alkalmazáspéldányhoz, majd egyszerűen megtalálhatja a Felhasználónév oszlopban.

   

7. Válassza a(z) lehetőséget, majd csatolja a(z)-et.

8. Nyissa meg a távoli számítógép webhelyét. Nyisson meg egy böngészőt, és lépjen a http://<távoli számítógép nevére>.

   Látnia kellene az ASP.NET weblapot.

9. A futó ASP.NET alkalmazásban válassza a Adatvédelmi lapra mutató hivatkozást.

   A töréspontot a Visual Studióban kell eltalálni.

   Ha nem tud csatlakozni vagy elérni a töréspontot, olvassa el a Távoli hibakeresés elhárításacímű részt.

Az IIS üzembe helyezésének hibaelhárítása

• Ha nem tud csatlakozni a gazdagéphez a gazdagép nevének használatával, próbálkozzon inkább az IP-címmel helyette.
• Győződjön meg arról, hogy a szükséges portok nyitva vannak a távoli kiszolgálón.
• Az ASP.NET Core esetében meg kell győződnie arról, hogy a DefaultAppPool alkalmazáskészlet mezője Nincs felügyelt kódértékre van állítva.
• Ellenőrizze, hogy az alkalmazásban használt ASP.NET verziója megegyezik-e a kiszolgálón telepített verzióval. Az alkalmazáshoz a verziót a Tulajdonságok lapon tekintheti meg és állíthatja be. Az alkalmazás másik verzióra való beállításához telepíteni kell az adott verziót.
• Ha az alkalmazás megpróbált megnyitni, de megjelenik egy tanúsítványra vonatkozó figyelmeztetés, válassza ki, hogy megbízik-e a webhelyen. Ha már bezárta a figyelmeztetést, szerkesztheti a közzétételi profilt, egy *.pubxml fájlt a projektben, és hozzáadhatja a következő elemet (csak teszteléshez): <AllowUntrustedCertificate>true</AllowUntrustedCertificate>
• Az üzembe helyezés után indítsa el az alkalmazást az IIS-ben, hogy tesztelje a helyes üzembe helyezést.
• Ellenőrizze a Visual Studio Kimeneti ablakában az állapotinformációkat, és ellenőrizze a hibaüzeneteket.

A szükséges portok megnyitása a Windows Serveren

A legtöbb beállításban a szükséges portokat a ASP.NET és a távoli hibakereső telepítése nyitja meg. Ha azonban az üzembehelyezési problémákat elhárítja, és az alkalmazást tűzfal mögött üzemelteti, előfordulhat, hogy ellenőriznie kell, hogy a megfelelő portok nyitva vannak-e.

Egy Azure-beli virtuális gépen a következőn keresztül kell megnyitnia a portokat:

• A hálózati biztonsági csoport.
• A tűzfal a Windows Server-en

Szükséges portok:

• 80 – Az IIS-hez szükséges

• 4026 – A Visual Studio 2022 távoli hibakereséséhez szükséges (további információért lásd: Távoli hibakereső portok hozzárendelése).

• UDP 3702 – (Nem kötelező) A Felderítési port lehetővé teszi a Keresés gomb használatát, amikor a Visual Studio távoli hibakeresőjéhez csatlakozik. Ennek kimenő portnak (kimenő szabálynak) kell lennie.

Ezenkívül ezeket a portokat már meg kell nyitnia a ASP.NET Core-telepítésnek:

• 8172 – (Nem kötelező) Szükséges ahhoz, hogy az alkalmazást a Visual Studióból a Web Deploy segítségével üzembe helyezzük