Fejlesztéshez szükséges IIS-támogatás a Visual Studio for ASP.NET Core-ban

Készítette: Sourabh Shirhatti

Ez a cikk a Windows Serveren futó IIS-en futó ASP.NET Core-alkalmazások hibakeresésének Visual Studio-támogatását ismerteti. Ez a témakör végigvezeti a forgatókönyv engedélyezésén és egy projekt beállításán.

Előfeltételek

• Visual Studio for Windows
• ASP.NET és webfejlesztési számítási feladat
• .NET Core platformfüggetlen fejlesztési számítási feladat
• X.509 biztonsági tanúsítvány (HTTPS-támogatáshoz)

IIS engedélyezése

1. A Windowsban lépjen a Vezérlőpult>Programok és szolgáltatások>parancsára>, amelybe- vagy kikapcsolja a Windows-funkciókat (a képernyő bal oldalán).
2. Jelölje be az Internet Information Services jelölőnégyzetet. Kattintson az OK gombra.

Az IIS telepítéséhez szükség lehet a rendszer újraindítására.

Az IIS konfigurálása

Az IIS-nek rendelkeznie kell egy, a következőkkel konfigurált webhelytel:

• Gazdagép neve: Általában az alapértelmezett webhellyel együtt használják a gazdagépnevetlocalhost. Minden érvényes IIS-webhely működik, amely egyedi kiszolgálónévvel rendelkezik.
• Webhelykötés
  • A HTTPS-t igénylő alkalmazásokhoz hozzon létre egy kötést a 443-as porthoz egy tanúsítvánnyal. A rendszer általában az IIS Express fejlesztői tanúsítványt használja, de minden érvényes tanúsítvány működik.
  • HTTP-t használó alkalmazások esetén ellenőrizze, hogy létezik-e kötés a 80-as porthoz, vagy hozzon létre egy kötést a 80-as porthoz egy új webhelyhez.
  • Használjon egyetlen kötést HTTP-hez vagy HTTPS-hez. A HTTP- és HTTPS-portok egyidejű kötése nem támogatott.

A projekt konfigurálása

HTTPS-átirányítás

A HTTPS-t igénylő új projekt esetén jelölje be a HTTPS konfigurálásához szükséges jelölőnégyzetet az új ASP.NET Core webalkalmazás létrehozása ablakban. Ha bejelöli a jelölőnégyzetet, a HTTPS-átirányítás és a HSTS Middleware hozzáadásra kerül az alkalmazáshoz a létrehozáskor.

Https-t igénylő meglévő projekt esetén használja a HTTPS-átirányítást és a HSTS Middleware-t a következőben Startup.Configure: . További információ: HTTPS használatának kényszerítése az ASP.NET Core-ban.

Egy HTTP-t használó projekt esetében az HTTPS-átirányítás és HSTS Middleware nem kerül hozzáadásra az alkalmazáshoz. Nincs szükség alkalmazáskonfigurációra.

IIS-indítási profil

Hozzon létre egy új indítási profilt az IIS fejlesztési támogatásának hozzáadása érdekében.

1. Kattintson a jobb gombbal a projektre a Megoldáskezelőben. Válassza a Tulajdonságokelemet. Nyissa meg a Hibakeresés lapot.

2. Profil esetén válassza az Új gombot. Nevezze el az "IIS" profilt az előugró ablakban. Kattintson az OK gombra a profil létrehozásához.

3. A Launch (Indítás ) beállításnál válassza az IIS elemet a listából.

4. Jelölje be a Böngésző indítása jelölőnégyzetet, és adja meg a végpont URL-címét.

   Ha az alkalmazás https-t igényel, használjon HTTPS-végpontot (https://). HTTP esetén használjon HTTP-végpontothttp://.

   Adja meg ugyanazt a gazdagépnevet és portot, amelyet a korábban megadott IIS-konfiguráció használ, általában localhost.

   Adja meg az alkalmazás nevét az URL-cím végén.

   Például https://localhost/WebApplication1(HTTPS) vagy http://localhost/WebApplication1(HTTP) érvényes végponti URL-címek.

5. A Környezeti változók szakaszban válassza a Hozzáadás gombot. Adjon meg egy környezeti változót, amelynek neveASPNETCORE_ENVIRONMENT és értékeDevelopment.

6. A Webkiszolgáló beállításai területen állítsa az alkalmazás URL-címét a Böngésző indítása végpont URL-címéhez használt értékre.

7. A Visual Studio 2019 vagy újabb verziójában az Üzemeltetési modell beállításnál válassza az Alapértelmezett lehetőséget a projekt által használt üzemeltetési modell használatához. Ha a projekt beállítja a tulajdonságot a <AspNetCoreHostingModel> projektfájlban, a tulajdonság (InProcess vagy OutOfProcess) értékét használja a program. Ha a tulajdonság nem található, a rendszer az alkalmazás alapértelmezett üzemeltetési modelljét használja, amely folyamatban van. Ha az alkalmazáshoz az alkalmazás normál üzemeltetési modelljétől eltérő explicit üzemeltetési modellre van szükség, állítsa be az üzemeltetési modellt az igényeknek megfelelően In Process vagy Out Of Process értékre.

8. Mentse a profilt.

Ha nem használja a Visual Studiót, manuálisan adjon hozzá indítási profilt a Tulajdonságok mappában lévő launchSettings.json fájlhoz. Az alábbi példa a profilt a HTTPS protokoll használatára konfigurálja:

{
  "iisSettings": {
    "windowsAuthentication": false,
    "anonymousAuthentication": true,
    "iis": {
      "applicationUrl": "https://localhost/WebApplication1",
      "sslPort": 0
    }
  },
  "profiles": {
    "IIS": {
      "commandName": "IIS",
      "launchBrowser": true,
      "launchUrl": "https://localhost/WebApplication1",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    }
  }
}

Győződjön meg arról, hogy a applicationUrl és launchUrl végpontok megegyeznek, és ugyanazt a protokollt használják, mint az IIS kötésbeállításai (HTTP vagy HTTPS).

A projekt futtatása

Futtassa a Visual Studiót rendszergazdaként:

• Ellenőrizze, hogy a buildkonfiguráció legördülő listája hibakeresésre van-e beállítva.
• Állítsa a Hibakeresés indítása gombot az IIS-profilra , és válassza ki a gombot az alkalmazás elindításához.

Előfordulhat, hogy a Visual Studio újraindítást kér, ha nem rendszergazdaként fut. Ha a rendszer kéri, indítsa újra a Visual Studiót.

Ha nem megbízható fejlesztési tanúsítványt használ, előfordulhat, hogy a böngészőben kivételt kell létrehoznia a nem megbízható tanúsítványhoz.

Megjegyzés:

A kiadási buildkonfiguráció hibakeresése Just My Code-dal és a fordítóoptimalizálás csökkentett felhasználói élményt eredményez. A töréspontok például nem érik el a pontokat.

További erőforrások

• Ismerkedés az IIS-kezelővel az IIS-ben
• HTTPS kényszerítése a ASP.NET Core-ban