Microsoft MVP성태의 닷넷 이야기
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 
(연관된 글이 2개 있습니다.)

ASP.NET Core (EXE) 프로세스가 IIS에서 호스팅되는 방법 - ASP.NET Core Module(AspNetCoreModule)

ASP.NET Core 웹 사이트가 IIS에서 호스팅될 때 AspNetCoreModule를 이용해 연결된다는 것을 전에도 언급한 적이 있습니다.

"ASP.NET Core Web Application (.NET Core)"와 "ASP.NET Core Web Application (.NET Framework)" 차이점
; https://www.sysnet.pe.kr/2/0/11121

그런데 사실 AspNetCoreModule은 새로운 모듈이 아닌, 기존 HttpPlatformHandler의 개량형에 불과합니다.

사용자 정의 웹 서버(EXE)를 IIS에서 호스팅하는 방법 - HttpPlatformHandler (Reverse Proxy)
; https://www.sysnet.pe.kr/2/0/11434

이에 대해서는 다음의 이슈에서 확인할 수 있습니다.

HttpPlatformHandler has been replaced by ASP.NET Core Module
; https://github.com/aspnet/IISIntegration/issues/105

즉, ASP.NET Core 초기에만 해도 AspNetCoreModule이 아닌 HttpPlatformHandler로 연동되었지만 ASP.NET만을 위한 몇 가지 기능 추가를 위해 AspNetCoreModule로 넘어온 것입니다.

실제로 HttpPlatformHandler의 경우 자식 프로세스로 "HTTP_PLATFORM_PORT" 환경 변수만을 이용해 동적 포트 번호를 넘겨주는 반면, AspNetCoreModule은 다음과 같이 5개의 환경 변수를 자식 프로세스에게 제공합니다.

  • ASPNETCORE_APPL_PATH
  • ASPNETCORE_HOSTINGSTARTUPASSEMBLIES
  • ASPNETCORE_IIS_HTTPAUTH
  • ASPNETCORE_PORT
  • ASPNETCORE_TOKEN

이 즈음에서 우리가 습관적으로 호출했던 UseIISIntegration의 역할을 짐작할 수 있습니다. 즉, 해당 확장 메서드는 부모 프로세스(w3wp.exe)로부터 전달받은 동적 포트 관련한 환경 구성을 맡고 있는 것입니다. 현재 UseIISIntegration은 Program.cs 파일의 WebHost.CreateDefaultBuilder 메서드 호출 내에서,

using Microsoft.AspNetCore;
using Microsoft.AspNetCore.Hosting;

namespace core_webapi
{
    public class Program
    {
        public static void Main(string[] args)
        {
            BuildWebHost(args).Run();
        }

        public static IWebHost BuildWebHost(string[] args) =>
            WebHost.CreateDefaultBuilder(args)
                .UseStartup<Startup>()
                .Build();
    }
}

불리고 있어 개발자가 별도로 호출할 일은 없게 되었습니다.




HttpPlatformHandler와 AspNetCoreModule이 사실 거의 다르지 않기 때문에 AspNetCoreModule을 이용해서도 지난번 소켓 서버 EXE를 연동하는 것이 가능합니다. 즉, 다음과 같이 web.config을 만들고,

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <system.webServer>
    <handlers>
      <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModule" resourceType="Unspecified" />
    </handlers>
    <aspNetCore processPath=".\ConsoleApp1.exe" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout" />
  </system.webServer>
</configuration>

ConsoleApp1.exe를 지난 예제 소스 코드에서 구해,

사용자 정의 웹 서버(EXE)를 IIS에서 호스팅하는 방법 - HttpPlatformHandler (Reverse Proxy)
; https://www.sysnet.pe.kr/2/0/11434

다음의 환경 변숫값만 변경해서 빌드 후 배포하면 정상적으로 동작합니다.

string value = Environment.GetEnvironmentVariable("ASPNETCORE_PORT");




혹시나 관심 있으신 분들은 ^^ AspNetCoreModule의 소스 코드를 직접 살펴볼 수도 있습니다.

aspnet/AspNetCoreModule 
; https://github.com/aspnet/AspNetCoreModule




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

[연관 글]






[최초 등록일: ]
[최종 수정일: 1/16/2018]

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

비밀번호

댓글 작성자
 



2018-03-22 07시08분
정성태
2020-07-11 12시09분
정성태
2021-01-23 09시58분
YARP를 이용한 리버스 프록시 서버 구축 [.NET Conf 2021 x Seoul - 32분 동영상]
; https://www.youtube.com/watch?v=YrmE9aNGRaE
정성태
2021-03-21 01시39분
정성태

[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
13982정성태8/2/2025211개발 환경 구성: 753. CentOS 7 컨테이너 내에서 openssh 서버 호스팅
13981정성태8/1/2025271오류 유형: 971. CentOS 7에서 yum 사용 시 "Could not resolve host: mirrorlist.centos.org; Unknown error"
13980정성태7/31/2025324Linux: 119. eBPF - BPF_PROG_TYPE_CGROUP_SOCK 유형에서 정상 동작하지 않는 BPF_CORE_READ (2)
13979정성태7/30/2025343Linux: 118. eBPF - BPF_PROG_TYPE_CGROUP_SOCK 유형에서 정상 동작하지 않는 BPF_CORE_READ
13978정성태7/29/2025441오류 유형: 970. 파일 복사 시 "Data error (cyclic redundancy check). (0x80070017)" 에러
13977정성태7/28/2025575닷넷: 2349. C# 14 - (5) 문자열 리터럴을 utf-8 인코딩으로 저장파일 다운로드1
13976정성태7/25/2025833닷넷: 2348. C# - 카카오 카나나 모델 + Microsoft.ML.OnnxRuntimeGenAI 예제파일 다운로드1
13975정성태7/23/2025964닷넷: 2347. C# 14 - (4) 형식 인자가 없는 제네릭 타입의 nameof 지원파일 다운로드1
13974정성태7/22/20251326닷넷: 2346. C# 14 - (3) Span 타입과 배열 간의 암시적 형변환파일 다운로드1
13973정성태7/21/20251204닷넷: 2345. C# - 배열 및 Span의 공변성파일 다운로드1
13972정성태7/21/20251382닷넷: 2344. C#의 Identity conversion 의미파일 다운로드1
13971정성태7/17/20251446닷넷: 2343. C# 14 - (2) 속성 구문에서 문맥 키워드로 추가되는 field 예약어파일 다운로드1
13970정성태7/17/20251389닷넷: 2342. C# 14 - (1) (예약)
13969정성태7/17/20251437닷넷: 2341. snap으로 설치한 .NET 리눅스 실행 환경
13968정성태7/16/20251321오류 유형: 969. lddtree - TypeError: 'type' object is not subscriptable
13967정성태7/16/20251847오류 유형: 968. snap으로 설치한 "dotnet run" 실행 시 "undefined symbol: _dl_audit_symbind_alt, version GLIBC_PRIVATE" 오류
13966정성태7/15/20252397디버깅 기술: 223. WinDbg - .kframes 명령어
13965정성태7/11/20251679오류 유형: 967. 디버깅 모드로 실행 시 "Could not find file 'C:\Program Files\IIS Express\Oracle.DataAccess.Common.Configuration.Section.xsd'" 예외
13964정성태7/10/20252344닷넷: 2340. C# - Win32 Multimedia Timer 주기파일 다운로드1
13963정성태7/8/20251887VS.NET IDE: 202. Visual Studio 2022 + Copilot 기본 사용법
13962정성태7/7/20251902스크립트: 79. 파이썬 - onnxruntime_genai에서 지원하지 않는 모델 사용
13961정성태7/5/20251611디버깅 기술: 222. WinDbg 분석 사례 - IISreset 시점에 w3wp.exe의 crash 발생
13960정성태7/3/20252800개발 환경 구성: 752. ProcDump - C/C++ 예외 코드 필터를 지정한 덤프 생성 [2]
13959정성태6/25/20251820오류 유형: 966. Ubuntu - ping: connect: Network is unreachable
13958정성태6/21/20252497닷넷: 2339. C# - Phi-4-multimodal 모델의 GPU 가속 방법 (ORT 사용)파일 다운로드1
[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...