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

사용자 정의 웹 서버(EXE)를 IIS에서 호스팅하는 방법 - HttpPlatformHandler (Reverse Proxy)

IIS 서버를 Reverse Proxy 서버로 사용할 수 있도록 해주는 구성 요소가 바로 HttpPlatformHandler입니다. 동작 방식은 다음과 같이 간단합니다.

http_platform_handler_1.png

사용법도 간단합니다. HttpPlatformHandler를 IIS 웹 서버에 설치 후,

HttpPlatformHandler v1.2
; https://www.iis.net/downloads/microsoft/httpplatformhandler
; https://learn.microsoft.com/en-us/iis/extensions/httpplatformhandler/httpplatformhandler-configuration-reference

여러분들의 EXE 응용 프로그램이 배포되는 폴더를 웹 사이트의 루트 디렉터리로 지정한 후, 다음과 같은 내용을 포함한 web.config 파일을 만들어 주면 됩니다.

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
  <system.webServer>
    <handlers>
      <add name="httpplatformhandler" path="*" verb="*" modules="httpPlatformHandler" resourceType="Unspecified"/>
    </handlers>
    <httpPlatform processPath="d:\temp\ConsoleApp1.exe" 
                  arguments="" 
                  stdoutLogEnabled="false" stdoutLogFile="C:\temp\LogFiles\test.log">
    </httpPlatform>
  </system.webServer>
</configuration>

이후 IIS는 웹 사이트의 설정된 포트(예를 들어, 8094)로 요청이 들어오면 이를 w3wp.exe의 web.config 설정에 따라 여러분들의 웹 서버(이 글에서는 ConsoleApp1.exe)로 전달하는 중계 역할을 합니다. 참고로, 이때 만약 최초 요청이라면 웹 서버(ConsoleApp1.exe) 프로세스를 하나 새로 생성해주는 역할까지 합니다.

그런데 여기서 재미있는 점이 있습니다. IIS는 웹 가든 같은 설정에 따라 w3wp.exe를 다중으로 띄울 수 있고 이에 따라 웹 서버(ConsoleApp1.exe)도 다중으로 뜨는 식의 구성이 가능합니다. 문제는 이때 웹 서버(ConsoleApp1.exe)가 어떤 포트로 소켓을 열고 있어야 하느냐입니다. HttpPlatformHandler는 이를 위해 임의의 포트 번호를 환경 변수(HTTP_PLATFORM_PORT)를 통해 자식 프로세스에 전달하는데, 따라서 자식 프로세스는 이 환경 변수(HTTP_PLATFORM_PORT)를 인식하고 자신의 서버 소켓이 열고 있어야 할 포트로 지정할 수 있어야 합니다.

간단한 예를 들기 위해 ConsoleApp1.exe 실행 파일을 다음과 같은 코드로 만들 수 있습니다.

using System;
using System.Diagnostics;
using System.Net;
using System.Net.Sockets;
using System.Text;

namespace ConsoleApp1
{
    class Program
    {
        static int Main(string[] args)
        {
            SocketWait(GetPort());
            return 0;
        }

        private static void SocketWait(int port)
        {
            TcpListener tl = new TcpListener(IPAddress.Loopback, port);
            tl.Start(5);

            while (true)
            {
                Socket socket = tl.AcceptSocket();

                byte[] buf = new byte[4096];
                socket.Receive(buf);

                string text = $"<html><head><title></title></head><body>TIME : {DateTime.Now}</body></html>";
                string output = $"HTTP/1.1 200 OK\r\nCache-Control : no-cache, private\r\nContent-Type: text/html; charset=utf-8\r\nContent-Length : {text.Length}\r\nDate : Mon, 24 Nov 2014 12:03:43 GMT\r\n\r\n";
                buf = Encoding.UTF8.GetBytes(output + text);
                socket.Send(buf);

                socket.Close();
            }
        }

        private static int GetPort()
        {
            int port = 29501;

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

            if (int.TryParse(value, out int userPort) == true)
            {
                port = userPort;
            }

            Log($"PORT = {port}");

            return port;
        }

        public static void Log(string msg)
        {
            Console.WriteLine(Process.GetCurrentProcess().Id + ": " + msg);
            Console.Out.Flush();
        }
    }
}

(첨부 파일은 이 글의 예제 코드를 포함합니다.)

간단하죠? ^^ 실제로 위의 ConsoleApp1.exe를 HttpPlatformHandler에 지정해 웹 브라우저로 요청을 보내면 w3wp.exe의 자식 프로세스로 ConsoleApp1.exe가 실행되고 응답을 웹 브라우저로 전송하는 것을 확인할 수 있습니다.




헌데 HTTP_PLATFORM_PORT 환경 변수값을 인식하는 기존 웹 서버들이 얼마나 있겠냐고 생각할 수 있는데요, 다행히 HttpPlatformHandler는 자식 프로세스에서 임의의 환경 변수를 설정해서 넘겨주는 것도 가능합니다. 자세한 설명은 아래의 문서에서,

HttpPlatformHandler Configuration Reference
; https://learn.microsoft.com/en-us/iis/extensions/httpplatformhandler/httpplatformhandler-configuration-reference

Understanding IIS HTTPPlatformHandler using Tomcat 8
; https://learn.microsoft.com/en-us/archive/blogs/manjug/understanding-iis-httpplatformhandler-using-tomcat-8

Tomcat, Jetty 등의 웹 서버를 HttpPlatformHandler를 이용해 IIS의 호스팅 서비스를 받는 방법을 보면 됩니다.




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

[연관 글]






[최초 등록일: ]
[최종 수정일: 2/24/2023]

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

비밀번호

댓글 작성자
 




... 91  92  93  94  95  96  97  98  99  100  101  102  [103]  104  105  ...
NoWriterDateCnt.TitleFile(s)
11394정성태12/8/201719412개발 환경 구성: 342. 비주얼 스튜디오에서 실행하던 ASP.NET Core (.NET Framework) 응용 프로그램을 명령행에서 실행하는 방법
11393정성태12/7/201724573Windows: 145. 윈도우 10 빌드 17046부터 WSL에서 백그라운드 작업 지원 [5]
11392정성태12/7/201719054개발 환경 구성: 341. openSUSE에 닷넷 코어 설치
11391정성태12/7/201722102개발 환경 구성: 340. WSL을 이용해 윈도우 PC 1대에서 openSUSE 응용 프로그램을 Visual Studio로 개발하는 방법 [1]
11390정성태12/7/201731019개발 환경 구성: 339. WSL을 이용해 윈도우 PC 1대에서 Linux 응용 프로그램을 Visual Studio로 개발하는 방법 [6]
11389정성태12/7/201719680오류 유형: 440. .NET Core 오류 - 0x80131620 Unable to load DLL 'libuv'
11388정성태12/6/201723499개발 환경 구성: 338. WSL 또는 Ubuntu에 닷넷 코어 설치 [3]
11387정성태12/6/201723410오류 유형: 439. 이벤트 로그 - Data Sharing Service 서비스의 %%3239247874 오류 메시지
11386정성태12/5/201719431오류 유형: 438. Hyper-V - '...' failed to add device 'Virtual CD/DVD Disk'
11385정성태12/5/201732573VC++: 121. DXGI를 이용한 윈도우 화면 캡처 소스 코드(Visual C++) [16]파일 다운로드1
11384정성태12/5/201722046오류 유형: 437. Visual C++ - Cannot open include file: 'SDKDDKVer.h'
11383정성태12/4/201724662디버깅 기술: 110. 비동기 코드 실행 중 예외로 인한 ASP.NET 프로세스 비정상 종료 현상 [1]
11382정성태12/4/201723561오류 유형: 436. System.Data.SqlClient.SqlException (0x80131904): Connection Timeout Expired 예외 발생 시 "[Pre-Login] initialization=48; handshake=1944;" 값의 의미
11381정성태11/30/201720191.NET Framework: 702. 한글이 포함된 바이트 배열을 나눈 경우 한글이 깨지지 않도록 다시 조합하는 방법(두 번째 이야기)파일 다운로드1
11380정성태11/30/201720195디버깅 기술: 109. windbg - (x64에서의 인자 값 추적을 이용한) Thread.Abort 시 대상이 되는 스레드를 식별하는 방법
11379정성태11/30/201719947오류 유형: 435. System.Web.HttpException - Session state has created a session id, but cannot save it because the response was already flushed by the application.
11378정성태11/29/201721843.NET Framework: 701. 한글이 포함된 바이트 배열을 나눈 경우 한글이 깨지지 않도록 다시 조합하는 방법 [1]파일 다운로드1
11377정성태11/29/201721423.NET Framework: 700. CommonOpenFileDialog 사용 시 사용자가 선택한 파일 목록을 구하는 방법 [3]파일 다운로드1
11376정성태11/28/201726112VS.NET IDE: 123. Visual Studio 편집기의 \r\n (crlf) 개행을 \n으로 폴더 단위로 설정하는 방법
11375정성태11/28/201719882오류 유형: 434. Visual Studio로 ASP.NET 디버깅 중 System.Web.HttpException - Could not load type 오류
11374정성태11/27/201725862사물인터넷: 14. 라즈베리 파이 - (윈도우의 NT 서비스처럼) 부팅 시 시작하는 프로그램 설정 [1]
11373정성태11/27/201724868오류 유형: 433. Raspberry Pi/Windows 다중 플랫폼 지원 컴파일 관련 오류 기록
11372정성태11/25/201727407사물인터넷: 13. 윈도우즈 사용자를 위한 라즈베리 파이 제로 W 모델을 설정하는 방법 [4]
11371정성태11/25/201721221오류 유형: 432. Hyper-V 가상 스위치 생성 시 Failed to connect Ethernet switch port 0x80070002 오류 발생
11370정성태11/25/201721423오류 유형: 431. Hyper-V의 Virtual Switch 생성 시 "External network" 목록에 특정 네트워크 어댑터 항목이 없는 경우
11369정성태11/25/201723171사물인터넷: 12. Raspberry Pi Zero(OTG)를 다른 컴퓨터에 연결해 가상 키보드 및 마우스로 쓰는 방법 (절대 좌표, 상대 좌표, 휠) [1]
... 91  92  93  94  95  96  97  98  99  100  101  102  [103]  104  105  ...