.NET Core/5+ - PublishSingleFile 유형에 대한 runtimeconfig.json 설정
예제를 먼저 들어볼까요? ^^
다음과 같이 간단하게 코딩을 하고,
// .NET 7 + Console App
foreach (var item in GC.GetConfigurationVariables())
{
Console.WriteLine(item);
}
/*
Hello, World!
[ServerGC, False]
[ConcurrentGC, True]
[RetainVM, False]
[NoAffinitize, False]
[GCCpuGroup, False]
[GCLargePages, False]
[HeapCount, 1]
[GCHeapAffinitizeMask, 0]
[GCHeapAffinitizeRanges, ]
[GCHighMemPercent, 0]
[GCHeapHardLimit, 0]
[GCHeapHardLimitPercent, 0]
[GCHeapHardLimitSOH, 0]
[GCHeapHardLimitLOH, 0]
[GCHeapHardLimitPOH, 0]
[GCHeapHardLimitSOHPercent, 0]
[GCHeapHardLimitLOHPercent, 0]
[GCHeapHardLimitPOHPercent, 0]
[GCConserveMem, 0]
*/
실행 결과를 보면, 기본 상태인 경우
ConcurrentGC는 True인 것을 볼 수 있습니다. 이 상태에서, 만약 출력 디렉터리에 "ConsoleApp1.runtimeconfig.json" 파일을 만들어 다음과 같이 설정해 주면,
{
"runtimeOptions": {
"tfm": "net7.0",
"framework": {
"name": "Microsoft.NETCore.App",
"version": "7.0.0"
},
"configProperties": {
"System.GC.Concurrent": False
}
}
}
이후 ConsoleApp1 실행 시 화면에는 Concurrent 옵션이 False로 나옵니다.
그런데, 위의 응용 프로그램을 PublishSingleFile 옵션을 적용해,
C# - PublishSingleFile과 관련된 옵션
; https://www.sysnet.pe.kr/2/0/13159
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<OutputType>Exe</OutputType>
<TargetFramework>net7.0</TargetFramework>
<ImplicitUsings>enable</ImplicitUsings>
<Nullable>enable</Nullable>
<PublishSingleFile>true</PublishSingleFile>
<RuntimeIdentifier>win-x64</RuntimeIdentifier>
<DebugType>embedded</DebugType>
</PropertyGroup>
</Project>
배포하는 경우라면 어떻게 될까요? 배포 디렉터리를 보면, ConsoleApp1.exe 파일이 생성되는데요, 이 상태에서 실행하면 (예상할 수 있듯이) Concurrent 옵션이 True로 나옵니다. 그런데 이전과 마찬가지로 이 옵션을 변경하기 위해 ConsoleApp1.runtimeconfig.json을 만들어 주면 어떻게 될까요?
실행해 보면, ConsoleApp1.runtimeconfig.json 설정이 전혀 통하지 않는 것을 볼 수 있습니다. 왜냐하면, (.NET 7 이후의 경우) exe에 포함된 바이너리들은 모두 메모리 매핑에서 로딩이 돼 현재 경로가 사실상 메모리가 되기 때문에 exe가 출력된 디렉터리를 더 이상 참조하지 않기 때문입니다.
따라서 PublishSingleFile의 경우 저런 옵션을 변경하고 싶다면 단일 이미지 파일 생성 이전에, 즉 프로젝트 단계에서
runtimeconfig.template.json을 추가해야 합니다.
{
"configProperties": {
"System.GC.Concurrent": false,
}
}
혹은 같은 옵션이 csproj 프로젝트 파일에도 있다면 그걸 설정할 수 있는데요,
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
...[생략]...
<ConcurrentGarbageCollection>false</ConcurrentGarbageCollection>
</PropertyGroup>
</Project>
만약 런타임에 꼭 변경해야 할 필요가 있다면, 그때는 환경 변수를 이용하는 수밖에는 없습니다. 따라서 위와 같은 경우에는 아래와 같이 설정을 한 다음,
c:\temp> SET DOTNET_gcConcurrent=0
PublishSingleFile 옵션으로 배포한 파일을 실행해야 합니다.
정리해 보면, 런타임 옵션은 1) csproj로 설정하거나, 2) runtimeconfig.json으로 설정하거나, 3) 환경 변수로 설정하는 것이 가능하지만, 경우에 따라서는 꼭 3번 방법으로만 바꿀 수 있습니다.
[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]