Microsoft MVP성태의 닷넷 이야기
.NET Framework: 1010. .NET Core 콘솔 프로젝트에서 Kestrel 호스팅 방법 [링크 복사], [링크+제목 복사],
조회: 17050
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 
(연관된 글이 4개 있습니다.)
(시리즈 글이 4개 있습니다.)
.NET Framework: 1010. .NET Core 콘솔 프로젝트에서 Kestrel 호스팅 방법
; https://www.sysnet.pe.kr/2/0/12496

.NET Framework: 1012. .NET Core Kestrel 호스팅 - 비주얼 스튜디오의 Kestrel/IIS Express 프로파일 설정
; https://www.sysnet.pe.kr/2/0/12498

.NET Framework: 1013. .NET Core Kestrel 호스팅 - 포트 변경, non-localhost 접속 지원 및 https 등의 설정 변경
; https://www.sysnet.pe.kr/2/0/12499

.NET Framework: 1018. .NET Core Kestrel 호스팅 - Web API 추가
; https://www.sysnet.pe.kr/2/0/12505




.NET Core 콘솔 프로젝트에서 Kestrel 호스팅 방법

가장 쉽게는, 그냥 프로젝트 파일을 편집해 Sdk 유형만 "Microsoft.NET.Sdk"에서 "Microsoft.NET.Sdk.Web"로 바꾸는 방법이 있습니다.

<Project Sdk="Microsoft.NET.Sdk.Web">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>netcoreapp3.1</TargetFramework>
  </PropertyGroup>

</Project>

이와 함께 최소한의 코드만 추가해 주면,

.NET Generic Host in ASP.NET Core
; https://learn.microsoft.com/en-us/aspnet/core/fundamentals/host/generic-host

using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using Microsoft.AspNetCore.Http;

public class Program
{
    public static void Main(string[] args)
    {
        CreateHostBuilder(args).Build().Run();
    }

    public static IHostBuilder CreateHostBuilder(string[] args) =>
        Host.CreateDefaultBuilder(args)
            .ConfigureWebHostDefaults(webBuilder =>
            {
                webBuilder.UseStartup<Startup>();
            });
}

public class Startup
{
    public void ConfigureServices(IServiceCollection services) { }

    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
        app.UseRouting();
        app.UseEndpoints(endpoints =>
        {
            endpoints.MapGet("/", async context =>
            {
                await context.Response.WriteAsync("Hello World!");
            });
        });
    }
}

웹 서버로써의 기본 기능을 갖추고, 디폴트로 지정된 포트가 5000번이므로 이후 웹 브라우저에서 "http://localhost:5000/"으로 접속하면 화면에 "Hello World!" 문자열을 확인할 수 있습니다. (사실, 위와 같이 하는 것은 애당초 프로젝트 유형을 "ASP.NET Core Web Application"의 "Empty" 타입으로 선택하는 것과 같습니다. 실제로 생성된 프로젝트나 결과 코드 또한 위의 경우와 거의 비슷합니다.)




또는, .NET Core 3.0부터 지원하는 FrameworkReference를 이용하는 방법이 있습니다.

Use ASP.NET Core APIs in a class library
 - Use the ASP.NET Core shared framework
; https://learn.microsoft.com/en-us/aspnet/core/fundamentals/target-aspnetcore#use-the-aspnet-core-shared-framework

라이브러리 프로젝트의 경우 "Microsoft.NET.Sdk.Web"으로 지정해 컴파일하는 경우 CS5001 오류가 발생하므로,

CSC : error CS5001: Program does not contain a static 'Main' method suitable for an entry point

이를 보완하기 위해 나온 것인데, 비-라이브러리 프로젝트 유형에서도 사용이 가능하므로 프로젝트 파일에 이렇게 지정할 수 있습니다.

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TargetFramework>netcoreapp3.0</TargetFramework>
  </PropertyGroup>

  <ItemGroup>
    <FrameworkReference Include="Microsoft.AspNetCore.App" />
  </ItemGroup>

</Project>

콘솔 프로젝트에 대해 Microsoft.NET.Sdk.Web 혹은 FrameworkReference를 쓰는 것은 디버깅 모드에서도 차이가 납니다. 전자의 경우로 바꾸면 프로젝트 속성 창에 웹 브라우저 런칭 관련한 속성들이 설정가능한 반면, 후자의 경우는 그렇지 않습니다.

또한, 현재 버그인 듯한데, FrameworkReference를 사용하는 경우 F5 디버깅을 시작하면 이런 오류가 발생할 수 있습니다.

The project doesn't know how to run the profile IIS Express.

프로젝트 속성 창의 "Debug" / "Profile"을 보면 "IIS Express"로 되어 있을 텐데, 정상적인 상황에서는 이 값을 프로젝트 이름으로 된 항목으로 선택하면 해결이 되겠지만 이상하게 여전히 저 오류가 계속 발생합니다. 왜냐하면 비주얼 스튜디오에서의 변경이 파일로 저장이 안 되기 때문인데요, 이럴 때는 직접 [프로젝트명].csproj.user 파일을 열어 ActiveDebugProfile의 값을 변경하면 됩니다.

<?xml version="1.0" encoding="utf-8"?>
<Project ToolsVersion="Current" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <PropertyGroup>
    <ActiveDebugProfile>ConsoleApp1</ActiveDebugProfile>
  </PropertyGroup>
</Project>




마지막으로, (아마도) 어셈블리를 일일이 참조 추가하는 것도 가능할 것입니다. (개인적으로는 해본 적이 없습니다. ^^;)

.NET Core 콘솔 프로젝트에서 단지 아래의 코드만 빌드하기 위해,

public class Program
{
    public static void Main(string[] args)
    {
        CreateHostBuilder(args).Build().Run();
    }

    public static IHostBuilder CreateHostBuilder(string[] args) =>
        Host.CreateDefaultBuilder(args)
            .ConfigureWebHostDefaults(webBuilder =>
            {
            });
}

(Nuget으로부터) 참조하는 첫 번째 어셈블리는 Microsoft.Extensions.Hosting이 될 것입니다.

Install-Package Microsoft.Extensions.Hosting

하지만 이렇게 해도 ConfigureWebHostDefaults (확장) 메서드 정의가 없어 이런 오류가 발생합니다.

Error CS1061 'IHostBuilder' does not contain a definition for 'ConfigureWebHostDefaults' and no accessible extension method 'ConfigureWebHostDefaults' accepting a first argument of type 'IHostBuilder' could be found (are you missing a using directive or an assembly reference?)


이를 해결하기 위해 관련있는 어셈블리들(ConfigureWebHostDefaults의 경우 Microsoft.AspNetCore)을 계속 참조 추가하면 되는데, 사실 이게 보통 일이 아닙니다. 왜냐하면 서로들 의존성 있는 어셈블리들이 끝(?)도 없이 나오기 때문인데, 어느 정도인지는 Visual Studio의 솔루션 탐색기에서 보여주는 아래의 목록을 확인하시면 됩니다.

aspnetcore_assembly_list_1.png

그렇습니다. (모두 필요한 것은 아니겠지만) 저렇게 많은 어셈블리들을 수작업으로 지정하는 것은 절대 현명한 방법이 아님을 3살 먹은 어린애도 알 수 있을 것입니다. ^^





[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]

[연관 글]






[최초 등록일: ]
[최종 수정일: 11/13/2023]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 



2021-03-05 09시11분
이 글에서 소개한 간단한 유형으로 Web API를 만드는 것을 "Route-to-code" 방식이라고 합니다. 아래의 글을 통해 ^^ 처음 알게 되었습니다.

Basic JSON APIs with Route-to-code in ASP.NET Core
; https://docs.microsoft.com/en-us/aspnet/core/web-api/route-to-code
정성태

... 106  [107]  108  109  110  111  112  113  114  115  116  117  118  119  120  ...
NoWriterDateCnt.TitleFile(s)
11249정성태7/12/201718536오류 유형: 410. LoadLibrary("[...].dll") failed - The specified procedure could not be found.
11248정성태7/12/201725033오류 유형: 409. pip install pefile - 'cp949' codec can't decode byte 0xe2 in position 208687: illegal multibyte sequence
11247정성태7/12/201719372오류 유형: 408. SqlConnection 객체 생성 시 무한 대기 문제파일 다운로드1
11246정성태7/11/201718136VS.NET IDE: 118. Visual Studio - 다중 폴더에 포함된 파일들에 대한 "Copy to Output Directory"를 한 번에 설정하는 방법
11245정성태7/10/201723760개발 환경 구성: 321. Visual Studio Emulator for Android 소개 [2]
11244정성태7/10/201723313오류 유형: 407. Visual Studio에서 ASP.NET Core 실행할 때 dotnet.exe 프로세스의 -532462766 오류 발생 [1]
11243정성태7/10/201719999.NET Framework: 666. dotnet.exe - 윈도우 운영체제에서의 .NET Core 버전 찾기 규칙
11242정성태7/8/201720274제니퍼 .NET: 27. 제니퍼 닷넷 적용 사례 (7) - 노후된 스토리지 장비로 인한 웹 서비스 Hang (멈춤) 현상
11241정성태7/8/201719023오류 유형: 406. Xamarin 빌드 에러 XA5209, APT0000
11240정성태7/7/201721953.NET Framework: 665. ClickOnce를 웹 브라우저를 이용하지 않고 쿼리 문자열을 전달하면서 실행하는 방법 [3]파일 다운로드1
11239정성태7/6/201723426.NET Framework: 664. Protocol Handler - 웹 브라우저에서 데스크톱 응용 프로그램을 실행하는 방법 [5]파일 다운로드1
11238정성태7/6/201720944오류 유형: 405. NT 서비스 시작 시 "Error 1067: The process terminated unexpectedly." 오류 발생 [2]
11237정성태7/5/201722601.NET Framework: 663. C# - PDB 파일 경로를 PE 파일로부터 얻는 방법파일 다운로드1
11236정성태7/4/201725841.NET Framework: 662. C# - VHD/VHDX 가상 디스크를 마운트하지 않고 파일을 복사하는 방법파일 다운로드1
11235정성태6/29/201719966Math: 20. Matlab/Octave로 Gram-Schmidt 정규 직교 집합 구하는 방법
11234정성태6/29/201717310오류 유형: 404. SharePoint 2013 설치 과정에서 "The username is invalid The account must be a valid domain account" 오류 발생
11233정성태6/28/201717226오류 유형: 403. SharePoint Server 2013을 Windows Server 2016에 설치할 때 .NET 4.5 설치 오류 발생
11232정성태6/28/201718227Windows: 144. Windows Server 2016에 Windows Identity Extensions을 설치하는 방법
11231정성태6/28/201718841디버깅 기술: 86. windbg의 mscordacwks DLL 로드 문제 - 세 번째 이야기 [1]
11230정성태6/28/201718021제니퍼 .NET: 26. 제니퍼 닷넷 적용 사례 (6) - 잦은 Recycle 문제
11229정성태6/27/201719255오류 유형: 402. Windows Server Backup 관리 콘솔이 없어진 경우
11228정성태6/26/201716718개발 환경 구성: 320. Visual Basic .NET 프로젝트에서 내장 Manifest 자원을 EXE 파일로부터 제거하는 방법파일 다운로드1
11227정성태6/19/201724467개발 환경 구성: 319. windbg에서 python 스크립트 실행하는 방법 - pykd [6]
11226정성태6/19/201716328오류 유형: 401. Microsoft Edge를 실행했는데 입력 반응이 없는 경우
11225정성태6/19/201715640오류 유형: 400. Outlook - The required file ExSec32.dll cannot be found in your path. Install Microsoft Outlook again.
11224정성태6/13/201718131.NET Framework: 661. Json.NET의 DeserializeObject 수행 시 속성 이름을 동적으로 바꾸는 방법파일 다운로드1
... 106  [107]  108  109  110  111  112  113  114  115  116  117  118  119  120  ...