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

.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번 방법으로만 바꿀 수 있습니다.




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

[연관 글]






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

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)
13338정성태5/6/2023297.NET Framework: 2112. C# 12 - 람다 식의 선택적 매개 변수파일 다운로드1
13337정성태5/5/2023212Linux: 59. dockerfile - docker exec로 container에 접속 시 자동으로 실행되는 코드 적용
13336정성태5/4/2023206.NET Framework: 2111. C# - 바이너리 출력 디렉터리와 연관된 csproj 설정
13335정성태4/30/2023319.NET Framework: 2110. C# - FFmpeg.AutoGen 라이브러리를 이용한 기본 프로젝트 구성 - Windows Forms파일 다운로드1
13334정성태4/29/2023296Windows: 250. Win32 C/C++ - Modal 메시지 루프 내에서 SetWindowsHookEx를 이용한 Thread 메시지 처리 방법
13333정성태4/28/2023215Windows: 249. Win32 C/C++ - 대화창 템플릿을 런타임에 코딩해서 사용파일 다운로드1
13332정성태4/27/2023250Windows: 248. Win32 C/C++ - 대화창을 위한 메시지 루프 사용자 정의파일 다운로드1
13331정성태4/27/2023208오류 유형: 856. dockerfile - 구 버전의 .NET Core 이미지 사용 시 apt update 오류
13330정성태4/26/2023211Windows: 247. Win32 C/C++ - CS_GLOBALCLASS 설명
13329정성태4/24/2023243Windows: 246. Win32 C/C++ - 직접 띄운 대화창 템플릿을 위한 Modal 메시지 루프 생성파일 다운로드1
13328정성태4/19/2023295VS.NET IDE: 184. Visual Studio - Fine Code Coverage에서 동작하지 않는 Fake/Shim 테스트
13327정성태4/19/2023379VS.NET IDE: 183. C# - .NET Core/5+ 환경에서 Fakes를 이용한 단위 테스트 방법
13326정성태4/18/2023536.NET Framework: 2109. C# - 닷넷 응용 프로그램에서 SQLite 사용 (System.Data.SQLite) [1]파일 다운로드1
13325정성태4/18/2023432스크립트: 48. 파이썬 - PostgreSQL의 with 문을 사용한 경우 연결 개체 누수
13324정성태4/17/2023372.NET Framework: 2108. C# - Octave의 "save -binary ..."로 생성한 바이너리 파일 분석파일 다운로드1
13323정성태4/16/2023400개발 환경 구성: 677. Octave에서 Excel read/write를 위한 io 패키지 설치
13322정성태4/15/2023506VS.NET IDE: 182. Visual Studio - 32비트로만 빌드된 ActiveX와 작업해야 한다면?
13321정성태4/14/2023357개발 환경 구성: 676. WSL/Linux Octave - Python 스크립트 연동
13320정성태4/13/2023329개발 환경 구성: 675. Windows Octave 8.1.0 - Python 스크립트 연동
13319정성태4/12/2023445개발 환경 구성: 674. WSL 2 환경에서 GNU Octave 설치
13318정성태4/11/2023407개발 환경 구성: 673. JetBrains IDE에서 "Squash Commits..." 메뉴가 비활성화된 경우
13317정성태4/11/2023367오류 유형: 855. WSL 2 Ubuntu 20.04 - error: cannot communicate with server: Post http://localhost/v2/snaps/...
13316정성태4/10/2023505오류 유형: 854. docker-compose 시 "json.decoder.JSONDecodeError: Expecting value: line 1 column 1 (char 0)" 오류 발생
13315정성태4/10/2023348Windows: 245. Win32 - 시간 만료를 갖는 컨텍스트 메뉴와 윈도우 메시지의 영역별 정의파일 다운로드1
13314정성태4/9/2023402개발 환경 구성: 672. DosBox를 이용한 Turbo C, Windows 3.1 설치
13313정성태4/9/2023421개발 환경 구성: 671. Hyper-V VM에 Turbo C 2.0 설치 [2]
1  [2]  3  4  5  6  7  8  9  10  11  12  13  14  15  ...