Microsoft MVP성태의 닷넷 이야기
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 
(연관된 글이 1개 있습니다.)
(시리즈 글이 3개 있습니다.)
개발 환경 구성: 703. Visual Studio - launchSettings.json을 이용한 HTTP/HTTPS 포트 바인딩
; https://www.sysnet.pe.kr/2/0/13539

VS.NET IDE: 188. launchSettings.json의 useSSL 옵션
; https://www.sysnet.pe.kr/2/0/13541

닷넷: 2212. ASP.NET Core - 우선순위에 따른 HTTP/HTTPS 호스트:포트 바인딩 방법
; https://www.sysnet.pe.kr/2/0/13545




ASP.NET Core - 우선순위에 따른 HTTP/HTTPS 호스트:포트 바인딩 방법

지난 글에 소개한 "launchSettings.json" 파일은,

Visual Studio - launchSettings.json을 이용한 HTTP/HTTPS 포트 바인딩
; https://www.sysnet.pe.kr/2/0/13539

보통 개발 시점에만 사용하게 됩니다. 반면, 배포 시에는 다른 방법으로 제어를 할 수 있는데요, 이에 대해 다음의 글에서 자세하게 소개하고 있습니다.

5 ways to set the URLs for an ASP.NET Core app
; https://andrewlock.net/5-ways-to-set-the-urls-for-an-aspnetcore-app/

우선 기본 상태로 Publish를 하면 (지난 글에 설명한 것처럼 아무런 프로파일도 지정이 안 되었으므로 기본값인) HTTP 5000으로만 대기를 합니다.

C:\temp\...[생략]...\net8.0\publish> WebApplication3.exe
info: Microsoft.Hosting.Lifetime[14]
      Now listening on: http://localhost:5000
info: Microsoft.Hosting.Lifetime[0]
      Application started. Press Ctrl+C to shut down.
info: Microsoft.Hosting.Lifetime[0]
      Hosting environment: Production
info: Microsoft.Hosting.Lifetime[0]
      Content root path: C:\temp\...[생략]...\net8.0\publish

이것을 바꾸기 위한 가장 낮은 우선순위의 방법은 ASPNETCORE_URLS 환경변수를 설정하는 것입니다.

C:\temp\...[생략]...\net8.0\publish> set ASPNETCORE_URLS=https://localhost:5015;http://localhost:5014

C:\temp\...[생략]...\net8.0\publish> WebApplication3.exe
info: Microsoft.Hosting.Lifetime[14]
      Now listening on: https://localhost:5015
info: Microsoft.Hosting.Lifetime[14]
      Now listening on: http://localhost:5014
info: Microsoft.Hosting.Lifetime[0]
      Application started. Press Ctrl+C to shut down.
info: Microsoft.Hosting.Lifetime[0]
      Hosting environment: Production
info: Microsoft.Hosting.Lifetime[0]
      Content root path: C:\temp\...[생략]...\net8.0\publish

이 값은 launchSettings.json에서도 종종 환경변수 란에 설정된 것을 볼 수 있습니다.

"Docker": {
    "commandName": "Docker",
    "launchBrowser": true,
    "launchUrl": "{Scheme}://{ServiceHost}:{ServicePort}",
    "environmentVariables": {
        "ASPNETCORE_URLS": "http://+:80"
    },
}

그다음 높은 순위는 명령행에 지정하는 건데요, 즉 환경변수를 설정했어도 이 값이 적용됩니다.

C:\temp\...[생략]...\net8.0\publish> set ASPNETCORE_URLS=https://localhost:5015;http://localhost:5014

C:\temp\...[생략]...\net8.0\publish> WebApplication3.exe --urls "https://localhost:5025;http://localhost:5024"
info: Microsoft.Hosting.Lifetime[14]
      Now listening on: https://localhost:5025
info: Microsoft.Hosting.Lifetime[14]
      Now listening on: http://localhost:5024
info: Microsoft.Hosting.Lifetime[0]
      Application started. Press Ctrl+C to shut down.
info: Microsoft.Hosting.Lifetime[0]
      Hosting environment: Production
info: Microsoft.Hosting.Lifetime[0]
      Content root path: C:\temp\...[생략]...\net8.0\publish

이 옵션은 dotnet run 명령어로 실행할 때도 그대로 적용할 수 있습니다.

dotnet run --urls "https://localhost:5025;http://localhost:5024"

위의 2가지 방법을 무시하고 싶다면 코딩으로 명시해야 하는데요, WebHost.UseUrls 메서드를 호출하면 됩니다.

namespace WebApplication3;

public class Program
{
    public static void Main(string[] args)
    {
        var builder = WebApplication.CreateBuilder(args);

        builder.WebHost.UseUrls("http://localhost:5034", "https://localhost:5035");

        // Add services to the container.
        builder.Services.AddRazorPages();

        var app = builder.Build();

        // Configure the HTTP request pipeline.
        if (!app.Environment.IsDevelopment())
        {
            app.UseExceptionHandler("/Error");
            // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
            app.UseHsts();
        }

        app.UseHttpsRedirection();
        app.UseStaticFiles();

        app.UseRouting();

        app.UseAuthorization();

        app.MapRazorPages();

        app.Run();
    }
}

그럼 환경변수가 적용됐어도, --urls 명령행 옵션을 줬어도 코드의 값이 반영됩니다.

C:\temp\...[생략]...\net8.0\publish> set ASPNETCORE_URLS=https://localhost:5015;http://localhost:5014

C:\temp\...[생략]...\net8.0\publish> WebApplication3.exe --urls "https://localhost:5025;http://localhost:5024"
info: Microsoft.Hosting.Lifetime[14]
      Now listening on: http://localhost:5034
info: Microsoft.Hosting.Lifetime[14]
      Now listening on: https://localhost:5035
info: Microsoft.Hosting.Lifetime[0]
      Application started. Press Ctrl+C to shut down.
info: Microsoft.Hosting.Lifetime[0]
      Hosting environment: Production
info: Microsoft.Hosting.Lifetime[0]
      Content root path: C:\temp\...[생략]...\net8.0\publish

마지막으로, ConfigureKestrel 설정은 위에서 설정한 모든 값을 무시하는 가장 높은 우선순위를 갖습니다.

builder.WebHost.UseUrls("http://localhost:5034", "https://localhost:5035");

builder.WebHost.ConfigureKestrel((options) =>
{
    options.ListenLocalhost(5044);
    options.ListenLocalhost(5045, opts => opts.UseHttps());
});

호출 순서를 바꿔도 마찬가지입니다.

builder.WebHost.ConfigureKestrel((options) =>
{
    options.ListenLocalhost(5044);
    options.ListenLocalhost(5045, opts => opts.UseHttps());
});

builder.WebHost.UseUrls("http://localhost:5034", "https://localhost:5035");

한 가지 특이한 점은, ConfigureKestrel로 인한 재정의를 했을 때는 이 사실을 알리는 메시지를 함께 출력한다는 점입니다.

C:\temp\...[생략]...\net8.0\publish> set ASPNETCORE_URLS=https://localhost:5015;http://localhost:5014

C:\temp\...[생략]...\net8.0\publish> WebApplication3.exe --urls "https://localhost:5025;http://localhost:5024"
warn: Microsoft.AspNetCore.Server.Kestrel[0]
      Overriding address(es) 'http://localhost:5034, https://localhost:5035'. Binding to endpoints defined via IConfiguration and/or UseKestrel() instead.
info: Microsoft.Hosting.Lifetime[14]
      Now listening on: http://localhost:5044
info: Microsoft.Hosting.Lifetime[14]
      Now listening on: https://localhost:5045
info: Microsoft.Hosting.Lifetime[0]




만약, 환경변수, 입력 인자 및 코드 등으로 저렇게 변경하는 것을 비주얼 스튜디오로 개발하는 중에 적용한다면 Properties\launchSettings.json 파일도 그에 맞게 바꿔줘야 디버깅을 편하게 할 수 있습니다.

또한, ASPNETCORE_URLS 환경 설정의 경우 값을 설정할 때 따옴표를 쓰면 안 됩니다.

set ASPNETCORE_URLS="https://localhost:5035;http://localhost:5034"

위와 같이 설정하게 되면 이후 실행 시 이런 예외가 발생합니다.

System.InvalidOperationException: Unrecognized scheme in server address '"https://localhost:5035'. Only 'http://' and 'https://' are supported.




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

[연관 글]






[최초 등록일: ]
[최종 수정일: 1/31/2024]

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

비밀번호

댓글 작성자
 




1  2  3  [4]  5  6  7  8  9  10  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
13572정성태3/4/20242848닷넷: 2224. C# - WPF의 Dispatcher Queue로 알아보는 await 호출의 hang 현상파일 다운로드1
13571정성태3/1/20242633닷넷: 2223. C# - await 호출과 WPF의 Dispatcher Queue 동작 확인파일 다운로드1
13570정성태2/29/20242402닷넷: 2222. C# - WPF의 Dispatcher Queue 동작 확인파일 다운로드1
13569정성태2/28/20242317닷넷: 2221. C# - LoadContext, LoadFromContext 그리고 GAC파일 다운로드1
13568정성태2/27/20242422닷넷: 2220. C# - .NET Framework 프로세스의 LoaderOptimization 설정을 확인하는 방법파일 다운로드1
13567정성태2/27/20242349오류 유형: 898. .NET Framework 3.5 이하에서 mscoree.tlb 참조 시 System.BadImageFormatException파일 다운로드1
13566정성태2/27/20242450오류 유형: 897. Windows 7 SDK 설치 시 ".NET Development" 옵션이 비활성으로 선택이 안 되는 경우
13565정성태2/23/20242302닷넷: 2219. .NET CLR2 보안 모델에서의 개별 System.Security.Permissions 제어
13564정성태2/22/20242654Windows: 259. Hyper-V Generation 1 유형의 VM을 Generation 2 유형으로 바꾸는 방법
13563정성태2/21/20242701디버깅 기술: 196. windbg - async/await 비동기인 경우 메모리 덤프 분석의 어려움
13562정성태2/21/20242601오류 유형: 896. ASP.NET - .NET Framework 기본 예제에서 System.Web에 대한 System.IO.FileNotFoundException 예외 발생
13561정성태2/20/20242827닷넷: 2218. C# - (예를 들어, Socket) 비동기 I/O에 대한 await 호출 시 CancellationToken을 이용한 취소파일 다운로드1
13560정성태2/19/20242759디버깅 기술: 195. windbg 분석 사례 - Semaphore 잠금으로 인한 Hang 현상 (닷넷)
13559정성태2/19/20243578오류 유형: 895. ASP.NET - System.Security.SecurityException: 'Requested registry access is not allowed.'
13558정성태2/18/20242862닷넷: 2217. C# - 최댓값이 1인 SemaphoreSlim 보다 Mutex 또는 lock(obj)를 선택하는 것이 나은 이유
13557정성태2/18/20242535Windows: 258. Task Scheduler의 Author 속성 값을 변경하는 방법
13556정성태2/17/20242650Windows: 257. Windows - Symbolic (hard/soft) Link 및 Junction 차이점
13555정성태2/15/20242990닷넷: 2216. C# - SemaphoreSlim 사용 시 주의점
13554정성태2/15/20242616VS.NET IDE: 189. Visual Studio - 닷넷 소스코드 디컴파일 찾기가 안 될 때
13553정성태2/14/20242649닷넷: 2215. windbg - thin/fat lock 없이 동작하는 Monitor.Wait + Pulse
13552정성태2/13/20242691닷넷: 2214. windbg - Monitor.Enter의 thin lock과 fat lock
13551정성태2/12/20243001닷넷: 2213. ASP.NET/Core 웹 응용 프로그램 - 2차 스레드의 예외로 인한 비정상 종료
13550정성태2/11/20243221Windows: 256. C# - Server socket이 닫히면 Accept 시켰던 자식 소켓이 닫힐까요?
13549정성태2/3/20243513개발 환경 구성: 706. C# - 컨테이너에서 실행하기 위한 (소켓) 콘솔 프로젝트 구성
13548정성태2/1/20243212개발 환경 구성: 705. "Docker Desktop for Windows" - ASP.NET Core 응용 프로그램의 소켓 주소 바인딩(IPv4/IPv6 loopback, Any)
13547정성태1/31/20242974개발 환경 구성: 704. Visual Studio - .NET 8 프로젝트부터 dockerfile에 추가된 "USER app" 설정
1  2  3  [4]  5  6  7  8  9  10  11  12  13  14  15  ...