.NET 앱 참조 컨테이너화

이 참조 문서에서는 .NET 앱을 컨테이너로 게시할 때 생성된 컨테이너 이미지를 구성하는 방법에 대해 알아봅니다. 이 문서에서는 컨테이너가 시작될 때 실행되는 이미지, 실행 환경 및 명령을 제어하도록 설정할 수 있는 다양한 속성에 대해 설명합니다.

컨테이너 속성 구성

MSBuild 속성을 통해 생성된 컨테이너의 여러 측면을 제어할 수 있습니다. 일반적으로 Dockerfile 에서 명령을 사용하여 일부 구성을 설정할 수 있는 경우 MSBuild를 통해 동일한 작업을 수행할 수 있습니다.

메모

이에 대한 유일한 예외는 RUN 명령입니다. 컨테이너를 빌드하는 방식으로 인해 해당 명령을 에뮬레이트할 수 없습니다. 이 기능이 필요한 경우 Dockerfile 을 사용하여 컨테이너 이미지를 빌드하는 것이 좋습니다.

.NET SDK를 사용하여 RUN 명령을 수행할 수 있는 방법은 없습니다. 이러한 명령은 종종 일부 OS 패키지를 설치하거나 새 OS 사용자 또는 임의의 항목을 만드는 데 사용됩니다. .NET SDK 컨테이너 빌드 기능을 계속 사용하려는 경우 이러한 변경 내용으로 사용자 지정 기본 이미지를 만든 다음 이 기본 이미지를 사용할 수 있습니다. 자세한 내용은 ContainerBaseImage참조하세요.

기본 이미지를 제어하는 플래그

다음 속성은 컨테이너에 사용되는 기본 이미지와 선택한 방법을 제어합니다.

ContainerBaseImage
ContainerFamily
ContainerRuntimeIdentifier(s)

`ContainerBaseImage`

컨테이너 기본 이미지 속성은 이미지의 기준으로 사용되는 이미지를 제어합니다. 기본적으로 다음 값은 프로젝트의 속성에 따라 유추됩니다.

프로젝트가 자체 포함된 경우 mcr.microsoft.com/dotnet/runtime-deps 이미지가 기본 이미지로 사용됩니다.
프로젝트가 ASP.NET Core 프로젝트인 경우 mcr.microsoft.com/dotnet/aspnet 이미지가 기본 이미지로 사용됩니다.
그렇지 않으면 mcr.microsoft.com/dotnet/runtime 이미지가 기본 이미지로 사용됩니다.

이미지의 태그는 선택한 TargetFramework숫자 구성 요소로 유추됩니다. 예를 들어 net6.0 대상으로 하는 프로젝트는 유추된 기본 이미지의 6.0 태그를 생성하고 net7.0-linux 프로젝트는 7.0 태그 등을 사용합니다.

여기서 값을 설정하는 경우 원하는 태그를 포함하여 기본으로 사용할 이미지의 정규화된 이름을 설정해야 합니다.

<PropertyGroup>
    <ContainerBaseImage>mcr.microsoft.com/dotnet/runtime:8.0</ContainerBaseImage>
</PropertyGroup>

.NET SDK 버전 8.0.200을 사용하면 크기 및 보안을 최적화하기 위해 ContainerBaseImage 유추가 향상됩니다.

linux-musl-x64 또는 linux-musl-arm64 런타임 식별자를 대상으로 지정하면 alpine 이미지 변형을 자동으로 선택하여 프로젝트가 실행되도록 합니다.
- 프로젝트에서 PublishAot=true 사용하는 경우 최상의 크기와 보안을 위해 기본 이미지의 nightly/runtime-depsjammy-chiseled-aot 변형입니다.
- 프로젝트에서 InvariantGlobalization=false 사용하는 경우 -extra 변형을 사용하여 지역화가 계속 작동하는지 확인합니다.

이미지 변형 크기 및 특성에 대한 자세한 내용은 .NET 8.0 컨테이너 이미지 크기 보고서를 참조하세요.

`ContainerFamily`

.NET 8부터 ContainerFamily MSBuild 속성을 사용하여 다른 Microsoft 제공 컨테이너 이미지 제품군을 앱의 기본 이미지로 선택할 수 있습니다. 이 값을 설정하면 선택한 TFM별 태그의 끝에 이 값이 추가되고 제공된 태그가 변경됩니다. 예를 들어 .NET 기본 이미지의 Alpine Linux 변형을 사용하려면 ContainerFamilyalpine설정할 수 있습니다.

<PropertyGroup>
    <ContainerFamily>alpine</ContainerFamily>
</PropertyGroup>

위의 프로젝트 구성은 .NET 8 대상 앱에 대한 최종 8.0-alpine 태그를 생성합니다.

이 필드는 자유 형식이며 종종 다른 운영 체제 배포, 기본 패키지 구성 또는 기본 이미지에 대한 다른 변경 내용을 선택하는 데 사용할 수 있습니다. 이 필드는 ContainerBaseImage 설정되면 무시됩니다. 자세한 내용은 .NET 컨테이너 이미지참조하세요.

`ContainerRuntimeIdentifier(s)`

ContainerRuntimeIdentifier 여러 플랫폼을 지원하는 경우 ContainerBaseImage 속성은 컨테이너에 대한 OS 및 아키텍처를 지정합니다. 예를 들어 mcr.microsoft.com/dotnet/runtime 이미지는 linux-x64, linux-arm, linux-arm64및 win10-x64지원합니다. 기본적으로 컨테이너를 게시할 때 사용되는 RuntimeIdentifier 설정됩니다. 일반적으로 이 속성을 명시적으로 설정할 필요가 없습니다. 대신 -r 명령과 함께 dotnet publish 옵션을 사용합니다. 선택한 이미지가 지정된 RuntimeIdentifier지원하지 않으면 지원되는 식별자를 나타내는 오류가 발생합니다.

이 속성을 사용하지 않도록 항상 ContainerBaseImage 속성을 태그를 포함한 정규화된 이미지 이름으로 설정할 수 있습니다.

<PropertyGroup>
    <ContainerRuntimeIdentifier>linux-arm64</ContainerRuntimeIdentifier>
</PropertyGroup>

다중 아키텍처 이미지에 대해 여러 컨테이너 런타임 식별자를 지정하려면 여러 ContainerRuntimeIdentifiers설정하는 것과 유사하게 TargetFrameworks 속성에 세미콜론으로 구분된 런타임 식별자 집합을 사용합니다.

<PropertyGroup>
    <ContainerRuntimeIdentifiers>linux-x64;linux-arm64</ContainerRuntimeIdentifiers>
</PropertyGroup>

중요하다

속성은 ContainerRuntimeIdentifiers 속성의 RuntimeIdentifiers 하위 집합이어야 합니다. 이 조건이 충족되지 않으면 빌드 파이프라인의 중요한 부분이 실패할 수 있습니다.

여러 ContainerRuntimeIdentifiers 아키텍처를 설정하면 다중 아키텍처 이미지가 만들어집니다. 자세한 내용은 다중 아키텍처 이미지를 참조하세요.

.NET에서 지원하는 런타임 식별자에 대한 자세한 내용은 RID 카탈로그를 참조하세요.

다중 아키텍처 이미지

다중 아키텍처 이미지를 사용하면 단일 컨테이너 이미지가 여러 아키텍처를 지원할 수 있으므로 플랫폼 간 개발 및 배포가 간소화됩니다. .NET SDK는 속성을 통해 ContainerRuntimeIdentifiers 이를 지원합니다.

SDK 버전 8.0.405, 9.0.102 및 9.0.2xx부터 다중 RID 컨테이너 게시가 지원됩니다. 다음을 사용하여 /t:PublishContainer게시하는 경우:

단일 RuntimeIdentifierContainerRuntimeIdentifier 또는 지정된 경우 단일 아키텍처 컨테이너가 이전과 같이 생성됩니다.
단일 RuntimeIdentifier 이 지정되지 않았지만 여러 RuntimeIdentifiers 개 또는 ContainerRuntimeIdentifiers 설정된 경우 SDK는 지정된 각 RID에 대한 앱을 게시하고 결과 이미지를 OCI 이미지 인덱스에 결합합니다. 이 인덱스를 사용하면 여러 아키텍처별 이미지가 단일 이름을 공유할 수 있습니다.

메모

속성은 ContainerRuntimeIdentifiers 속성의 RuntimeIdentifiers 하위 집합이어야 합니다. 자세한 내용은 ContainerRuntimeIdentifiers를 참조하세요.

이 기능은 혼합 아키텍처 환경에서 컨테이너 워크플로를 간소화합니다. 예를 들어 호스트의 개발자 linux-x64 는 둘 다 linux-x64 지원하는 컨테이너를 게시할 수 있으며 linux-arm64, 이미지 이름이나 레이블을 변경하지 않고 아키텍처에 배포할 수 있습니다.

생성된 OCI 이미지 인덱스는 최신 컨테이너 도구로 널리 지원되어 호환성과 사용 편의성을 향상합니다.

생성된 이미지 독립적 메타데이터를 제어하는 플래그

다음 속성은 대상 런타임 식별자에 관계없이 생성된 컨테이너 이미지에 적용되는 메타데이터 및 구성을 제어합니다.

ContainerImageFormat
ContainerImageTag
ContainerLabel
ContainerRepository

`ContainerImageFormat`

MSBuild 속성을 사용하여 ContainerImageFormat 이미지 형식을 하나 Docker 또는 OCI.로 지정할 수 있습니다. 기본적으로 .NET 도구는 기본 이미지의 형식을 유추합니다. 예를 들어 .NET 기본 이미지는 Docker 관련 형식 application/vnd.docker.distribution.manifest.v2+json을 사용합니다. 그러나 많은 최신 도구는 OCI 형식을 선호합니다 application/vnd.oci.image.manifest.v1+json. 특정 형식을 강제로 적용하려면 다음과 같이 속성을 설정합니다.

<PropertyGroup>
  <ContainerImageFormat>OCI</ContainerImageFormat>
</PropertyGroup>

두 형식 모두 정보 손실 없이 대체로 서로 교환할 수 있습니다.

메모

다중 아키텍처 이미지를 빌드할 때 결과 이미지 형식은 항상 OCI입니다.

`ContainerImageTag`

컨테이너 이미지 태그 속성은 이미지에 대해 생성된 태그를 제어합니다. 단일 태그를 지정하려면 ContainerImageTag 사용하고 여러 태그에는 ContainerImageTags사용합니다.

중요하다

사용하면 ContainerImageTags고유한 태그당 하나씩 여러 개의 이미지가 표시됩니다.

태그는 종종 다른 버전의 앱을 참조하는 데 사용되지만 다른 운영 체제 배포 또는 다른 구성을 참조할 수도 있습니다.

.NET 8부터 태그가 제공되지 않는 경우 기본값은 latest.

기본값을 재정의하려면 다음 속성 중 하나를 지정합니다.

<PropertyGroup>
    <ContainerImageTag>1.2.3-alpha2</ContainerImageTag>
</PropertyGroup>

여러 태그를 지정하려면 여러 ContainerImageTags설정하는 것과 유사하게 TargetFrameworks 속성에 세미콜론으로 구분된 태그 집합을 사용합니다.

<PropertyGroup>
    <ContainerImageTags>1.2.3-alpha2;latest</ContainerImageTags>
</PropertyGroup>

태그에는 최대 127개의 영숫자 문자, 마침표, 밑줄 및 대시만 포함될 수 있습니다. 영숫자 문자 또는 밑줄로 시작해야 합니다. 다른 양식에서는 오류가 발생합니다.

메모

사용 중이거나 구분된 값이 ContainerImageTags필요한 MSBuild 속성을 사용하는 ; 경우 특히 CI/CD 환경에서 명령줄에서 호출 dotnet publish 할 때 적절한 이스케이프를 보장합니다. 이스케이프 규칙은 PowerShell과 Bash 간에 다릅니다. 다음은 그 예입니다.

dotnet publish --os linux --arch x64 /t:PublishContainer /p:ContainerImageTags=`"1.2.3-alpha2`;latest`"

PowerShell에서 ; 문자와 " 문자를 모두 이스케이프해야 합니다.

dotnet publish --os linux --arch x64 /t:PublishContainer /p:ContainerImageTags='"1.2.3-alpha2;latest"'

Bash에서는 " 문자만 이스케이프해야 합니다.

그러면 my-app:1.2.3-alpha2 및 my-app:latest두 개의 이미지가 생성됩니다.

팁

ContainerImageTags 속성에 문제가 발생하는 경우 환경 변수 ContainerImageTags 범위를 지정하는 것이 좋습니다.

$Env:ContainerImageTags='1.2.3;latest'; dotnet publish --os linux --arch x64 /t:PublishContainer

`ContainerLabel`

컨테이너 레이블은 컨테이너에 메타데이터 레이블을 추가합니다. 레이블은 종종 보안 스캐너 및 기타 인프라 도구에서 사용할 버전 및 제작 메타데이터를 저장하는 데 사용됩니다. 원하는 수의 컨테이너 레이블을 지정할 수 있습니다.

ContainerLabel 노드에는 두 가지 특성이 있습니다.

Include: 레이블의 키입니다.
Value: 레이블의 값입니다(비어 있을 수 있음).

<ItemGroup>
    <ContainerLabel Include="org.contoso.businessunit" Value="contoso-university" />
</ItemGroup>

기본적으로 생성되는 레이블 목록은기본 컨테이너 레이블을 참조하세요.

`ContainerRepository`

컨테이너 리포지토리는 이미지 자체의 이름(예: dotnet/runtime 또는 my-app)입니다. 기본적으로 프로젝트의 AssemblyName 사용됩니다.

<PropertyGroup>
    <ContainerRepository>my-app</ContainerRepository>
</PropertyGroup>

이미지 이름은 하나 이상의 슬래시로 구분된 세그먼트로 구성되며, 각 세그먼트는 소문자 영숫자, 마침표, 밑줄 및 대시만 포함할 수 있으며 문자 또는 숫자로 시작해야 합니다. 다른 문자는 오류가 발생합니다.

실행 메타데이터를 제어하는 플래그

다음 속성은 런타임별 실행 동작 및 다중 아키텍처 이미지 생성을 제어합니다.

ContainerAppCommand
ContainerAppCommandArgs
ContainerAppCommandInstruction
ContainerDefaultArgs
ContainerEnvironmentVariable
ContainerPort
ContainerPublishInParallel
ContainerUser
ContainerWorkingDirectory

`ContainerAppCommand`

앱 명령 구성 항목은 앱의 논리적 진입점입니다. 대부분의 앱에서 앱에 대해 생성된 실행 파일 이진 파일인 AppHost입니다. 앱에서 AppHost를 생성하지 않는 경우 이 명령은 일반적으로 dotnet <your project dll>. 이러한 값은 기본 컨테이너의 ENTRYPOINT 이후 또는 ENTRYPOINT 정의되지 않은 경우 직접 적용됩니다.

ContainerAppCommand 구성에는 진입점 명령에 사용할 명령, 옵션 또는 인수를 나타내는 단일 Include 속성이 있습니다.

<ItemGroup Label="ContainerAppCommand Assignment">
  <!-- This is how you would start the dotnet ef tool in your container -->
  <ContainerAppCommand Include="dotnet" />
  <ContainerAppCommand Include="ef" />

  <!-- This shorthand syntax means the same thing, note the semicolon separating the tokens. -->
  <ContainerAppCommand Include="dotnet;ef" />
</ItemGroup>

`ContainerAppCommandArgs`

이 앱 명령 인수 구성 항목은 ContainerAppCommand적용해야 하는 앱에 대해 논리적으로 필요한 인수를 나타냅니다. 기본적으로 앱에 대해 생성되는 항목은 없습니다. 있는 경우 인수는 실행 시 컨테이너에 적용됩니다.

ContainerAppCommandArgs 구성에는 Include 명령에 적용할 옵션 또는 인수를 나타내는 단일 ContainerAppCommand 속성이 있습니다.

<ItemGroup>
  <!-- Assuming the ContainerAppCommand defined above,
       this would be the way to force the database to update.
  -->
  <ContainerAppCommandArgs Include="database" />
  <ContainerAppCommandArgs Include="update" />

  <!-- This is the shorthand syntax for the same idea -->
  <ContainerAppCommandArgs Include="database;update" />
</ItemGroup>

`ContainerAppCommandInstruction`

앱 명령 명령 구성은 ContainerEntrypoint, ContainerEntrypointArgs, ContainerAppCommand, ContainerAppCommandArgs및 ContainerDefaultArgs 결합하여 컨테이너에서 실행되는 최종 명령을 구성하는 방법을 제어하는 데 도움이 됩니다. 이는 기본 이미지에 ENTRYPOINT 있는지여부에 따라 크게 달라집니다. 이 속성은 "DefaultArgs", "Entrypoint"또는 "None"세 가지 값 중 하나를 사용합니다.

Entrypoint:
- 이 모드에서 진입점은 ContainerAppCommand, ContainerAppCommandArgs및 ContainerDefaultArgs의해 정의됩니다.
None:
- 이 모드에서 진입점은 ContainerEntrypoint, ContainerEntrypointArgs및 ContainerDefaultArgs의해 정의됩니다.
DefaultArgs:
- 가장 복잡한 모드입니다. ContainerEntrypoint[Args] 항목이 없으면 ContainerAppCommand[Args] 및 ContainerDefaultArgs 사용하여 진입점 및 명령을 만듭니다. dotnet 또는 /usr/bin/dotnet 하드 코딩된 기본 이미지의 기본 이미지 진입점은 완전히 제어할 수 있도록 건너뜁히게 됩니다.
- ContainerEntrypoint 및 ContainerAppCommand 모두 있는 경우 ContainerEntrypoint 진입점이 되고 ContainerAppCommand 명령이 됩니다.

메모

ContainerEntrypoint 및 ContainerEntrypointArgs 구성 항목은 .NET 8을 기준으로 더 이상 사용되지 않습니다.

중요하다

이는 고급 사용자용입니다. 대부분의 앱은 진입점을 이 정도까지 사용자 지정할 필요가 없습니다. 자세한 내용 및 시나리오에 대한 사용 사례를 제공하려는 경우 GitHub: .NET SDK 컨테이너 빌드 토론을 참조하세요.

`ContainerDefaultArgs`

이 기본 인수 구성 항목은 앱에 대해 사용자가 재정의할 수 있는 인수를 나타냅니다. 이는 앱을 쉽게 시작할 수 있지만 사용자 지정하기 쉬운 방식으로 실행해야 하는 기본값을 제공하는 좋은 방법입니다.

ContainerDefaultArgs 구성에는 Include 명령에 적용할 옵션 또는 인수를 나타내는 단일 ContainerAppCommand 속성이 있습니다.

<ItemGroup>
  <!-- Assuming the ContainerAppCommand defined above,
       this would be the way to force the database to update.
  -->
  <ContainerDefaultArgs Include="database" />
  <ContainerDefaultArgs Include="update" />

  <!-- This is the shorthand syntax for the same idea -->
  <ContainerDefaultArgs Include="database;update" />
</ItemGroup>

`ContainerEnvironmentVariable`

컨테이너 환경 변수 노드를 사용하면 컨테이너에 환경 변수를 추가할 수 있습니다. 환경 변수는 컨테이너에서 실행되는 앱에 즉시 액세스할 수 있으며 실행 중인 앱의 런타임 동작을 변경하는 데 자주 사용됩니다.

ContainerEnvironmentVariable 노드에는 두 가지 특성이 있습니다.

Include: 환경 변수의 이름입니다.
Value: 환경 변수의 값입니다.

<ItemGroup>
  <ContainerEnvironmentVariable Include="LOGGER_VERBOSITY" Value="Trace" />
</ItemGroup>

자세한 내용은 .NET 환경 변수참조하세요.

메모

현재 컨테이너 이미지를 게시할 때 .NET CLI에서 환경 변수를 설정할 수 없습니다. 자세한 내용은 GitHub: .NET SDK 컨테이너 빌드를 참조하세요.

`ContainerPort`

컨테이너 포트는 컨테이너의 알려진 포트 목록에 TCP(Transmission Control Protocol) 또는 UDP(사용자 데이터그램 프로토콜) 포트를 추가합니다. 이렇게 하면 Docker와 같은 컨테이너 런타임에서 이러한 포트를 호스트 컴퓨터에 자동으로 매핑할 수 있습니다. 컨테이너에 대한 설명서로 자주 사용되지만 자동 포트 매핑을 사용하도록 설정하는 데도 사용할 수 있습니다.

ContainerPort 노드에는 두 가지 특성이 있습니다.

Include: 노출할 포트 번호입니다.
Type: 기본값은 tcp, 유효한 값은 tcp 또는 udp.

<ItemGroup>
    <ContainerPort Include="80" Type="tcp" />
</ItemGroup>

.NET 8부터는 잘 알려진 몇 가지 ASP.NET 환경 변수를 기반으로 명시적으로 제공되지 않은 경우 ContainerPort 유추됩니다.

ASPNETCORE_URLS
ASPNETCORE_HTTP_PORTS
ASPNETCORE_HTTPS_PORTS

이러한 환경 변수가 있는 경우 해당 값은 구문 분석되고 TCP 포트 매핑으로 변환됩니다. 이러한 환경 변수는 기본 이미지(있는 경우) 또는 프로젝트에 정의된 환경 변수에서 ContainerEnvironmentVariable 항목을 통해 읽습니다. 자세한 내용은 ContainerEnvironmentVariable을 참조하세요.

`ContainerPublishInParallel`

다중 RID 컨테이너의 경우 특정 프로젝트 형식(예: Blazor WebAssembly)에 빌드 경합 조건이 발생할 수 있습니다. 이 문제를 해결하려면 .NET SDK 버전 8.0.408, 9.0.300 및 10.0부터 속성을 사용하여 ContainerPublishInParallel 게시 프로세스의 병렬 처리를 제어할 수 있습니다. 기본적으로 게시는 RID(각 런타임 식별자)에 대해 병렬로 발생합니다. 이 속성을 설정하면 false 순차 게시가 보장되어 안정성이 향상되지만 시간이 더 오래 걸릴 수 있습니다.

<PropertyGroup>
  <ContainerPublishInParallel>false</ContainerPublishInParallel>
</PropertyGroup>

다중 RID 게시에 대한 자세한 내용은 ContainerRuntimeIdentifier를 참조하세요.

`ContainerUser`

사용자 구성 속성은 컨테이너가 실행되는 기본 사용자를 제어합니다. 이는 종종 보안을 위한 모범 사례인 루트가 아닌 사용자로 컨테이너를 실행하는 데 사용됩니다. 이 구성에 대해 알아야 할 몇 가지 제약 조건이 있습니다.

사용자 이름, Linux 사용자 ID, 그룹 이름, Linux 그룹 ID, username:groupname및 기타 ID 변형 등 다양한 형식을 사용할 수 있습니다.
지정된 사용자 또는 그룹이 이미지에 있는지 확인하지 않습니다.
사용자를 변경하면 특히 파일 시스템 권한과 관련해서 앱의 동작이 변경됩니다.

이 필드의 기본값은 프로젝트 TFM 및 대상 운영 체제에 따라 다릅니다.

.NET 8 이상을 대상으로 하고 Microsoft 런타임 이미지를 사용하는 경우 다음을 수행합니다.
- Linux에서 루트 없는 사용자 app 사용됩니다(사용자 ID로 참조됨).
- Windows에서 루트 없는 사용자 ContainerUser 사용됩니다.
그렇지 않으면 기본 ContainerUser 사용되지 않습니다.

<PropertyGroup>
  <ContainerUser>my-existing-app-user</ContainerUser>
</PropertyGroup>

팁

APP_UID 환경 변수는 컨테이너에서 사용자 정보를 설정하는 데 사용됩니다. 이 값은 기본 이미지에 정의된 환경 변수(예: Microsoft .NET 이미지처럼)에서 비롯되거나 ContainerEnvironmentVariable 구문을 통해 직접 설정할 수 있습니다.

루트 사용자로 실행되도록 앱을 구성하려면 ContainerUser 속성을 root. 프로젝트 파일에 다음을 추가합니다.

<PropertyGroup>
  <ContainerUser>root</ContainerUser>
</PropertyGroup>

또는 명령줄에서 dotnet publish 호출할 때 이 값을 설정할 수 있습니다.

dotnet publish -p ContainerUser=root

`ContainerWorkingDirectory`

컨테이너 작업 디렉터리 노드는 컨테이너의 작업 디렉터리를 제어합니다. 다른 명령이 실행되지 않는 경우 명령이 실행되는 디렉터리입니다.

기본적으로 /app 디렉터리 값은 작업 디렉터리로 사용됩니다.

<PropertyGroup>
    <ContainerWorkingDirectory>/bin</ContainerWorkingDirectory>
</PropertyGroup>

생성된 이미지의 대상을 제어하는 플래그

다음 속성은 생성된 컨테이너 이미지가 저장되거나 게시되는 위치를 제어합니다.

ContainerArchiveOutputPath
ContainerRegistry
LocalRegistry

`ContainerArchiveOutputPath`

tar.gz 보관 파일 내에 컨테이너 이미지를 만들려면 이 속성을 사용합니다ContainerArchiveOutputPath. 이 기능은 워크플로가 간단하지 않고 이미지를 푸시하기 전에 이미지에 대해 검사 도구를 실행해야 하는 경우에 유용합니다. 보관이 만들어지면 이동하거나, 스캔하거나, 로컬 Docker 도구 체인에 로드할 수 있습니다.

보관 파일에 게시하려면 ContainerArchiveOutputPath 명령에 dotnet publish 속성을 추가합니다. 예를 들면 다음과 같습니다.

dotnet publish \
  -p PublishProfile=DefaultContainer \
  -p ContainerArchiveOutputPath=./images/sdk-container-demo.tar.gz

폴더 이름 또는 특정 파일 이름을 가진 경로를 지정할 수 있습니다. 폴더 이름을 지정하면 이미지 보관 파일에 대해 생성된 파일 이름이 $(ContainerRepository).tar.gz. 이러한 보관 파일에는 모든 ContainerImageTags대해 단일 파일이 생성되므로 내부에 여러 태그가 포함될 수 있습니다.

`ContainerRegistry`

컨테이너 레지스트리 속성은 새로 만든 이미지를 푸시할 위치인 대상 레지스트리를 제어합니다. 기본적으로 로컬 Docker 디먼으로 푸시되지만 원격 레지스트리를 지정할 수도 있습니다. 인증이 필요한 원격 레지스트리를 사용하는 경우 잘 알려진 docker login 메커니즘을 사용하여 인증합니다. 자세한 내용은 컨테이너 레지스트리 인증하는 참조하세요. 이 속성을 사용하는 구체적인 예제는 다음 XML 예제를 참조하세요.

<PropertyGroup>
    <ContainerRegistry>registry.mycorp.com:1234</ContainerRegistry>
</PropertyGroup>

이 도구는 Docker 레지스트리 HTTP API V2를 지원하는 모든 레지스트리에 게시를 지원합니다. 여기에는 다음 레지스트리가 명시적으로 포함되며 암시적으로 더 많을 수 있습니다.

Azure Container Registry
amazon Elastic Container Registry
Google Artifact Registry
docker Hub
GitHub 패키지
GitLab 호스팅 Container Registry
Quay.io

이러한 레지스트리 작업에 대한 참고 사항은레지스트리 관련 참고 사항을 참조하세요.

`LocalRegistry`

MSBuild 속성은 LocalRegistry 로컬 원본으로 푸시할 때 사용할 로컬 컨테이너 도구를 지정합니다. 지원되는 값은 dockerpodman. 설정되지 않은 경우 SDK는 가용성에 따라 도구를 결정합니다.

둘 다 docker 존재하고 podmandocker 별칭 podmanpodman 이면 사용됩니다.
존재하는 docker 경우에만 docker 사용됩니다.
존재하는 podman 경우에만 podman 사용됩니다.
둘 다 없으면 오류가 throw됩니다.

로컬 레지스트리 도구를 명시적으로 설정하려면 다음 구성을 사용합니다.

<PropertyGroup>
  <LocalRegistry>podman</LocalRegistry>
</PropertyGroup>

컨테이너 이미지 명명 구성

컨테이너 이미지는 특정 명명 규칙을 따릅니다. 이미지의 이름은 여러 부분, 레지스트리, 선택적 포트, 리포지토리 및 선택적 태그 및 패밀리로 구성됩니다.

REGISTRY[:PORT]/REPOSITORY[:TAG[-FAMILY]]

예를 들어 정규화된 mcr.microsoft.com/dotnet/runtime:8.0-alpine 이미지 이름을 고려합니다.

mcr.microsoft.com 레지스트리입니다(이 경우 Microsoft 컨테이너 레지스트리를 나타낸다).
dotnet/runtime 리포지토리입니다(그러나 일부는 user/repository고려).
8.0-alpine 태그 및 패밀리입니다(패밀리는 OS 패키징을 명확하게 하는 데 도움이 되는 선택적 지정자입니다).

다음 섹션에서 설명하는 일부 속성은 생성된 이미지 이름의 일부를 관리하는 데 해당합니다. 이미지 이름과 빌드 속성 간의 관계를 매핑하는 다음 테이블을 고려합니다.

이미지 이름 부분	MSBuild 속성	예제 값
`REGISTRY[:PORT]`	`ContainerRegistry`	`mcr.microsoft.com:443`
`PORT`	`ContainerPort`	`:443`
`REPOSITORY`	`ContainerRepository`	`dotnet/runtime`
`TAG`	`ContainerImageTag`	`8.0`
`FAMILY`	`ContainerFamily`	`-alpine`

기본 컨테이너 레이블

레이블은 컨테이너 이미지에 일관된 메타데이터를 제공하는 데 자주 사용됩니다. 기본 제공 컨테이너 도구는 생성된 이미지의 품질을 높이기 위해 몇 가지 기본 레이블을 제공합니다. 로 설정하여 모든 기본 레이블 생성을 ContainerGenerateLabels사용하지 않도록 설정할 false 수 있습니다. 또한 각 기본 레이블에는 해당 특정 레이블을 사용하지 않도록 설정할 false 수 있는 개별 사용 플래그가 있습니다.

가능한 경우 기존 MSBuild 속성은 이러한 레이블에 대한 값을 제공합니다. 다른 속성을 사용하면 해당 값을 명시적으로 제어할 수 있습니다.

주석	기본값	전용 속성 이름	대체 속성 이름	사용 속성 이름	비고
`org.opencontainers.image.created` 및 `org.opencontainers.artifact.created`	현재 UTC DateTime의 RFC 3339 형식			`ContainerGenerateLabelsImageCreated`
`org.opencontainers.artifact.description` 및 `org.opencontainers.image.description`		`ContainerDescription`	`Description`	`ContainerGenerateLabelsImageDescription`
`org.opencontainers.image.authors`		`ContainerAuthors`	`Authors`	`ContainerGenerateLabelsImageAuthors`
`org.opencontainers.image.url`		`ContainerInformationUrl`	`PackageProjectUrl`	`ContainerGenerateLabelsImageUrl`
`org.opencontainers.image.documentation`		`ContainerDocumentationUrl`	`PackageProjectUrl`	`ContainerGenerateLabelsImageDocumentation`
`org.opencontainers.image.version`		`ContainerVersion`	`PackageVersion`	`ContainerGenerateLabelsImageVersion`
`org.opencontainers.image.vendor`		`ContainerVendor`		`ContainerGenerateLabelsImageVendor`
`org.opencontainers.image.licenses`		`ContainerLicenseExpression`	`PackageLicenseExpression`	`ContainerGenerateLabelsImageLicenses`
`org.opencontainers.image.title`		`ContainerTitle`	`Title`	`ContainerGenerateLabelsImageTitle`
`org.opencontainers.image.base.name`		`ContainerBaseImage`		`ContainerGenerateLabelsImageBaseName`
`org.opencontainers.image.base.digest`				`ContainerGenerateLabelsImageBaseDigest`	선택한 기본 이미지의 SHA 다이제스트입니다. .NET SDK 9.0.100 이상에서 사용할 수 있습니다.
`org.opencontainers.image.source`		`PrivateRepositoryUrl`		`ContainerGenerateLabelsImageSource`	있는 경우에만 `PublishRepositoryUrl` 기록됩니다 `true`. 또한 빌드의 일부인 Sourcelink 인프라에 의존합니다.
`org.opencontainers.image.revision`		`SourceRevisionId`		`ContainerGenerateLabelsImageRevision`	있는 경우에만 `PublishRepositoryUrl` 기록됩니다 `true`. 또한 빌드의 일부인 Sourcelink 인프라에 의존합니다.

참고 항목

dotnet 게시를 사용하여 .NET 앱 컨테이너화
.NET 컨테이너 이미지

피드백

이 페이지가 도움이 되었나요?

Last updated on 2025-08-15

다음을 통해 공유

.NET 앱 참조 컨테이너화

컨테이너 속성 구성

기본 이미지를 제어하는 플래그

ContainerBaseImage

ContainerFamily

ContainerRuntimeIdentifier(s)

다중 아키텍처 이미지

생성된 이미지 독립적 메타데이터를 제어하는 플래그

ContainerImageFormat

ContainerImageTag

ContainerLabel

ContainerRepository

실행 메타데이터를 제어하는 플래그

ContainerAppCommand

ContainerAppCommandArgs

ContainerAppCommandInstruction

ContainerDefaultArgs

ContainerEnvironmentVariable

ContainerPort

ContainerPublishInParallel

ContainerUser

ContainerWorkingDirectory

생성된 이미지의 대상을 제어하는 플래그

ContainerArchiveOutputPath

ContainerRegistry

LocalRegistry

컨테이너 이미지 명명 구성

기본 컨테이너 레이블

참고 항목

피드백

추가 리소스

`ContainerBaseImage`

`ContainerFamily`

`ContainerRuntimeIdentifier(s)`

`ContainerImageFormat`

`ContainerImageTag`

`ContainerLabel`

`ContainerRepository`

`ContainerAppCommand`

`ContainerAppCommandArgs`

`ContainerAppCommandInstruction`

`ContainerDefaultArgs`

`ContainerEnvironmentVariable`

`ContainerPort`

`ContainerPublishInParallel`

`ContainerUser`

`ContainerWorkingDirectory`

`ContainerArchiveOutputPath`

`ContainerRegistry`

`LocalRegistry`