Microsoft MVP성태의 닷넷 이야기
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 

(시리즈 글이 10개 있습니다.)
개발 환경 구성: 401. .NET Core 콘솔 응용 프로그램을 배포(publish) 시 docker image 자동 생성
; https://www.sysnet.pe.kr/2/0/11708

개발 환경 구성: 402. .NET Core 콘솔 응용 프로그램을 docker로 실행/디버깅하는 방법
; https://www.sysnet.pe.kr/2/0/11709

VS.NET IDE: 143. Visual Studio - ASP.NET Core Web Application의 "Enable Docker Support" 옵션으로 달라지는 점
; https://www.sysnet.pe.kr/2/0/12171

VS.NET IDE: 144. .NET Core 콘솔 응용 프로그램을 배포(publish) 시 docker image 자동 생성 - 두 번째 이야기
; https://www.sysnet.pe.kr/2/0/12197

VS.NET IDE: 185. Visual Studio - 원격 Docker container 내에 실행 중인 응용 프로그램에 대한 디버깅
; https://www.sysnet.pe.kr/2/0/13351

닷넷: 2156. .NET 7 이상의 콘솔 프로그램을 (dockerfile 없이) 로컬 docker에 배포하는 방법
; https://www.sysnet.pe.kr/2/0/13437

Linux: 69. 리눅스 - "Docker Desktop for Windows" Container 환경에서 IPv6 Loopback Address 바인딩 오류
; https://www.sysnet.pe.kr/2/0/13540

개발 환경 구성: 704. Visual Studio - .NET 8 프로젝트부터 dockerfile에 추가된 "USER app" 설정
; https://www.sysnet.pe.kr/2/0/13547

개발 환경 구성: 705. "Docker Desktop for Windows" - ASP.NET Core 응용 프로그램의 소켓 주소 바인딩(IPv4/IPv6 loopback, Any)
; https://www.sysnet.pe.kr/2/0/13548

개발 환경 구성: 706. C# - 컨테이너에서 실행하기 위한 (소켓) 콘솔 프로젝트 구성
; https://www.sysnet.pe.kr/2/0/13549




.NET 7 이상의 콘솔 프로그램을 (dockerfile 없이) 로컬 docker에 배포하는 방법

닷넷 프로젝트에 대한 docker 통합이 점점 쉬워지고 있군요, 아래의 문서를 보면,

Containerize a .NET app with dotnet publish
; https://learn.microsoft.com/en-us/dotnet/core/docker/publish-as-container

Announcing built-in container support for the .NET SDK
; https://devblogs.microsoft.com/dotnet/announcing-builtin-container-support-for-the-dotnet-sdk/

.NET 7부터 dockerfile 없이 docker에 배포하는 방법을 지원하고 있습니다. 쉽게 테스트를 해볼까요? ^^

예제를 위해 다음과 같은 콘솔 프로젝트를 하나 만들고,

namespace ConsoleApp1;

internal class Program
{
    static void Main(string[] args)
    {
        Console.WriteLine(Environment.CurrentDirectory);
        Console.WriteLine("Hello, World!");
    }
}

NuGet을 이용해 "Microsoft.NET.Build.Containers"를 참조 추가합니다. (다른 글에서 다루겠지만, ASP.NET 프로젝트의 경우에는 이 단계를 생략할 수 있습니다.)

[Package Manager Console]
Install-Package Microsoft.NET.Build.Containers -Version 7.0.403

[dotnet 명령행]
dotnet add package Microsoft.NET.Build.Containers

이후, dotnet 명령어의 publish 옵션으로 위의 콘솔 프로젝트를 곧바로 로컬 docker 환경에 image로 등록할 수 있습니다.

dotnet publish --os linux --arch x64 /t:PublishContainer -c Release

// PublishContainer는 "Microsoft.NET.Build.Containers"에서 지원하는 새로운 msbuild target입니다.

등록한 이미지의 크기는 대략 190MB 정도이고, 당연히 실행도 됩니다.

C:\temp> docker image ls
REPOSITORY     TAG      IMAGE ID       CREATED          SIZE
consoleapp1    1.0.0    848a4795daf6   6 seconds ago    190MB
...[생략]...

C:\temp> docker run consoleapp1:1.0.0
/app
Hello, World!




참고로, 근래에 .NET을 위한 다양한 이미지 파일들이 나오고 있습니다.

.NET Runtime Dependencies
; https://hub.docker.com/_/microsoft-dotnet-runtime-deps/

이러한 "runtime-deps" 이미지들의 특징은, ".NET 런타임"을 없애는 대신 런타임의 네이티브 의존성만을 가진 환경을 담고 있다는 점입니다. 따라서 "Self-contained" 유형의 응용 프로그램 배포에 사용할 수 있는데요, 이로 인해 csproj에 반드시 PublishSingleFile을 설정해야 합니다.

<Project Sdk="Microsoft.NET.Sdk">

    <PropertyGroup>
        <OutputType>Exe</OutputType>
        <TargetFramework>net7.0</TargetFramework>
        <ImplicitUsings>enable</ImplicitUsings>
        <Nullable>enable</Nullable>
    </PropertyGroup>

    <ItemGroup>
      <PackageReference Include="Microsoft.NET.Build.Containers" Version="7.0.403" />
    </ItemGroup>

    <PropertyGroup>
        <ContainerBaseImage>mcr.microsoft.com/dotnet/nightly/runtime-deps:7.0</ContainerBaseImage>
        
        <PublishSingleFile>true</PublishSingleFile>
        <RuntimeIdentifier>linux-x64</RuntimeIdentifier>
    </PropertyGroup>
    
</Project>

이렇게 바꾸고 배포하면,

dotnet publish /t:PublishContainer -c Release

이제는 이미지 크기가 184MB가 됩니다. 190MB에서 고작 6MB 줄은 것은 그다지 큰 매력이 없는데요, 재미있는 것은, 이 단계에서 닷넷 실행을 위한 최소한의 파일만 포함시킨 "Chiseled" 버전의 이미지를 (아직은 Preview지만) 배포한다는 점입니다.

Ubuntu Chiseled + .NET
; https://github.com/dotnet/dotnet-docker/blob/main/documentation/ubuntu-chiseled.md

그래서 이 이미지를 적용해 다시 배포하면,

<ContainerBaseImage>mcr.microsoft.com/dotnet/nightly/runtime-deps:7.0-jammy-chiseled</ContainerBaseImage>

// dotnet publish /t:PublishContainer -c Release

이제는 이미지 크기가 80MB 정도에 불과합니다. 이에 더해 아래의 글을 보면,

.NET 7 SDK built-in container support and Ubuntu Chiseled
; https://laurentkempe.com/2022/11/14/dotnet-7-sdk-built-in-container-support-and-ubuntu-chiseled/

PublishTrimmed과 InvariantGlobalization을 이용해 더욱 줄일 수 있다고 하는데요, 최종적으로 다음과 같은 csproj로,

<Project Sdk="Microsoft.NET.Sdk">

    <-- ...[생략]... -->

    <PropertyGroup>
        <ContainerBaseImage>mcr.microsoft.com/dotnet/nightly/runtime-deps:7.0-jammy-chiseled</ContainerBaseImage>

        <PublishSingleFile>true</PublishSingleFile>
        <RuntimeIdentifier>linux-x64</RuntimeIdentifier>
        
        <PublishTrimmed>true</PublishTrimmed>
        <InvariantGlobalization>true</InvariantGlobalization>
    </PropertyGroup>
    
</Project>

빌드하면,

dotnet publish /t:PublishContainer -c Release

이제 이미지의 크기는 26MB로 더 줄어듭니다.

c:\temp> docker image ls
REPOSITORY     TAG     IMAGE ID       CREATED         SIZE
consoleapp1    1.0.0   911ce7adb995   4 minutes ago   26.1MB

오호~~~ 이 정도면 괜찮은 크기죠! ^^




개인적인 의견으로, 사실 디버깅을 위해서라도 어차피 비주얼 스튜디오에서 "Docker Support..." 기능을 이용해 dockerfile을 생성할 것이므로,

.NET Core 콘솔 응용 프로그램을 배포(publish) 시 docker image 자동 생성 - 두 번째 이야기
; https://www.sysnet.pe.kr/2/0/12197

개발 중에는 이번 글에서 설명한 내용이 크게 의미는 없습니다. 단지, 개발을 완료한 시점에는 간편하게 배포하는 용도로 쓸 만할 것입니다.




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







[최초 등록일: ]
[최종 수정일: 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)
13541정성태1/29/20241009VS.NET IDE: 188. launchSettings.json의 useSSL 옵션
13540정성태1/29/20241132Linux: 69. 리눅스 - "Docker Desktop for Windows" Container 환경에서 IPv6 Loopback Address 바인딩 오류
13539정성태1/26/20241401개발 환경 구성: 703. Visual Studio - launchSettings.json을 이용한 HTTP/HTTPS 포트 바인딩
13538정성태1/25/20241531닷넷: 2211. C# - NonGC(FOH) 영역에 .NET 개체를 생성파일 다운로드1
13537정성태1/24/20241550닷넷: 2210. C# - Native 메모리에 .NET 개체를 생성파일 다운로드1
13536정성태1/23/20241646닷넷: 2209. .NET 8 - NonGC Heap / FOH (Frozen Object Heap) [1]
13535정성태1/22/20241490닷넷: 2208. C# - GCHandle 구조체의 메모리 분석
13534정성태1/21/20241313닷넷: 2207. C# - SQL Server DB를 bacpac으로 Export/Import파일 다운로드1
13533정성태1/18/20241378닷넷: 2206. C# - TCP KeepAlive의 서버 측 구현파일 다운로드1
13532정성태1/17/20241354닷넷: 2205. C# - SuperSimpleTcp 사용 시 주의할 점파일 다운로드1
13531정성태1/16/20241398닷넷: 2204. C# - TCP KeepAlive에 새로 추가된 Retry 옵션파일 다운로드1
13530정성태1/15/20241380닷넷: 2203. C# - Python과의 AES 암호화 연동파일 다운로드1
13529정성태1/15/20241282닷넷: 2202. C# - PublishAot의 glibc에 대한 정적 링킹하는 방법
13528정성태1/14/20241400Linux: 68. busybox 컨테이너에서 실행 가능한 C++, Go 프로그램 빌드
13527정성태1/14/20241296오류 유형: 892. Visual Studio - Failed to launch debug adapter. Additional information may be available in the output window.
13526정성태1/14/20241353닷넷: 2201. C# - Facebook 연동 / 사용자 탈퇴 처리 방법
13525정성태1/13/20241300오류 유형: 891. Visual Studio - Web Application을 실행하지 못하는 IISExpress
13524정성태1/12/20241334오류 유형: 890. 한국투자증권 KIS Developers OpenAPI - GW라우팅 중 오류가 발생했습니다.
13523정성태1/12/20241234오류 유형: 889. Visual Studio - error : A project with that name is already opened in the solution.
13522정성태1/11/20241328닷넷: 2200. C# - HttpClient.PostAsJsonAsync 호출 시 "Transfer-Encoding: chunked" 대신 "Content-Length" 헤더 처리
13521정성태1/11/20241456닷넷: 2199. C# - 한국투자증권 KIS Developers OpenAPI의 WebSocket Ping, Pong 처리
13520정성태1/10/20241276오류 유형: 888. C# - Unable to resolve service for type 'Microsoft.Extensions.ObjectPool.ObjectPool`....'
13519정성태1/10/20241347닷넷: 2198. C# - Reflection을 이용한 ClientWebSocket의 Ping 호출파일 다운로드1
13518정성태1/9/20241467닷넷: 2197. C# - ClientWebSocket의 Ping, Pong 처리
13517정성태1/8/20241358스크립트: 63. Python - 공개 패키지를 이용한 위성 이미지 생성 (pystac_client, odc.stac)
13516정성태1/7/20241489닷넷: 2196. IIS - AppPool의 "Disable Overlapped Recycle" 옵션의 부작용
1  [2]  3  4  5  6  7  8  9  10  11  12  13  14  15  ...