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

A : Sourabh Shirhabh

W tym artykule opisano Visual Studio debugowania aplikacji ASP.NET Core z usługami IIS na Windows Server. W tym temacie odszedł proces włączania tego scenariusza i konfigurowania projektu.

Wymagania wstępne

  • Program Visual Studio dla systemu Windows
  • ASP.NET i tworzenie aplikacji internetowych
  • Obciążenie programowe dla wielu platform na platformie .NET Core
  • Certyfikat zabezpieczeń X.509 (do obsługi protokołu HTTPS)

Włączanie usług IIS

  1. W Windows przejdź > do Panel sterowania ProgramyProgramy>> i funkcjeWróć funkcje Windows . lub wył. (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ą hostalocalhost. Jednak działa każda prawidłowa witryna internetowa usług IIS z unikatową nazwą hosta.
  • Powiązanie witryny
    • W przypadku aplikacji, które wymagają protokołu HTTPS, utwórz powiązanie z portem 443 przy użyciu certyfikatu. Zazwyczaj używany jest IIS Express Deweloper, 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 instalatora.

  2. Wybierz pozycję Modyfikuj Visual Studio instalacji, która ma być 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 wymagającego 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. Nie jest wymagana żadna konfiguracja aplikacji.

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 menu Profil wybierz przycisk Nowy. Nadaj profilowi nazwę "IIS" w oknie podręcznym. Wybierz przycisk OK , aby utworzyć profil.

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

  4. Zaznacz pole wyboru Launch browser (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, zazwyczaj localhost.

    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 środowiskowewybierz przycisk Dodaj . Podaj zmienną środowiskową z wartością NazwaASPNETCORE_ENVIRONMENT i wartością .Development

  6. W obszarze serwer Ustawienia ustaw 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ść <AspNetCoreHostingModel> w pliku projektu, używana jest wartość 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 w trakcie przetwarzania. Jeśli aplikacja wymaga jawnego ustawienia modelu hostingu innego niż normalny model hostingu aplikacji, ustaw model hostinguIn Process na wartość lub Out Of Process w razie 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 applicationUrl punkty końcowe i launchUrl są zgodne i używają tego samego protokołu co konfiguracja powiązania usług IIS ( HTTP lub HTTPS).

Uruchamianie projektu

Uruchom Visual Studio jako administrator:

  • Upewnij się, że lista rozwijana konfiguracji kompilacji jest ustawiona na debugowanie.
  • 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 z usługami IIS na Windows Server. W tym temacie odszedł proces włączania tego scenariusza i konfigurowania projektu.

Wymagania wstępne

  • Program Visual Studio dla systemu Windows
  • ASP.NET i tworzenie aplikacji internetowych
  • Obciążenie programowe dla wielu platform na platformie .NET Core
  • Certyfikat zabezpieczeń X.509 (do obsługi protokołu HTTPS)

Włączanie usług IIS

  1. W Windows przejdź > do Panel sterowania ProgramyProgramy>> i funkcjeWróć funkcje Windows . lub wył. (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ą hostalocalhost. Jednak działa każda prawidłowa witryna internetowa usług IIS z unikatową nazwą hosta.
  • Powiązanie witryny
    • W przypadku aplikacji, które wymagają protokołu HTTPS, utwórz powiązanie z portem 443 przy użyciu certyfikatu. Zazwyczaj używany jest IIS Express Deweloper, 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 instalatora.

  2. Wybierz pozycję Modyfikuj Visual Studio instalacji, która ma być 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 wymagającego 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. Nie jest wymagana żadna konfiguracja aplikacji.

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 menu Profil wybierz przycisk Nowy. Nadaj profilowi nazwę "IIS" w oknie podręcznym. Wybierz przycisk OK , aby utworzyć profil.

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

  4. Zaznacz pole wyboru Launch browser (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, zazwyczaj localhost.

    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 środowiskowewybierz przycisk Dodaj . Podaj zmienną środowiskową z wartością NazwaASPNETCORE_ENVIRONMENT i wartością .Development

  6. W obszarze serwer Ustawienia ustaw 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ść <AspNetCoreHostingModel> w pliku projektu, używana jest wartość 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 model hostinguIn Process na wartość lub Out Of Process w razie 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 applicationUrl punkty końcowe i launchUrl są zgodne i używają tego samego protokołu co konfiguracja powiązania usług IIS ( HTTP lub HTTPS).

Uruchamianie projektu

Uruchom Visual Studio jako administrator:

  • Upewnij się, że lista rozwijana konfiguracji kompilacji jest ustawiona na debugowanie.
  • 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