Microsoft MVP성태의 닷넷 이야기
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 

.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://docs.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://docs.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살 먹은 어린애도 알 수 있을 것입니다. ^^





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

[연관 글]


donaricano-btn



[최초 등록일: ]
[최종 수정일: 5/3/2021 ]

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
정성태

[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
12674정성태6/15/20215VC++: 142. DEFINE_GUID 사용법
12673정성태6/15/20218Java: 19. IntelliJ - 자바(Java)로 만드는 Web App을 Tomcat에서 실행하는 방법
12672정성태6/15/20215오류 유형: 725. IntelliJ에서 Java webapp 실행 시 "Address localhost:1099 is already in use" 오류
12671정성태6/15/20216오류 유형: 724. Tomcat 실행 시 Failed to initialize connector [Connector[HTTP/1.1-8080]] 오류
12670정성태6/14/202147.NET Framework: 1071. DLL Surrogate를 이용한 Out-of-process COM 개체에서의 CoInitializeSecurity 문제파일 다운로드1
12669정성태6/12/202197.NET Framework: 1070. 사용자 정의 GetHashCode 메서드 구현은 C# 9.0의 record 또는 리팩터링에 맡기세요.
12668정성태6/13/202181.NET Framework: 1069. C# - DLL Surrogate를 이용한 Out-of-process COM 개체 제작파일 다운로드2
12667정성태6/13/202163.NET Framework: 1068. COM+ 서버 응용 프로그램을 이용해 CoInitializeSecurity 제약 해결파일 다운로드1
12666정성태6/10/202159.NET Framework: 1067. 별도 DLL에 포함된 타입을 STAThread Main 메서드에서 사용하는 경우 CoInitializeSecurity 자동 호출파일 다운로드1
12665정성태6/14/202167.NET Framework: 1066. Wslhub.Sdk 사용으로 알아보는 CoInitializeSecurity 사용 제약파일 다운로드1
12664정성태6/9/202143오류 유형: 723. COM+ PIA 참조 시 "This operation failed because the QueryInterface call on the COM component" 오류
12663정성태6/9/202192.NET Framework: 1065. Windows Forms - 속성 창의 디자인 설정 지원: 문자열 목록 내에서 항목을 선택하는 TypeConverter 제작파일 다운로드1
12662정성태6/8/2021110.NET Framework: 1064. C# COM 개체를 PIA(Primary Interop Assembly)로써 "Embed Interop Types" 참조하는 방법파일 다운로드1
12661정성태6/4/2021238.NET Framework: 1063. C# - MQTT를 이용한 클라이언트/서버(Broker) 통신 예제 [2]파일 다운로드1
12660정성태6/3/2021178.NET Framework: 1062. Windows Forms - 폼 내에서 발생하는 마우스 이벤트를 자식 컨트롤 영역에 상관없이 수신하는 방법 [1]파일 다운로드1
12659정성태6/2/202178Linux: 40. 우분투 설치 후 MBR 디스크 드라이브 여유 공간이 인식되지 않은 경우 - Logical Volume Management
12658정성태6/2/2021131Windows: 194. Microsoft Store에 있는 구글의 공식 Youtube App
12657정성태6/2/2021238Windows: 193. 윈도우 패키지 관리자 - winget 설치
12656정성태6/1/202177.NET Framework: 1061. 서버 유형의 COM+에 적용할 수 없는 Server GC
12655정성태6/1/202175오류 유형: 722. windbg/sos - savemodule - Fail to read memory
12654정성태5/31/202194오류 유형: 721. Hyper-V - Saved 상태의 VM을 시작 시 오류 발생
12653정성태5/31/2021185.NET Framework: 1060. 닷넷 GC에 새롭게 구현되는 DPAD(Dynamic Promotion And Demotion for GC)
12652정성태5/31/202193VS.NET IDE: 164. Visual Studio - Web Deploy로 Publish 시 암호창이 매번 뜨는 문제
12651정성태5/31/2021101오류 유형: 720. PostgreSQL - ERROR: 22P02: malformed array literal: "..."
12650정성태5/17/2021107기타: 82. OpenTabletDriver의 버튼에 더블 클릭을 매핑 및 게임에서의 지원 방법
[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...