dotnet publish

아티클
01/08/2025

이 문서는 .NET Core 3.1 SDK 이상 버전 ✔️ 적용됩니다.

이름

dotnet publish - 호스팅 시스템에 배포하기 위해 애플리케이션 및 해당 종속성을 폴더에 게시합니다.

개요

dotnet publish [<PROJECT>|<SOLUTION>] [-a|--arch <ARCHITECTURE>]
    [--artifacts-path <ARTIFACTS_DIR>]
    [-c|--configuration <CONFIGURATION>] [--disable-build-servers]
    [-f|--framework <FRAMEWORK>] [--force] [--interactive]
    [--manifest <PATH_TO_MANIFEST_FILE>] [--no-build] [--no-dependencies]
    [--no-restore] [--nologo] [-o|--output <OUTPUT_DIRECTORY>]
    [--os <OS>] [-r|--runtime <RUNTIME_IDENTIFIER>]
    [--sc|--self-contained [true|false]] [--no-self-contained]
    [-s|--source <SOURCE>] [--tl:[auto|on|off]]
    [--use-current-runtime, --ucr [true|false]]
    [-v|--verbosity <LEVEL>] [--version-suffix <VERSION_SUFFIX>]

dotnet publish -h|--help

묘사

dotnet publish 애플리케이션을 컴파일하고, 프로젝트 파일에 지정된 종속성을 읽고, 결과 파일 집합을 디렉터리에 게시합니다. 출력에는 다음 자산이 포함됩니다.

dll 확장이 있는 어셈블리의 IL(중간 언어) 코드입니다.
프로젝트의 모든 종속성을 포함하는 .deps.json 파일입니다.
애플리케이션에 필요한 공유 런타임과 런타임에 대한 다른 구성 옵션(예: 가비지 수집 유형)을 지정하는 .runtimeconfig.json 파일입니다.
NuGet 캐시에서 출력 폴더로 복사되는 애플리케이션의 종속성입니다.

dotnet publish 명령의 출력은 실행을 위해 호스팅 시스템(예: 서버, PC, Mac, 노트북)에 배포할 준비가 된 것입니다. 배포를 위해 애플리케이션을 준비하는 유일한 공식적으로 지원되는 방법입니다. 프로젝트가 지정하는 배포 유형에 따라 호스팅 시스템에 .NET 공유 런타임이 설치되어 있거나 설치되어 있지 않을 수 있습니다. 자세한 내용은 .NET CLI사용하여 .NET 앱 게시 참조하세요.

암시적 복원

dotnet new, dotnet build, dotnet run, dotnet test, dotnet publish및 dotnet pack같은 복원이 필요한 모든 명령에서 암시적으로 실행되므로 dotnet restore 실행할 필요가 없습니다. 암시적 복원을 사용하지 않도록 설정하려면 --no-restore 옵션을 사용합니다.

명령은 Azure DevOps Services 연속 통합 빌드 또는 복원이 발생하는 시기를 명시적으로 제어해야 하는 빌드 시스템과 같이 명시적으로 복원하는 것이 적합한 특정 시나리오에서 여전히 유용합니다.

NuGet 피드를 관리하는 방법에 대한 자세한 내용은 dotnet restore 설명서참조하세요.

MSBuild

dotnet publish 명령은 Publish 대상을 호출하는 MSBuild를 호출합니다. IsPublishable 속성 특정 프로젝트에 대해 false 설정되면 Publish 대상을 호출할 수 없으며 dotnet publish 명령은 프로젝트에서 암시적 dotnet 복원 실행합니다.

dotnet publish 전달된 모든 매개 변수는 MSBuild에 전달됩니다. -c 및 -o 매개 변수는 각각 MSBuild의 Configuration 및 PublishDir 속성에 매핑됩니다.

dotnet publish 명령은 속성을 설정하는 -p 및 로거를 정의하는 -l 같은 MSBuild 옵션을 허용합니다. 예를 들어 -p:<NAME>=<VALUE>형식을 사용하여 MSBuild 속성을 설정할 수 있습니다.

.pubxml 파일

.pubxml 파일을 참조하여 게시 관련 속성을 설정할 수도 있습니다. 예를 들어:

dotnet publish -p:PublishProfile=FolderProfile

앞의 예제에서는 <project_folder>/Properties/PublishProfiles 폴더에 있는 FolderProfile.pubxml 파일을 사용합니다. PublishProfile 속성을 설정할 때 경로 및 파일 확장자를 지정하면 무시됩니다. MSBuild는 기본적으로 속성/PublishProfiles 폴더를 살펴보고 pubxml 파일 확장자를 가정합니다. 확장명을 포함한 경로 및 파일 이름을 지정하려면 PublishProfile 속성 대신 PublishProfileFullPath 속성을 설정합니다.

.pubxml 파일에서 다음을 수행합니다.

PublishUrl Visual Studio에서 게시 대상을 나타내는 데 사용됩니다.
PublishDir CLI에서 게시 대상을 나타내는 데 사용됩니다.

시나리오가 모든 위치에서 작동하도록 하려면 이러한 속성을 .pubxml 파일의 동일한 값으로 초기화할 수 있습니다. dotnet/sdk#20931 GitHub 문제가 해결되면 이러한 속성 중 하나만 설정해야 합니다.

.pubxml 파일의 일부 속성은 Visual Studio에서만 적용되며 dotnet publish영향을 주지 않습니다. CLI를 Visual Studio의 동작과 더 잘 맞도록 하기 위해 노력하고 있습니다. 그러나 일부 속성은 CLI에서 사용되지 않습니다. CLI와 Visual Studio는 모두 게시의 패키징 측면을 수행하고 dotnet/sdk#29817 관련 속성에 대한 지원을 추가할 계획입니다. 그러나 CLI는 게시의 배포 자동화 측면을 수행하지 않으며 관련 속성은 지원되지 않습니다. dotnet publish 지원되지 않는 가장 주목할 만한 .pubxml 속성은 빌드에 영향을 주는 다음과 같습니다.

LastUsedBuildConfiguration
Configuration
Platform
LastUsedPlatform
TargetFramework
TargetFrameworks
RuntimeIdentifier
RuntimeIdentifiers

MSBuild 속성

다음 MSBuild 속성은 dotnet publish출력을 변경합니다.

PublishReadyToRun

애플리케이션 어셈블리를 R2R(ReadyToRun) 형식으로 컴파일합니다. R2R은 AOT(Ahead-Of-Time) 컴파일의 한 형태입니다. 자세한 내용은 ReadyToRun 이미지참조하세요.

런타임 오류를 일으킬 수 있는 누락된 종속성에 대한 경고를 보려면 PublishReadyToRunShowWarnings=true사용합니다.

명령줄 대신 게시 프로필에 PublishReadyToRun 지정하는 것이 좋습니다.
PublishSingleFile

앱을 플랫폼별 단일 파일 실행 파일로 패키지합니다. 단일 파일 게시에 대한 자세한 내용은 단일 파일 번들러 디자인 문서참조하세요.

명령줄 대신 프로젝트 파일에서 이 옵션을 지정하는 것이 좋습니다.
PublishTrimmed

사용되지 않는 라이브러리를 트리밍하여 자체 포함 실행 파일을 게시할 때 앱의 배포 크기를 줄입니다. 자세한 내용은 자체 포함 배포 및 실행 파일트리밍을 참조하세요. .NET 6 SDK부터 사용할 수 있습니다.

명령줄 대신 프로젝트 파일에서 이 옵션을 지정하는 것이 좋습니다.

자세한 내용은 다음 리소스를 참조하세요.

MSBuild 명령줄 참조
ASP.NET Core 앱 배포용 Visual Studio 게시 프로필(.pubxml)
dotnet msbuild

워크로드 매니페스트 다운로드

이 명령을 실행하면 워크로드에 대한 광고 매니페스트의 비동기 백그라운드 다운로드가 시작됩니다. 이 명령이 완료될 때 다운로드가 계속 실행되면 다운로드가 중지됩니다. 자세한 내용은Advertising 매니페스트를 참조하세요.

인수

PROJECT|SOLUTION

게시할 프로젝트 또는 솔루션입니다.
- PROJECT C#, F#또는 Visual Basic 프로젝트 파일의 경로 및 파일 이름 또는 C#, F# 또는 Visual Basic 프로젝트 파일이 포함된 디렉터리의 경로입니다. 디렉터리를 지정하지 않으면 기본값은 현재 디렉터리입니다.
- SOLUTION 솔루션 파일(.sln 확장명)의 경로 및 파일 이름 또는 솔루션 파일이 포함된 디렉터리의 경로입니다. 디렉터리를 지정하지 않으면 기본값은 현재 디렉터리입니다.

옵션

-a|--arch <ARCHITECTURE>

대상 아키텍처를 지정합니다. 제공된 값이 기본 RID와 결합되는 RID(런타임 식별자)설정하기 위한 약식 구문입니다. 예를 들어 win-x64 컴퓨터에서 --arch x86 지정하면 RID가 win-x86. 이 옵션을 사용하는 경우 -r|--runtime 옵션을 사용하지 마세요. .NET 6 미리 보기 7부터 사용할 수 있습니다.

--artifacts-path <ARTIFACTS_DIR>

실행된 명령의 모든 빌드 출력 파일은 지정된 경로 아래의 하위 폴더에서 프로젝트로 구분됩니다. 자세한 내용은 아티팩트 출력 레이아웃참조하세요. .NET 8 SDK부터 사용할 수 있습니다.

-c|--configuration <CONFIGURATION>

빌드 구성을 정의합니다. .NET 8 SDK 이상 버전으로 개발하는 경우 이 명령은 TargetFramework가 net8.0 이상 버전으로 설정된 프로젝트에 대해 기본적으로 Release 구성을 사용합니다. 기본 빌드 구성은 이전 버전의 SDK 및 이전 대상 프레임워크에 대해 Debug. 프로젝트 설정에서 또는 이 옵션을 사용하여 기본값을 재정의할 수 있습니다. 자세한 내용은 'dotnet publish'가 릴리스 구성 사용하고 'dotnet pack'이 릴리스 구성사용하는 참조하세요.

--disable-build-servers

명령이 영구 빌드 서버를 무시하도록 합니다. 이 옵션은 빌드 캐싱을 모두 사용하지 않도록 설정하는 일관된 방법을 제공하여 빌드를 처음부터 강제로 적용합니다. 캐시를 사용하지 않는 빌드는 어떤 이유로 인해 캐시가 손상되거나 올바르지 않을 수 있는 경우에 유용합니다. .NET 7 SDK부터 사용할 수 있습니다.

-f|--framework <FRAMEWORK>

지정된 대상 프레임워크대한 애플리케이션을 게시합니다. 프로젝트 파일에서 대상 프레임워크를 지정해야 합니다.
--force

마지막 복원에 성공한 경우에도 모든 종속성을 강제로 확인합니다. 이 플래그를 지정하는 것은 project.assets.json 파일을 삭제하는 것과 같습니다.

-?|-h|--help

명령을 사용하는 방법에 대한 설명을 출력합니다.

--interactive

명령을 중지하고 사용자 입력 또는 작업을 기다릴 수 있습니다. 예를 들어 인증을 완료합니다. .NET Core 3.0 SDK부터 사용할 수 있습니다.

--manifest <PATH_TO_MANIFEST_FILE>

앱과 함께 게시된 패키지 집합을 자르는 데 사용할 하나 이상의 대상 매니페스트를 지정합니다. 매니페스트 파일은 dotnet store 명령출력의 일부입니다. 여러 매니페스트를 지정하려면 각 매니페스트에 대한 --manifest 옵션을 추가합니다.
--no-build

게시하기 전에 프로젝트를 빌드하지 않습니다. 또한 --no-restore 플래그를 암시적으로 설정합니다.
--no-dependencies

프로젝트-프로젝트 참조를 무시하고 루트 프로젝트만 복원합니다.
--no-restore

명령을 실행할 때 암시적 복원을 실행하지 않습니다.
-o|--output <OUTPUT_DIRECTORY>

출력 디렉터리의 경로를 지정합니다.

지정하지 않으면 프레임워크 종속 실행 파일 및 플랫폼 간 이진 파일에 대해 [project_file_folder]/bin/[configuration]/[framework]/publish/ 기본값입니다. 기본적으로 자체 포함 실행 파일에 대해 [project_file_folder]/bin/[configuration]/[framework]/[runtime]/publish/ .

웹 프로젝트에서 출력 폴더가 프로젝트 폴더에 있으면 연속된 dotnet publish 명령으로 인해 중첩된 출력 폴더가 생성됩니다. 예를 들어 프로젝트 폴더가 myproject게시 출력 폴더가 myproject/publish 두 번 실행하는 경우 두 번째 실행에서는 .config 및 .json 파일과 같은 콘텐츠 파일을 myproject/publish/publish배치합니다. 게시 폴더 중첩을 방지하려면 프로젝트 폴더 아래에 직접 않는 게시 폴더를 지정하거나 프로젝트에서 게시 폴더를 제외합니다. publishoutput게시 폴더를 제외하려면 .csproj 파일의 요소에 다음 요소를 추가합니다.
```
<DefaultItemExcludes>$(DefaultItemExcludes);publishoutput**</DefaultItemExcludes>
```
- .NET 7.0.200 SDK 이상
  
  솔루션에서 이 명령을 실행할 때 --output 옵션을 지정하면 CLI는 출력 경로의 명확하지 않은 의미 체계로 인해 경고(7.0.200의 오류)를 내보냅니다. 모든 빌드된 프로젝트의 모든 출력이 다중 대상 프로젝트와 호환되지 않는 지정된 디렉터리에 복사되고 서로 다른 버전의 직접 및 전이적 종속성이 있는 프로젝트로 복사되므로 --output 옵션이 허용되지 않습니다. 자세한 내용은 솔루션 수준 --output 옵션이 빌드 관련 명령더 이상 유효하지 않음을 참조하세요.
- .NET Core 3.x SDK 이상
  
  프로젝트를 게시할 때 상대 경로를 지정하면 생성된 출력 디렉터리가 프로젝트 파일 위치가 아닌 현재 작업 디렉터리를 기준으로 합니다.
  
  솔루션을 게시할 때 상대 경로를 지정하면 모든 프로젝트의 모든 출력이 현재 작업 디렉터리를 기준으로 지정된 폴더로 이동합니다. 게시 출력을 각 프로젝트에 대해 별도의 폴더로 이동하도록 하려면 --output 옵션 대신 msbuild PublishDir 속성을 사용하여 상대 경로를 지정합니다. 예를 들어 dotnet publish -p:PublishDir=.\publish 각 프로젝트에 대한 게시 출력을 프로젝트 파일이 포함된 폴더 아래의 publish 폴더로 보냅니다.
- .NET Core 2.x SDK
  
  프로젝트를 게시할 때 상대 경로를 지정하면 생성된 출력 디렉터리가 현재 작업 디렉터리가 아닌 프로젝트 파일 위치를 기준으로 합니다.
  
  솔루션을 게시할 때 상대 경로를 지정하면 각 프로젝트의 출력이 프로젝트 파일 위치를 기준으로 별도의 폴더로 이동합니다. 솔루션을 게시할 때 절대 경로를 지정하면 모든 프로젝트에 대한 모든 게시 출력이 지정된 폴더로 이동합니다.

--os <OS>

대상 OS(운영 체제)를 지정합니다. 제공된 값이 기본 RID와 결합되는 RID(런타임 식별자)설정하기 위한 약식 구문입니다. 예를 들어 win-x64 컴퓨터에서 --os linux 지정하면 RID가 linux-x64. 이 옵션을 사용하는 경우 -r|--runtime 옵션을 사용하지 마세요. .NET 6부터 사용할 수 있습니다.

--sc|--self-contained [true|false]

대상 컴퓨터에 런타임을 설치할 필요가 없도록 애플리케이션과 함께 .NET 런타임을 게시합니다. 런타임 식별자를 지정하고 프로젝트가 실행 가능한 프로젝트(라이브러리 프로젝트가 아님)인 경우 기본값은 true. 자세한 내용은 .NET 애플리케이션 게시 .NET CLI사용하여 .NET 앱 게시 참조하세요.

true 또는 false지정하지 않고 이 옵션을 사용하는 경우 기본값은 true. 이 경우 true 또는 false 해당 위치에 예상되므로 --self-contained직후에 솔루션 또는 프로젝트 인수를 배치하지 마세요.
--no-self-contained

--self-contained false동일합니다.
--source <SOURCE>

복원 작업 중에 사용할 NuGet 패키지 원본의 URI입니다.
-r|--runtime <RUNTIME_IDENTIFIER>

지정된 런타임에 대한 애플리케이션을 게시합니다. RID(런타임 식별자) 목록은 RID 카탈로그참조하세요. 자세한 내용은 .NET 애플리케이션 게시 .NET CLI사용하여 .NET 앱 게시 참조하세요. 이 옵션을 사용하는 경우 --self-contained 사용하거나 --no-self-contained.

--tl:[auto|on|off]

터미널 로거 빌드 출력에 사용할지 여부를 지정합니다. 기본값은 터미널 로깅을 사용하도록 설정하기 전에 먼저 환경을 확인하는 auto. 환경 검사는 터미널이 최신 출력 기능을 사용할 수 있고 새 로거를 사용하도록 설정하기 전에 리디렉션된 표준 출력을 사용하지 않는지 확인합니다. on 환경 검사를 건너뛰고 터미널 로깅을 사용하도록 설정합니다. off 환경 검사를 건너뛰고 기본 콘솔 로거를 사용합니다.

터미널 로거에는 복원 단계와 빌드 단계가 표시됩니다. 각 단계에서 현재 빌드 프로젝트는 터미널 아래쪽에 표시됩니다. 빌드 중인 각 프로젝트는 현재 빌드 중인 MSBuild 대상과 해당 대상에 소요된 시간을 모두 출력합니다. 이 정보를 검색하여 빌드에 대해 자세히 알아볼 수 있습니다. 프로젝트 빌드가 완료되면 다음을 캡처하는 단일 "빌드 완료" 섹션이 작성됩니다.
- 빌드된 프로젝트의 이름입니다.
- 대상 프레임워크(다중 대상인 경우)입니다.
- 해당 빌드의 상태입니다.
- 해당 빌드의 기본 출력(하이퍼링크)입니다.
- 해당 프로젝트에 대해 생성된 모든 진단입니다.
이 옵션은 .NET 8부터 사용할 수 있습니다.

--use-current-runtime, --ucr [true|false]

컴퓨터 중 하나에 따라 RuntimeIdentifier 이식 가능한 플랫폼 RuntimeIdentifier 설정합니다. SelfContained, PublishAot, PublishSelfContained, PublishSingleFile및 PublishReadyToRun같은 RuntimeIdentifier필요한 속성에서 암시적으로 발생합니다. 속성이 false로 설정된 경우 해당 암시적 해결은 더 이상 발생하지 않습니다.

-v|--verbosity <LEVEL>

명령의 세부 정보 수준을 설정합니다. 허용되는 값은 q[uiet], m[inimal], n[ormal], d[etailed]및 diag[nostic]. 기본값은 minimal. 자세한 내용은 LoggerVerbosity참조하세요.

--version-suffix <VERSION_SUFFIX>

프로젝트 파일의 버전 필드에서 별표(*)를 바꿀 버전 접미사를 정의합니다.

예제

현재 디렉터리에서 프로젝트에 대한 프레임워크 종속 플랫폼 간 이진 만듭니다.
```
dotnet publish
```
.NET Core 3.0 SDK부터 이 예제에서는 현재 플랫폼에 대한 프레임워크 종속 실행 파일 만듭니다.
특정 런타임에 대해 현재 디렉터리의 프로젝트에 대한 자체 포함 실행 파일 만듭니다.
```
dotnet publish --runtime osx-x64
```
RID는 프로젝트 파일에 있어야 합니다.
특정 플랫폼에 대해 현재 디렉터리의 프로젝트에 대한 프레임워크 종속 실행 파일 만듭니다.
```
dotnet publish --runtime osx-x64 --self-contained false
```
RID는 프로젝트 파일에 있어야 합니다. 이 예제는 .NET Core 3.0 SDK 이상 버전에 적용됩니다.
특정 런타임 및 대상 프레임워크에 대해 현재 디렉터리에 프로젝트를 게시합니다.
```
dotnet publish --framework net8.0 --runtime osx-x64
```
지정된 프로젝트 파일을 게시합니다.
```
dotnet publish ~/projects/app1/app1.csproj
```
현재 애플리케이션을 게시하지만 P2P(프로젝트 대 프로젝트) 참조를 복원하지 않고 복원 작업 중에 루트 프로젝트만 복원합니다.
```
dotnet publish --no-dependencies
```

참고 항목

.NET 애플리케이션 게시 개요
.NET CLI 사용하여 .NET 앱 게시
대상 프레임워크
RID(런타임 식별자) 카탈로그
dotnet 게시 사용하여 .NET 앱 컨테이너화
macOS Catalina Notarization 작업
게시된 애플리케이션 디렉터리 구조
MSBuild 명령줄 참조
ASP.NET Core 앱 배포용 Visual Studio 게시 프로필(.pubxml)
dotnet msbuild
자체 포함 배포 트리밍

다음을 통해 공유