Microsoft MVP성태의 닷넷 이야기
글쓴 사람
홈페이지
첨부 파일

MSBuild를 이용해 프로젝트 배포 후 결과물을 zip 파일로 압축하는 방법

비주얼 스튜디오에서 "Publish"를 메뉴를 선택해 배포했을 때 결과물을 단일 .zip 파일로 생성하고 싶을 때가 있습니다. 물론, 별도의 명령행으로 빌드 스크립트를 만드는 것도 가능하지만,

MSBuild - x86/x64, .NET 2/4, debug/release 빌드에 대한 배치 처리
; https://www.sysnet.pe.kr/2/0/1017

PowerShell로 Visual Studio 빌드 스크립트 작성
; https://www.sysnet.pe.kr/2/0/1687

때로는 그냥 비주얼 스튜디오에서 모든 걸 해결하고 싶을 때가 있기 마련입니다. ^^

일례로, ASP.NET Core 프로젝트를 만들었는데 Publish 메뉴 실행 시 결과물을 .zip 파일로 생성하고 싶다면 어떻게 해야 할까요? 닷넷 코어 웹 프로젝트를 "폴더"를 대상으로 배포하면 기본적으로 다음의 글에 설명했던 것처럼,

ASP.NET Core Web Application을 IIS에서 호스팅하는 방법
; https://www.sysnet.pe.kr/2/0/11120

bin\Release\PublishOutput 폴더에 배포됩니다. 그리고 배포되자마자 해당 폴더를 .zip 파일로 만들기 위해 프로젝트 속성에서 "Build Events"를 이용할 수도 있지만 msbuild의 고유 기능을 이용하는 것도 가능합니다. 즉, .csproj 프로젝트 파일에 MSBuild Task를 정의하는 것이 가능한데요, 이에 대해서는 지난 글에서 이미 대략 설명을 했습니다.

MSBuild - 빌드 전/후, 배포 전/후 실행하고 싶은 Task 정의
; https://www.sysnet.pe.kr/2/0/11507

이 글에서 우리가 원하는 압축 작업은 배포(Publish) 이후니까 다음과 같이 Target을 시작하면 됩니다.

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

    <PropertyGroup>
        <TargetFramework>net461</TargetFramework>
    </PropertyGroup>

    <ItemGroup>
        <PackageReference Include="Microsoft.AspNetCore" Version="2.0.0" />
        <PackageReference Include="Microsoft.AspNetCore.Mvc" Version="2.0.0" />
        <PackageReference Include="Microsoft.AspNetCore.Mvc.Razor.ViewCompilation" Version="2.0.0" PrivateAssets="All" />
        <PackageReference Include="Microsoft.AspNetCore.StaticFiles" Version="2.0.0" />
        <PackageReference Include="Microsoft.VisualStudio.Web.BrowserLink" Version="2.0.0" />
    </ItemGroup>

    <ItemGroup>
        <DotNetCliToolReference Include="Microsoft.VisualStudio.Web.CodeGeneration.Tools" Version="2.0.0" />
    </ItemGroup>

    <Target Name="MyAfterPublish" AfterTargets="Publish">
        <!-- task to zip -->
    </Target>

</Project>

이제 저 Target 안에 배포 폴더를 압축하는 Task를 넣으면 되는데요. 여기서 우선 알아야 할 것은 배포 폴더의 경로입니다. 경로에 대한 하드 코딩을 할 수도 있지만 msbuild 내부에서 사용되는 각종 매크로 변수들을 이용하면 좀 더 유연한 스크립트 작성을 할 수 있습니다. Target 작업들에서 어떤 변수들이 사용되고 있는지 알아내는 가장 쉬운 방법은 비주얼 스튜디오의 "TOOLS" / "Options" 메뉴에서 "Projects and Solutions" / "Build and Run" 범주의 "MSBuild project build output verbosity" 항목을 "Detailed" 또는 "Diagnostic" 정도로 설정하고 빌드/배포를 해보는 것입니다. 그럼, Output 창에 꽤 많은 내용들이 출력되는데 그중에서 배포 파일들이 출력되는 경로를 담은 변수를 센스 있게 ^^ 찾아내면 됩니다. 또는 아래의 문서들이 도움이 될 수 있습니다.

Common MSBuild Project Properties
; https://msdn.microsoft.com/en-us/library/bb629394.aspx

Team Build에 사용되는 각종 Property 값
; https://www.sysnet.pe.kr/2/0/508

(또는 비주얼 스튜디오 프로젝트 속성 창의 "Build Events" 정의 창에서 확인하는 "Macro" 값들)

다음은 제가 찾아낸 값입니다.

<Message Importance="high" Text="PublishPath: ================= $(ProjectDir)$(PublishUrl)" /> 

그다음, 결정할 것이 .zip 파일에 대한 경로입니다. 우선 zip 파일이 생성될 디렉터리 경로는 다음과 같이 정하고,

<Message Importance="high" Text="ZipFolder: ================= $(ProjectDir)bin\" /> 

zip 파일명은 TargetName을 따르면 됩니다.

<Message Importance="high" Text="ZipFileName: ================= $(TargetName).zip" /> 

마지막으로 위의 인자들을 가지고 압축 Task를 작성하면 됩니다.




아쉽게도 압축 파일을 만드는 Task는 msbuild에서 기본으로는 제공하고 있지 않습니다. 따라서, 사용자 정의 task를 만들거나 이미 누군가 만들어 놓은 task를 이용하면 됩니다. 아래는 이럴 때 자주 언급되는 MSBuildCommunityTasks입니다.

loresoft/msbuildtasks 
; https://github.com/loresoft/msbuildtasks

위의 msi 파일로 설치하면 시스템 전역적으로 제공되는 반면, 프로젝트 레벨에서만 MSBuildCommunityTasks를 사용하고 싶다면 NuGet 설치를 하면 됩니다.

Install-Package MSBuildTasks -Version 1.5.0.235 
; https://www.nuget.org/packages/MSBuildTasks

전역/프로젝트 레벨에 따라 적절하게 Import 노드를 구성해 MSBuild.Community.Tasks.Targets을 포함한 후 Zip task를 사용할 수 있습니다.

<Import Project="lib\MSBuildCommunityTasks\MSBuild.Community.Tasks.Targets" />
<Target Name="Zip">
  <CreateItem Include="YourSourceFolder\*.*" >
      <Output ItemName="ZipFiles" TaskParameter="Include"/>
  </CreateItem>
  <Zip ZipFileName="YourZipFile.zip" WorkingDirectory="YourSourceFolder" Files="@(ZipFiles)" />
</Target>

또는, PowerShell을 이용할 수도 있습니다. Exec Task를 이용해 PowerShell에서 .NET 코드를 호출하는 기능을 이용하면,

<Exec Command="powershell.exe -nologo -noprofile -command &quot;&amp; { Add-Type -A 'System.IO.Compression.FileSystem'; [IO.Compression.ZipFile]::CreateFromDirectory('...[path]...', '...[zip file path]...'); }&quot;"/>  

다음과 같이 Target을 작성할 수 있습니다.

<Target Name="MyAfterPublish" AfterTargets="Publish">
    <Message Importance="high" Text="PublishPath ================= $(ProjectDir)$(PublishUrl)" /> 
    <Message Importance="high" Text="ZipFolder ================= $(ProjectDir)bin\" /> 
    <Message Importance="high" Text="ZipFileName ================= $(TargetName).zip" /> 
 
    <Delete Files="$(ProjectDir)bin\$(TargetName).zip" />
    <Exec Command="powershell.exe -nologo -noprofile -command &quot;&amp; { Add-Type -A 'System.IO.Compression.FileSystem'; [IO.Compression.ZipFile]::CreateFromDirectory('$(ProjectDir)$(PublishUrl)', '$(ProjectDir)bin\$(TargetName).zip'); }&quot;"/>  
</Target>

이 외에, MSBuild에서 C# 코드를 직접 호출할 수 있는 기능이 CodeTaskFactory에 의해 제공되므로 위의 PowerShell 대신 사용하는 것도 가능합니다.

Visual Studio 2017 - MSBuild Inline Tasks
; https://docs.microsoft.com/en-us/visualstudio/msbuild/msbuild-inline-tasks

Visual Studio 2015 - MSBuild Inline Tasks
; https://msdn.microsoft.com/en-us/library/dd722601.aspx

CodeTaskFactory가 담긴 어셈블리의 파일 명이 환경에 따라 Microsoft.Build.Tasks.v12.0.dll, Microsoft.Build.Tasks.Core.dll와 같이 다르다는 점에 주의해야 합니다.

Visual Studio 2017을 사용한다는 가정으로 Microsoft.Build.Tasks.Core.dll을 사용하면 다음과 같이 압축 스크립트를 Target에 끼워 넣을 수 있습니다.

<Target Name="MyAfterPublish" AfterTargets="Publish">
    <Message Importance="high" Text="PublishPath ================= $(ProjectDir)$(PublishUrl)" /> 
    <Message Importance="high" Text="ZipFolder ================= $(ProjectDir)bin\" /> 
    <Message Importance="high" Text="ZipFileName ================= $(TargetName).zip" /> 
 
    <Delete Files="$(ProjectDir)bin\$(TargetName).zip" />
    <ZipWebAppTask ZipDir="$(ProjectDir)$(PublishUrl)" ZipFilePath="$(ProjectDir)bin\$(TargetName).zip" /> 
</Target>

<UsingTask  
    TaskName="ZipWebAppTask"  
    TaskFactory="CodeTaskFactory"  
    AssemblyFile="$(MSBuildToolsPath)\Microsoft.Build.Tasks.Core.dll" >  

    <ParameterGroup>  
        <ZipFilePath ParameterType="System.String" Required="true" />  
        <ZipDir ParameterType="System.String" Required="true" />  
    </ParameterGroup>  

    <Task>  
        <Reference Include="System" />  
        <Reference Include="System.IO.Compression.FileSystem" />  
        <Using Namespace="System" />  
        <Using Namespace="System.IO" />  
        <Using Namespace="System.IO.Compression" />  
        <Code Type="Fragment" Language="cs">  
<![CDATA[ 
ZipFile.CreateFromDirectory(ZipDir, ZipFilePath);
]]>  
        </Code>  
    </Task>  
</UsingTask>  

(첨부 파일은 이 글의 예제 프로젝트 파일입니다.)




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

[연관 글]





[최초 등록일: ]
[최종 수정일: 4/23/2018 ]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer@outlook.com

비밀번호

댓글 쓴 사람
 




... 16  17  [18]  19  20  21  22  23  24  25  26  27  28  29  30  ...
NoWriterDateCnt.TitleFile(s)
11798정성태12/19/20182360개발 환경 구성: 426. vcpkg - "Building vcpkg.exe failed. Please ensure you have installed Visual Studio with the Desktop C++ workload and the Windows SDK for Desktop C++"
11797정성태3/7/20201608개발 환경 구성: 425. vcpkg - CMake Error: Problem with archive_write_header(): Can't create '' 빌드 오류
11796정성태12/19/20181486개발 환경 구성: 424. vcpkg - "File does not have expected hash" 오류를 무시하는 방법
11795정성태12/19/20182051Windows: 154. PowerShell - Zone 별로 DNS 레코드 유형 정보 조회 [1]
11794정성태12/17/20181435오류 유형: 508. Get-AzureWebsite : Request to a downlevel service failed.
11793정성태12/16/20181658개발 환경 구성: 423. NuGet 패키지 제작 - Native와 Managed DLL을 분리하는 방법
11792정성태12/11/20181953Graphics: 34. .NET으로 구현하는 OpenGL (11) - Per-Pixel Lighting파일 다운로드1
11791정성태12/11/20181980VS.NET IDE: 130. C/C++ 프로젝트의 시작 프로그램으로 .NET Core EXE를 지정하는 경우 닷넷 디버깅이 안 되는 문제 [1]
11790정성태12/11/20181760오류 유형: 507. Could not save daemon configuration to C:\ProgramData\Docker\config\daemon.json: Access to the path 'C:\ProgramData\Docker\config' is denied.
11789정성태12/10/20183639Windows: 153. C# - USB 장치의 연결 및 해제 알림을 위한 WM_DEVICECHANGE 메시지 처리파일 다운로드1
11788정성태12/4/20181402오류 유형: 506. SqlClient - Value was either too large or too small for an Int32.Couldn't store <2151292191> in ... Column
11787정성태11/29/20182553Graphics: 33. .NET으로 구현하는 OpenGL (9), (10) - OBJ File Format, Loading 3D Models파일 다운로드1
11786정성태11/29/20181473오류 유형: 505. OpenGL.NET 예제 실행 시 "Managed Debugging Assistant 'CallbackOnCollectedDelegate'" 예외 발생
11785정성태12/23/20192294디버깅 기술: 120. windbg 분석 사례 - ODP.NET 사용 시 Finalizer에서 System.AccessViolationException 예외 발생으로 인한 비정상 종료
11784정성태11/18/20182006Graphics: 32. .NET으로 구현하는 OpenGL (7), (8) - Matrices and Uniform Variables, Model, View & Projection Matrices파일 다운로드1
11783정성태11/18/20181953오류 유형: 504. 윈도우 환경에서 docker가 설치된 컴퓨터 간의 ping IP 주소 풀이 오류
11782정성태2/20/20191834Windows: 152. 윈도우 10에서 사라진 "Adapters and Bindings" 네트워크 우선순위 조정 기능 - 두 번째 이야기
11781정성태11/17/20182571개발 환경 구성: 422. SFML.NET 라이브러리 설정 방법파일 다운로드1
11780정성태11/17/20182506오류 유형: 503. vcpkg install bzip2 빌드 에러 - "Error: Building package bzip2:x86-windows failed with: BUILD_FAILED"
11779정성태11/17/20182783개발 환경 구성: 421. vcpkg 업데이트 [1]
11778정성태11/14/20181793.NET Framework: 803. UWP 앱에서 한 컴퓨터(localhost, 127.0.0.1) 내에서의 소켓 연결
11777정성태11/13/20182289오류 유형: 502. Your project does not reference "..." framework. Add a reference to "..." in the "TargetFrameworks" property of your project file and then re-run NuGet restore.
11776정성태11/13/20181384.NET Framework: 802. Windows에 로그인한 계정이 마이크로소프트의 계정인지, 로컬 계정인지 알아내는 방법
11775정성태11/18/20183098Graphics: 31. .NET으로 구현하는 OpenGL (6) - Texturing파일 다운로드1
11774정성태11/13/20182065Graphics: 30. .NET으로 구현하는 OpenGL (4), (5) - Shader파일 다운로드1
11773정성태11/7/20181782Graphics: 29. .NET으로 구현하는 OpenGL (3) - Index Buffer파일 다운로드1
... 16  17  [18]  19  20  21  22  23  24  25  26  27  28  29  30  ...