다음을 통해 공유


ASP.NET Core용 Visual Studio의 개발 시간 IIS 지원

참고 항목

이 문서의 최신 버전은 아닙니다. 현재 릴리스는 이 문서의 .NET 8 버전을 참조 하세요.

Warning

이 버전의 ASP.NET Core는 더 이상 지원되지 않습니다. 자세한 내용은 .NET 및 .NET Core 지원 정책을 참조 하세요. 현재 릴리스는 이 문서의 .NET 8 버전을 참조 하세요.

Important

이 정보는 상업적으로 출시되기 전에 실질적으로 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적, 또는 묵시적인 보증을 하지 않습니다.

현재 릴리스는 이 문서의 .NET 8 버전을 참조 하세요.

작성자: Sourabh Shirhatti

이 문서에서는 Windows Server에서 IIS를 통해 실행되는 ASP.NET Core 앱을 디버그하기 위한 Visual Studio 지원에 대해 설명합니다. 이 항목에서는 이 시나리오를 사용하도록 설정하고 프로젝트를 설정하는 방법을 안내합니다.

필수 조건

  • Windows용 Visual Studio
  • ASP.NET 및 웹 개발 워크로드
  • .NET Core 플랫폼 간 개발 워크로드
  • X.509 보안 인증서(HTTPS 지원용)

IIS 활성화

  1. Windows에서는 제어판>프로그램>프로그램 및 기능>Windows 기능 Windows 기능 사용/사용 안 함(화면 왼쪽)으로 차례로 이동합니다.
  2. 인터넷 정보 서비스 확인란을 선택합니다. 확인을 선택합니다.

IIS를 설치하려면 시스템을 다시 시작해야 할 수 있습니다.

IIS 구성

IIS에서 웹 사이트는 다음과 같이 구성되어야 합니다.

  • 호스트 이름: 일반적으로 기본 웹 사이트localhost호스트 이름과 함께 사용됩니다. 그러나 고유한 호스트 이름이 있는 모든 유효한 IIS 웹 사이트가 작동합니다.
  • 사이트 바인딩
    • HTTPS가 필요한 앱의 경우 인증서를 사용하여 포트 443에 대한 바인딩을 만듭니다. 일반적으로 IIS Express 개발 인증서가 사용되지만 모든 유효한 인증서가 작동합니다.
    • HTTP를 사용하는 앱의 경우 포트 80에 대한 바인딩이 있는지 확인하거나 새 사이트에 대해 포트 80에 대한 바인딩을 만듭니다.
    • HTTP 또는 HTTPS에 단일 바인딩을 사용합니다. HTTP 및 HTTPS 포트에 대한 바인딩은 동시에 지원되지 않습니다.

Visual Studio에서 개발 시간 IIS 지원 사용

  1. Visual Studio 설치 관리자를 시작합니다.

  2. IIS 개발 시 지원에 사용할 Visual Studio 설치에 대해 수정을 선택합니다.

  3. ASP.NET 및 웹 개발 워크로드의 경우 개발 시 IIS 지원 구성 요소를 찾고 설치합니다.

    구성 요소는 워크로드 오른쪽 설치 세부 정보 패널의 개발 시 IIS 지원 아래 선택 사항 섹션에 나열됩니다. 이 구성 요소는 IIS를 사용하여 ASP.NET Core 앱을 실행하는 데 필요한 네이티브 IIS 모듈인 ASP.NET Core 모듈을 설치합니다.

프로젝트 구성

HTTPS 리디렉션

HTTPS가 필요한 새 프로젝트의 경우 새 ASP.NET Core 웹 애플리케이션 만들기 창에서 HTTPS에 대한 구성 확인란을 선택합니다. 확인란을 선택하면 HTTPS 리디렉션 및 HSTS 미들웨어가 생성될 때 앱에 추가됩니다.

HTTPS가 필요한 기존 프로젝트의 경우 Startup.Configure에서 HTTPS 리디렉션 및 HSTS Middleware를 사용합니다. 자세한 내용은 ASP.NET Core에서 HTTPS 적용을 참조하세요.

HTTP를 사용하는 프로젝트의 경우 HTTPS 리디렉션 및 HSTS 미들웨어가 앱에 추가되지 않습니다. 앱 구성이 필요하지 않습니다.

IIS 시작 프로필

새 시작 프로필을 만들어 개발 시간 IIS 지원을 추가합니다.

  1. 솔루션 탐색기에서 프로젝트를 마우스 오른쪽 단추로 클릭합니다. 속성을 선택합니다. 디버그 탭을 엽니다.

  2. 프로필의 경우 새로 만들기 단추를 선택합니다. 팝업 창에서 프로필 이름을 “IIS”로 지정합니다. 확인을 선택하여 프로필을 만듭니다.

  3. 시작 설정의 경우 목록에서 IIS를 선택합니다.

  4. 브라우저 시작 확인란을 선택하고 엔드포인트 URL을 제공합니다.

    앱에 HTTPS가 필요한 경우 HTTPS 엔드포인트(https://)를 사용합니다. HTTP의 경우 HTTP(http://) 엔드포인트를 사용합니다.

    이전에 지정된 IIS 구성에서 사용하는 동일한 호스트 이름 및 포트를 제공합니다(일반적으로 localhost).

    URL의 끝에 있는 앱 이름을 제공합니다.

    예를 들어 https://localhost/WebApplication1(HTTPS) 또는 http://localhost/WebApplication1(HTTP)은 유효한 엔드포인트 URL입니다.

  5. 환경 변수 섹션에서 추가 단추를 선택합니다. 이름ASPNETCORE_ENVIRONMENTDevelopment를 사용하여 환경 변수를 제공합니다.

  6. 웹 서버 설정 영역에서 앱 URL브라우저 시작 엔드포인트 URL에 사용된 동일한 값으로 설정합니다.

  7. Visual Studio 2019 이상에 있는 호스팅 모델 설정의 경우 기본값을 선택하여 프로젝트에서 사용되는 호스팅 모델을 사용합니다. 프로젝트가 프로젝트 파일에서 <AspNetCoreHostingModel> 속성을 설정하면 해당 속성 값(InProcess 또는 OutOfProcess)이 사용됩니다. 속성이 없으면 앱의 기본 호스팅 모델인 in-process가 사용됩니다. 앱의 일반 호스팅 모델과 다른 명시적 호스팅 모델 설정이 앱에 필요한 경우에는 필요에 따라 호스팅 모델In Process 또는 Out Of Process로 설정합니다.

  8. 프로필을 저장합니다.

Visual Studio를 사용하지 않는 경우에는 속성 폴더의 launchSettings.json 파일에 시작 프로필을 수동으로 추가합니다. 다음 예제에서는 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"
      }
    }
  }
}

applicationUrllaunchUrl 엔드포인트가 일치하고 IIS 바인딩 구성과 동일한 프로토콜(HTTP 또는 HTTPS)을 사용하는지 확인합니다.

프로젝트 실행

관리자 권한으로 Visual Studio를 실행합니다.

  • 빌드 구성 드롭다운 목록이 디버그로 설정되었는지 확인합니다.
  • 디버깅 시작 단추IIS 프로필로 설정하고 단추를 선택하여 앱을 시작합니다.

관리자로 실행하고 있지 않으면 Visual Studio에서 다시 시작하라는 메시지가 표시될 수 있습니다. 메시지가 표시되면 Visual Studio를 다시 시작합니다.

신뢰할 수 없는 개발 인증서를 사용하는 경우 브라우저에서 신뢰할 수 없는 인증서에 대한 예외를 만들어야 할 수 있습니다.

참고 항목

내 코드만 및 컴파일러 최적화를 사용하여 릴리스 빌드 구성을 디버그하면 성능이 저하됩니다. 예를 들어 중단점이 적중되지 않습니다.

추가 리소스

이 문서에서는 Windows Server에서 IIS를 통해 실행되는 ASP.NET Core 앱을 디버그하기 위한 Visual Studio 지원에 대해 설명합니다. 이 항목에서는 이 시나리오를 사용하도록 설정하고 프로젝트를 설정하는 방법을 안내합니다.

필수 조건

  • Windows용 Visual Studio
  • ASP.NET 및 웹 개발 워크로드
  • .NET Core 플랫폼 간 개발 워크로드
  • X.509 보안 인증서(HTTPS 지원용)

IIS 활성화

  1. Windows에서는 제어판>프로그램>프로그램 및 기능>Windows 기능 Windows 기능 사용/사용 안 함(화면 왼쪽)으로 차례로 이동합니다.
  2. 인터넷 정보 서비스 확인란을 선택합니다. 확인을 선택합니다.

IIS를 설치하려면 시스템을 다시 시작해야 할 수 있습니다.

IIS 구성

IIS에서 웹 사이트는 다음과 같이 구성되어야 합니다.

  • 호스트 이름: 일반적으로 기본 웹 사이트localhost호스트 이름과 함께 사용됩니다. 그러나 고유한 호스트 이름이 있는 모든 유효한 IIS 웹 사이트가 작동합니다.
  • 사이트 바인딩
    • HTTPS가 필요한 앱의 경우 인증서를 사용하여 포트 443에 대한 바인딩을 만듭니다. 일반적으로 IIS Express 개발 인증서가 사용되지만 모든 유효한 인증서가 작동합니다.
    • HTTP를 사용하는 앱의 경우 포트 80에 대한 바인딩이 있는지 확인하거나 새 사이트에 대해 포트 80에 대한 바인딩을 만듭니다.
    • HTTP 또는 HTTPS에 단일 바인딩을 사용합니다. HTTP 및 HTTPS 포트에 대한 바인딩은 동시에 지원되지 않습니다.

Visual Studio에서 개발 시간 IIS 지원 사용

  1. Visual Studio 설치 관리자를 시작합니다.

  2. IIS 개발 시 지원에 사용할 Visual Studio 설치에 대해 수정을 선택합니다.

  3. ASP.NET 및 웹 개발 워크로드의 경우 개발 시 IIS 지원 구성 요소를 찾고 설치합니다.

    구성 요소는 워크로드 오른쪽 설치 세부 정보 패널의 개발 시 IIS 지원 아래 선택 사항 섹션에 나열됩니다. 이 구성 요소는 IIS를 사용하여 ASP.NET Core 앱을 실행하는 데 필요한 네이티브 IIS 모듈인 ASP.NET Core 모듈을 설치합니다.

프로젝트 구성

HTTPS 리디렉션

HTTPS가 필요한 새 프로젝트의 경우 새 ASP.NET Core 웹 애플리케이션 만들기 창에서 HTTPS에 대한 구성 확인란을 선택합니다. 확인란을 선택하면 HTTPS 리디렉션 및 HSTS 미들웨어가 생성될 때 앱에 추가됩니다.

HTTPS가 필요한 기존 프로젝트의 경우 Startup.Configure에서 HTTPS 리디렉션 및 HSTS Middleware를 사용합니다. 자세한 내용은 ASP.NET Core에서 HTTPS 적용을 참조하세요.

HTTP를 사용하는 프로젝트의 경우 HTTPS 리디렉션 및 HSTS 미들웨어가 앱에 추가되지 않습니다. 앱 구성이 필요하지 않습니다.

IIS 시작 프로필

새 시작 프로필을 만들어 개발 시간 IIS 지원을 추가합니다.

  1. 솔루션 탐색기에서 프로젝트를 마우스 오른쪽 단추로 클릭합니다. 속성을 선택합니다. 디버그 탭을 엽니다.

  2. 프로필의 경우 새로 만들기 단추를 선택합니다. 팝업 창에서 프로필 이름을 “IIS”로 지정합니다. 확인을 선택하여 프로필을 만듭니다.

  3. 시작 설정의 경우 목록에서 IIS를 선택합니다.

  4. 브라우저 시작 확인란을 선택하고 엔드포인트 URL을 제공합니다.

    앱에 HTTPS가 필요한 경우 HTTPS 엔드포인트(https://)를 사용합니다. HTTP의 경우 HTTP(http://) 엔드포인트를 사용합니다.

    이전에 지정된 IIS 구성에서 사용하는 동일한 호스트 이름 및 포트를 제공합니다(일반적으로 localhost).

    URL의 끝에 있는 앱 이름을 제공합니다.

    예를 들어 https://localhost/WebApplication1(HTTPS) 또는 http://localhost/WebApplication1(HTTP)은 유효한 엔드포인트 URL입니다.

  5. 환경 변수 섹션에서 추가 단추를 선택합니다. 이름ASPNETCORE_ENVIRONMENTDevelopment를 사용하여 환경 변수를 제공합니다.

  6. 웹 서버 설정 영역에서 앱 URL브라우저 시작 엔드포인트 URL에 사용된 동일한 값으로 설정합니다.

  7. Visual Studio 2019 이상에 있는 호스팅 모델 설정의 경우 기본값을 선택하여 프로젝트에서 사용되는 호스팅 모델을 사용합니다. 프로젝트가 프로젝트 파일에서 <AspNetCoreHostingModel> 속성을 설정하면 해당 속성 값(InProcess 또는 OutOfProcess)이 사용됩니다. 속성이 없으면 앱의 기본 호스팅 모델인 out-of-process가 사용됩니다. 앱의 일반 호스팅 모델과 다른 명시적 호스팅 모델 설정이 앱에 필요한 경우에는 필요에 따라 호스팅 모델In Process 또는 Out Of Process로 설정합니다.

  8. 프로필을 저장합니다.

Visual Studio를 사용하지 않는 경우에는 속성 폴더의 launchSettings.json 파일에 시작 프로필을 수동으로 추가합니다. 다음 예제에서는 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"
      }
    }
  }
}

applicationUrllaunchUrl 엔드포인트가 일치하고 IIS 바인딩 구성과 동일한 프로토콜(HTTP 또는 HTTPS)을 사용하는지 확인합니다.

프로젝트 실행

관리자 권한으로 Visual Studio를 실행합니다.

  • 빌드 구성 드롭다운 목록이 디버그로 설정되었는지 확인합니다.
  • 디버깅 시작 단추IIS 프로필로 설정하고 단추를 선택하여 앱을 시작합니다.

관리자로 실행하고 있지 않으면 Visual Studio에서 다시 시작하라는 메시지가 표시될 수 있습니다. 메시지가 표시되면 Visual Studio를 다시 시작합니다.

신뢰할 수 없는 개발 인증서를 사용하는 경우 브라우저에서 신뢰할 수 없는 인증서에 대한 예외를 만들어야 할 수 있습니다.

참고 항목

내 코드만 및 컴파일러 최적화를 사용하여 릴리스 빌드 구성을 디버그하면 성능이 저하됩니다. 예를 들어 중단점이 적중되지 않습니다.

추가 리소스