.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
개발 중에는 이번 글에서 설명한 내용이 크게 의미는 없습니다. 단지, 개발을 완료한 시점에는 간편하게 배포하는 용도로 쓸 만할 것입니다.
[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]