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)
12384정성태10/27/20201366오류 유형: 672. AllowPartiallyTrustedCallers 특성이 적용된 어셈블리의 struct 멤버 메서드를 재정의하면 System.Security.VerificationException 예외 발생
12383정성태10/27/20201681.NET Framework: 956. C# 9.0 - (7) 패턴 일치 개선 사항(Pattern matching enhancements) [1]파일 다운로드1
12382정성태10/26/20201241오류 유형: 671. dotnet build - The local source '...' doesn't exist
12381정성태10/26/20201422VC++: 137. C++ stl map의 사용자 정의 타입을 key로 사용하는 방법파일 다운로드1
12380정성태10/26/2020967오류 유형: 670. Visual Studio - Squash_FailureCommitsReset
12379정성태10/21/20201578.NET Framework: 955. .NET 메서드의 Signature 바이트 코드 분석파일 다운로드2
12378정성태10/15/20201629.NET Framework: 954. C# - x86/x64 환경에 따라 달라지는 P/Invoke 함수의 export 이름파일 다운로드1
12377정성태10/15/20201627디버깅 기술: 172. windbg - 파일 열기 시점에 bp를 걸어 파일명 알아내는 방법(Managed/Unmanaged)
12376정성태10/15/20201316오류 유형: 669. windbg - sos의 name2ee 명령어 실행 시 "Failed to request module list." 오류
12375정성태10/15/20201730Windows: 177. 윈도우 탐색기에서 띄우는 cmd.exe 창의 디렉터리 구분 문자가 'Yen(&#0165;)' 기호로 나오는 경우 [1]
12374정성태10/14/20202161.NET Framework: 953. C# 9.0 - (6) 함수 포인터(Function pointers) [1]파일 다운로드2
12373정성태10/14/20201215.NET Framework: 952. OpCodes.Box와 관련해 IL 형식으로 직접 코딩 시 유의할 점
12372정성태10/13/20201944.NET Framework: 951. C# 9.0 - (5) 로컬 함수에 특성 지정 가능(Attributes on local functions)파일 다운로드1
12371정성태10/13/20201280개발 환경 구성: 519. Visual Studio의 Ctrl+Shift+U (Edit.MakeUppercase) 단축키가 동작하지 않는 경우
12370정성태10/13/20201536Linux: 33. Linux - nmcli를 이용한 고정 IP 설정
12369정성태10/12/20202702Windows: 176. Raymond Chen이 한글날에 밝히는 윈도우의 한글 자모 분리 현상 [1]
12368정성태10/12/20201432오류 유형: 668. VSIX 확장 빌드 - The "GetDeploymentPathFromVsixManifest" task failed unexpectedly.
12367정성태10/12/20202699오류 유형: 667. Ubuntu - Temporary failure resolving 'kr.archive.ubuntu.com'
12366정성태10/12/20201801.NET Framework: 950. C# 9.0 - (4) 원시 크기 정수(Native ints) [1]파일 다운로드1
12365정성태10/12/20201633.NET Framework: 949. C# 9.0 - (3) 람다 메서드의 매개 변수 무시(Lambda discard parameters)파일 다운로드1
12364정성태10/11/20201992.NET Framework: 948. C# 9.0 - (2) localsinit 플래그 내보내기 무시(Suppress emitting localsinit flag)파일 다운로드1
12363정성태10/11/20202299.NET Framework: 947. C# 9.0 - (1) 대상으로 형식화된 new 식(Target-typed new expressions) [2]파일 다운로드1
12362정성태10/11/20201241VS.NET IDE: 151. Visual Studio 2019에 .NET 5 rc/preview 적용하는 방법
12361정성태10/11/20201829.NET Framework: 946. C# 9.0을 위한 개발 환경 구성
12360정성태10/8/20201100오류 유형: 666. The type or namespace name '...' does not exist in the namespace 'Microsoft.VisualStudio.TestTools' (are you missing an assembly reference?)
12359정성태10/7/20201331오류 유형: 665. Windows - 재부팅 후 iSCSI 연결이 끊기는 문제
1  2  3  4  5  6  7  8  9  10  11  12  13  14  [15]  ...