Obsługa usług IIS w czasie opracowywania w programie Visual Studio dla platformy ASP.NET Core

A: Sourabh Shirhatti

W tym artykule opisano Visual Studio debugowania aplikacji ASP.NET Core uruchomionych z usługami IIS na Windows Server. W tym temacie oswączymy się z włączaniem tego scenariusza i konfigurowaniem projektu.

Wymagania wstępne

  • Program Visual Studio dla systemu Windows
  • ASP.NET i tworzenie aplikacji internetowych
  • Międzyplatformowe obciążenie programowe platformy .NET Core
  • Certyfikat zabezpieczeń X.509 (do obsługi protokołu HTTPS)

Włączanie usług IIS

  1. W Windows, przejdź do Panel sterowania programy i funkcje Windows włączać lub wyłączać funkcje (po lewej stronie ekranu).
  2. Zaznacz pole Internet Information Services wyboru. Wybierz przycisk OK.

Instalacja usług IIS może wymagać ponownego uruchomienia systemu.

Konfigurowanie usług IIS

Usługi IIS muszą mieć skonfigurowaną witrynę internetową z następującymi ustawieniami:

  • Nazwa hosta:zazwyczaj domyślna witryna sieci Web jest używana z nazwą hosta . Jednak działa każda prawidłowa witryna sieci Web usług IIS o unikatowej nazwie hosta.
  • Powiązanie witryny
    • W przypadku aplikacji, które wymagają protokołu HTTPS, utwórz powiązanie z portem 443 z certyfikatem. Zazwyczaj używany jest IIS Express dewelopera, ale każdy prawidłowy certyfikat działa.
    • W przypadku aplikacji, które używają protokołu HTTP, potwierdź istnienie powiązania z portem 80 lub utwórz powiązanie z portem 80 dla nowej witryny.
    • Użyj pojedynczego powiązania dla protokołu HTTP lub HTTPS. Jednoczesne powiązanie z portami HTTP i HTTPS nie jest obsługiwane.

Włączanie obsługi usług IIS w czasie projektowania w Visual Studio

  1. Uruchom instalatora Visual Studio instalacji.

  2. Wybierz pozycję Modyfikuj dla Visual Studio, która ma być pomocna w czasie projektowania usług IIS.

  3. W przypadku ASP.NET i tworzenia aplikacji internetowych znajdź i zainstaluj składnik obsługi usług IIS w czasie projektowania.

    Składnik jest wymieniony w sekcji Opcjonalne w obszarze Obsługa usług IIS w czasie projektowania w panelu Szczegóły instalacji po prawej stronie obciążeń. Składnik instaluje moduł ASP.NET Core module, który jest natywnym modułem usług IIS wymaganym do uruchamiania ASP.NET Core z usługami IIS.

Konfigurowanie projektu

Przekierowywanie HTTPS

W przypadku nowego projektu, który wymaga protokołu HTTPS, zaznacz pole wyboru Skonfiguruj dla protokołu HTTPS w oknie ASP.NET Core aplikacji internetowej. Zaznaczenie pola wyboru powoduje dodanie przekierowania HTTPS i oprogramowania pośredniczącego HSTS do aplikacji po jej utworzeniu.

W przypadku istniejącego projektu, który wymaga protokołu HTTPS, użyj przekierowania HTTPS i oprogramowania pośredniczącego HSTS w programie Startup.Configure . Aby uzyskać więcej informacji, zobacz Wymuszanie protokołu HTTPS w ASP.NET Core.

W przypadku projektu, który używa protokołu HTTP, przekierowanie HTTPS i oprogramowanie pośredniczące HSTS nie są dodawane do aplikacji. Konfiguracja aplikacji nie jest wymagana.

Profil uruchamiania usług IIS

Utwórz nowy profil uruchamiania, aby dodać obsługę usług IIS w czasie projektowania:

  1. Kliknij prawym przyciskiem myszy projekt w Eksplorator rozwiązań. Wybierz pozycję Właściwości. Otwórz kartę Debugowanie.

  2. W przypadkuopcji Profil wybierz przycisk Nowy. Nadaj profilowi nazwę "IIS" w oknie podręcznym. Wybierz przycisk OK, aby utworzyć profil.

  3. Dla ustawienia Uruchom wybierz pozycję IIS z listy.

  4. Zaznacz pole wyboru Uruchom przeglądarkę i podaj adres URL punktu końcowego.

    Jeśli aplikacja wymaga protokołu HTTPS, użyj punktu końcowego HTTPS ( https:// ). W przypadku protokołu HTTP użyj punktu końcowego HTTP http:// ().

    Podaj taką samą nazwę hosta i port, jak określona wcześniej konfiguracja usług IIS, zwykle.

    Podaj nazwę aplikacji na końcu adresu URL.

    Na przykład https://localhost/WebApplication1 (HTTPS) lub http://localhost/WebApplication1 (HTTP) są prawidłowymi adresami URL punktów końcowych.

  5. W sekcji Zmienne środowiskowe wybierz przycisk Dodaj. Podaj zmienną środowiskową z wartością Nazwa i wartością .

  6. W obszarze serwer sieci Web Ustawienia adres URL aplikacji na tę samą wartość, która jest używana dla adresu URL punktu końcowego przeglądarki uruchamiania.

  7. Dla ustawienia Model hostingu w programie Visual Studio 2019 lub nowszym wybierz pozycję Domyślne, aby użyć modelu hostingu używanego przez projekt. Jeśli projekt ustawia właściwość w pliku projektu, używana jest wartość <AspNetCoreHostingModel> właściwości ( InProcess lub OutOfProcess ). Jeśli właściwość nie istnieje, zostanie użyty domyślny model hostingu aplikacji, który jest w trakcie przetwarzania. Jeśli aplikacja wymaga jawnego ustawienia modelu hostingu innego niż normalny model hostingu aplikacji, ustaw dla modelu hostingu wartość lub w razie Out Of Process potrzeby.

  8. Zapisz profil.

Jeśli nie używasz Visual Studio, ręcznie dodaj profil uruchamiania do pliku launchSettings.json w folderze Właściwości. Poniższy przykład umożliwia skonfigurowanie profilu do korzystania z protokołu HTTPS:

{
  "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"
      }
    }
  }
}

Upewnij się, że punkty końcowe i są zgodne i używają tego samego protokołu co konfiguracja powiązania usług applicationUrllaunchUrl IIS ( HTTP lub HTTPS).

Uruchamianie projektu

Uruchom Visual Studio jako administrator:

  • Upewnij się, że na liście rozwijanej konfiguracji kompilacji ustawiono wartość Debuguj.
  • Ustaw przycisk Rozpocznij debugowanie na profil usług IIS i wybierz przycisk, aby uruchomić aplikację.

Visual Studio monit o ponowne uruchomienie, jeśli nie jest uruchomiony jako administrator. Jeśli zostanie wyświetlony monit, uruchom ponownie Visual Studio.

Jeśli jest używany niezaufany certyfikat dewelopera, przeglądarka może wymagać utworzenia wyjątku dla niezaufanego certyfikatu.

Uwaga

Debugowanie konfiguracji kompilacji wydania przy Tylko mój kod i optymalizacji kompilatora powoduje obniżenie wydajności. Na przykład punkty przerwania nie są trafione.

Dodatkowe zasoby

W tym artykule opisano Visual Studio debugowania aplikacji ASP.NET Core uruchomionych z usługami IIS na Windows Server. W tym temacie oswączymy się z włączaniem tego scenariusza i konfigurowaniem projektu.

Wymagania wstępne

  • Program Visual Studio dla systemu Windows
  • ASP.NET i tworzenie aplikacji internetowych
  • Międzyplatformowe obciążenie programowe platformy .NET Core
  • Certyfikat zabezpieczeń X.509 (do obsługi protokołu HTTPS)

Włączanie usług IIS

  1. W Windows, przejdź do Panel sterowania programy i funkcje Windows włączać lub wyłączać funkcje (po lewej stronie ekranu).
  2. Zaznacz pole Internet Information Services wyboru. Wybierz przycisk OK.

Instalacja usług IIS może wymagać ponownego uruchomienia systemu.

Konfigurowanie usług IIS

Usługi IIS muszą mieć skonfigurowaną witrynę internetową z następującymi ustawieniami:

  • Nazwa hosta:zazwyczaj domyślna witryna sieci Web jest używana z nazwą hosta . Jednak działa każda prawidłowa witryna sieci Web usług IIS o unikatowej nazwie hosta.
  • Powiązanie witryny
    • W przypadku aplikacji, które wymagają protokołu HTTPS, utwórz powiązanie z portem 443 z certyfikatem. Zazwyczaj używany jest IIS Express dewelopera, ale każdy prawidłowy certyfikat działa.
    • W przypadku aplikacji, które używają protokołu HTTP, potwierdź istnienie powiązania do wpisu 80 lub utwórz powiązanie z portem 80 dla nowej witryny.
    • Użyj pojedynczego powiązania dla protokołu HTTP lub HTTPS. Jednoczesne powiązanie z portami HTTP i HTTPS nie jest obsługiwane.

Włączanie obsługi usług IIS w czasie projektowania w Visual Studio

  1. Uruchom instalatora Visual Studio instalacji.

  2. Wybierz pozycję Modyfikuj dla Visual Studio, która ma być pomocna w czasie projektowania usług IIS.

  3. W przypadku ASP.NET i tworzenia aplikacji internetowych znajdź i zainstaluj składnik obsługi usług IIS w czasie projektowania.

    Składnik jest wymieniony w sekcji Opcjonalne w obszarze Obsługa usług IIS w czasie projektowania w panelu Szczegóły instalacji po prawej stronie obciążeń. Składnik instaluje moduł ASP.NET Core module, który jest natywnym modułem usług IIS wymaganym do uruchamiania ASP.NET Core z usługami IIS.

Konfigurowanie projektu

Przekierowywanie HTTPS

W przypadku nowego projektu, który wymaga protokołu HTTPS, zaznacz pole wyboru Skonfiguruj dla protokołu HTTPS w oknie ASP.NET Core aplikacji internetowej. Zaznaczenie pola wyboru powoduje dodanie przekierowania HTTPS i oprogramowania pośredniczącego HSTS do aplikacji po jej utworzeniu.

W przypadku istniejącego projektu, który wymaga protokołu HTTPS, użyj przekierowania HTTPS i oprogramowania pośredniczącego HSTS w programie Startup.Configure . Aby uzyskać więcej informacji, zobacz Wymuszanie protokołu HTTPS w ASP.NET Core.

W przypadku projektu, który używa protokołu HTTP, przekierowanie HTTPS i oprogramowanie pośredniczące HSTS nie są dodawane do aplikacji. Konfiguracja aplikacji nie jest wymagana.

Profil uruchamiania usług IIS

Utwórz nowy profil uruchamiania, aby dodać obsługę usług IIS w czasie projektowania:

  1. Kliknij prawym przyciskiem myszy projekt w Eksplorator rozwiązań. Wybierz pozycję Właściwości. Otwórz kartę Debugowanie.

  2. W przypadkuopcji Profil wybierz przycisk Nowy. Nadaj profilowi nazwę "IIS" w oknie podręcznym. Wybierz przycisk OK, aby utworzyć profil.

  3. Dla ustawienia Uruchom wybierz pozycję IIS z listy.

  4. Zaznacz pole wyboru Uruchom przeglądarkę i podaj adres URL punktu końcowego.

    Jeśli aplikacja wymaga protokołu HTTPS, użyj punktu końcowego HTTPS ( https:// ). W przypadku protokołu HTTP użyj punktu końcowego HTTP http:// ().

    Podaj taką samą nazwę hosta i port, jak określona wcześniej konfiguracja usług IIS, zwykle.

    Podaj nazwę aplikacji na końcu adresu URL.

    Na przykład https://localhost/WebApplication1 (HTTPS) lub http://localhost/WebApplication1 (HTTP) są prawidłowymi adresami URL punktów końcowych.

  5. W sekcji Zmienne środowiskowe wybierz przycisk Dodaj. Podaj zmienną środowiskową z wartością Nazwa i wartością .

  6. W obszarze serwer sieci Web Ustawienia adres URL aplikacji na tę samą wartość, która jest używana dla adresu URL punktu końcowego przeglądarki uruchamiania.

  7. Dla ustawienia Model hostingu w programie Visual Studio 2019 lub nowszym wybierz pozycję Domyślne, aby użyć modelu hostingu używanego przez projekt. Jeśli projekt ustawia właściwość w pliku projektu, używana jest wartość <AspNetCoreHostingModel> właściwości ( InProcess lub OutOfProcess ). Jeśli właściwość nie istnieje, używany jest domyślny model hostingu aplikacji, który jest poza procesem. Jeśli aplikacja wymaga jawnego ustawienia modelu hostingu innego niż normalny model hostingu aplikacji, ustaw dla modelu hostingu wartość lub w razie Out Of Process potrzeby.

  8. Zapisz profil.

Jeśli nie używasz Visual Studio, ręcznie dodaj profil uruchamiania do pliku launchSettings.json w folderze Właściwości. Poniższy przykład umożliwia skonfigurowanie profilu do korzystania z protokołu HTTPS:

{
  "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"
      }
    }
  }
}

Upewnij się, że punkty końcowe i są zgodne i używają tego samego protokołu co konfiguracja powiązania usług applicationUrllaunchUrl IIS ( HTTP lub HTTPS).

Uruchamianie projektu

Uruchom Visual Studio jako administrator:

  • Upewnij się, że na liście rozwijanej konfiguracji kompilacji ustawiono wartość Debuguj.
  • Ustaw przycisk Rozpocznij debugowanie na profil usług IIS i wybierz przycisk, aby uruchomić aplikację.

Visual Studio monit o ponowne uruchomienie, jeśli nie jest uruchomiony jako administrator. Jeśli zostanie wyświetlony monit, uruchom ponownie Visual Studio.

Jeśli jest używany niezaufany certyfikat dewelopera, przeglądarka może wymagać utworzenia wyjątku dla niezaufanego certyfikatu.

Uwaga

Debugowanie konfiguracji kompilacji wydania przy Tylko mój kod i optymalizacji kompilatora powoduje obniżenie wydajności. Na przykład punkty przerwania nie są trafione.

Dodatkowe zasoby