내보내기(0) 인쇄
모두 확장

CSPack 명령줄 도구

업데이트 날짜: 2013년 11월

CSPack 명령줄 도구(CSPack.exe)는 배포를 위해 응용 프로그램을 준비합니다. CSPack을 사용하는 방법은 응용 프로그램을 배포하려는 위치에 따라 달라집니다.

  • Windows Azure 계산 에뮬레이터에 배포하기 위해 응용 프로그램을 준비하려면 CSPack을 사용하여 디렉터리 레이아웃에 이진 파일을 복사합니다.

  • Windows Azure에 배포하기 위해 응용 프로그램을 준비하려면 CSPack을 사용하여 Windows Azure에 업로드되는 패키지 파일을 생성합니다.

  • 기존 패키지를 새 패키지 형식으로 변환하려는 경우 자세한 내용은 Windows Azure 패키지 형식을 참조하십시오.

도구 위치

SDK를 기본 위치에 설치한 경우 Windows Azure SDK 버전 1.7 이상에서는 CSPack을 C:\Program Files\Microsoft SDKs\Windows Azure\.NET SDK\<sdk-version>\bin 디렉터리에서 찾을 수 있습니다. Windows Azure SDK 버전 1.6 및 이전 버전에서는 CSPack이 C:\Program Files\Windows Azure SDK\<SDK version>\bin\ 디렉터리에 설치되어 있습니다.

명령줄 구문

CSPack <DefinitionFile> [options]

옵션

다음 표에는 CSPack의 옵션이 나열되어 있습니다. 최신 옵션 목록을 보려면 설치된 위치에서 명령 프롬프트에 CSPack /?를 입력하십시오.

 

옵션 설명

/out:<file> | directory>

이 옵션은 역할 이진 파일의 출력 형식 및 위치를 나타냅니다.

이 옵션과 함께 /copyOnly 옵션을 지정한 경우 CSPack은 명명된 출력 디렉터리를 만들고 역할 이진 파일을 해당 디렉터리에 복사합니다.

/copyOnly를 지정하지 않으면 이 옵션은 응용 프로그램 패키지의 파일 이름을 지정합니다. 파일 이름을 지정하지 않은 경우 응용 프로그램 패키지가 <service-definition-file-name>.cspkg로 만들어집니다.

/copyOnly

이 옵션을 지정하면 CSPack은 계산 에뮬레이터가 응용 프로그램을 로컬로 실행하는 데 사용하는 역할 이진 파일의 디렉터리 레이아웃을 만듭니다.

/out 옵션과 함께 출력 위치를 지정하지 않은 경우 CSPack은 <service-definition-file-name>.csx라는 디렉터리를 만듭니다.

/role:<RoleName>;[<RoleBinariesDirectory>];[<RoleEntryPointDLL>]

이 옵션을 지정하면 CSPack은 계산 에뮬레이터가 응용 프로그램을 로컬로 실행하는 데 사용하는 역할 이진 파일의 디렉터리 레이아웃을 만듭니다.

/out 옵션과 함께 출력 위치를 지정하지 않은 경우 CSPack은 <service-definition-file-name>.csx라는 디렉터리를 만듭니다.

/roleFiles:<RoleName>;<RoleFileList>

이 옵션은 역할을 구성하는 파일의 경로 집합이 포함된 파일을 지정합니다. 정의 파일에 지정된 역할마다 /roleFiles 옵션이 하나씩 명령줄에 포함될 수 있습니다.

역할의 진입점을 정의하는 DLL을 지정하려면 /roleFiles 옵션과 함께 /rolePropertiesFile 옵션을 사용합니다.

<RoleFileList> 매개 변수는 각 줄이 다음 형식인 간단한 로컬 텍스트 파일을 지정합니다.

<InputPath>;<TargetPath>

<InputPath>는 역할을 구성하는 파일의 절대 경로 또는 상대 경로일 수 있습니다. <InputPath>가 상대 경로인 경우 <RoleFileList>로 지정된 파일의 위치에 상대적입니다.

<TargetPath>는 <InputPath>로 참조된 파일이 서비스 패키지에 배치될 위치를 지정하는 상대 경로입니다.

/roleFiles 옵션을 지정하는 경우에는 /role 옵션을 지정하면 안 됩니다.

/rolePropertiesFile:<RoleName>;<RolePropertyFile>

이 옵션은 역할의 속성 목록이 포함된 파일을 지정합니다. /rolePropertiesFile 옵션은 /roleFiles 옵션과 함께 지정해야 합니다. 역할 속성 파일 내에서 역할의 진입점과 역할이 실행되어야 하는 대상 .NET Framework 버전이 포함된 DLL을 지정할 수 있습니다.

<RolePropertyFile> 매개 변수는 각 줄이 다음 형식인 간단한 로컬 텍스트 파일을 지정합니다.

<PropertyName>=<PropertyValue>

유효한 속성 이름 및 값에 대한 자세한 내용은 설명 섹션을 참조하십시오.

/sitePhysicalDirectories:<RoleName>;<VirtualPath1>;
<PhysicalPath1>;<VirtualPath2>;<PhysicalPath2>;…

이 옵션을 사용하여 Sites 섹션에 정의된 각 가상 경로의 실제 디렉터리를 정의할 수 있습니다. 각 사이트, 가상 디렉터리 및 가상 응용 프로그램 요소는 가상 경로(web.config location 요소의 위치 경로라고도 함)를 만듭니다.

Site 요소 사용에 대한 자세한 내용은 서비스 정의 파일에서 사이트 항목 구성을 참조하십시오.

/sites:<RoleName>;<SiteName>;<VirtualPath1>;
<PhysicalPath1>;…

이 옵션을 사용하여 실제 디렉터리에 있는 콘텐츠를 웹 사이트의 가상 디렉터리에 매핑할 수 있습니다. 각 사이트, 가상 디렉터리 및 가상 응용 프로그램 요소는 가상 경로(web.config location 요소의 위치 경로라고도 함)를 만들기 위해 정의된 순서대로 추가됩니다.

VirtualPath1은 서비스 정의 파일에 있는 <Site> 요소의 이름 특성으로 정의된 사이트 이름에 매핑됩니다.

PhysicalPath1Site 콘텐츠의 위치입니다.

/generateConfigurationFile:<ConfigurationFile>

이 옵션은 응용 프로그램에 대한 기본 구성 파일을 생성하는 데 사용됩니다. 생성된 파일을 편집하여 응용 프로그램을 배포하기 전에 응용 프로그램에서 설정 값 및 역할 인스턴스 수를 지정할 수 있습니다.

/allowLegacyWebRoles

이 플래그는 호스팅된 웹 코어에서 실행되는 레거시 웹 역할이 포함된 패키지에 대해 발생하는 경고를 표시하지 않습니다. 이 옵션을 사용하여 호스팅된 웹 코어에서 역할 인스턴스를 실행하거나 서비스 정의에 Sites 요소를 추가할 수 있습니다.

/useCtpPackageFormat

이 옵션은 패키지의 형식이 새 패키지 형식으로 지정되도록 지정합니다. 새 형식 사용에 대한 자세한 내용은 CSPack을 사용하여 새로운 형식의 패키지 만들기를 참조하십시오.

/convertToCTPPackage

이 옵션은 기존 패키지가 새 패키지 형식으로 변환되도록 지정합니다. 자세한 내용은 기존 패키지를 새 형식으로 변환을 참조하십시오.

설명

역할 속성 파일에서 다음과 같은 속성을 지정할 수 있습니다.

note참고
Windows Azure 라이브러리에서 이 항목을 보는 데 문제가 있으세요? MSDN 라이브러리에서 시도해 보십시오.

 

속성 이름 속성 값

TargetFrameWorkVersion

이 역할이 실행될 .NET Framework의 버전을 나타내는 숫자입니다. 이 속성 설정의 형식은 TargetFrameWorkVersion=vMajor.Minor입니다. 여기서 Major는 주 릴리스 번호를 나타내고 Minor는 부 릴리스 번호를 나타냅니다.

TargetFrameWorkVersion=v4.0

TargetFrameWorkVersion=v3.5

EntryPoint

역할에 대한 진입점 역할을 하는 DLL의 이름입니다. 이 속성 설정의 형식은 EntryPoint=DLLFileName입니다. 여기서 DLLFileName은 DLL의 파일 이름을 지정하는 문자열입니다.

EntryPoint=myroleentrypoint.dll

Important중요
Windows Azure SDK 1.1을 대상으로 작동하던 CSPack 호출이 Windows Azure SDK 1.2 이상으로 업그레이드한 후 실패하는 경우 CSPack의 대상 .NET Framework 버전을 올바르게 지정하지 않은 것이 문제일 수 있습니다. CSPack은 서비스 코드가 기본적으로 .NET 3.5에서 컴파일되었다고 가정합니다. 코드가 .NET 4에서 컴파일된 경우 역할 속성 파일을 만들고 명령줄에서 /rolePropertiesFile 옵션을 포함하여 해당 버전을 지정해야 합니다.

Warning경고
Windows SDK 버전 1.5 이상에서 CSPack으로 만든 패키지는 더 이상 암호화되지 않습니다. 패키지 콘텐츠에 중요한 데이터를 저장하지 않는 것이 좋습니다.

다음 예제에서는 CSPack을 사용하여 명령줄에서 Windows Azure SDK 샘플 몇 가지를 수동으로 패키지하는 방법을 보여 줍니다.

다음 예제에서는 개발 환경에서 배포하기 위해 HelloWorld 샘플을 패키지하는 방법을 보여 줍니다.


c:\samples\HelloWorld>cspack HelloWorld\ServiceDefinition.csdef /out:HelloWorld.csx /role:HelloWorld_WebRole;HelloWorld_WebRole /sites:HelloWorld_WebRole;Web;d:\HelloWorld_WebRole\HelloWorld_WebRole /copyOnly

다음 예제에서는 Windows Azure에 배포하기 위해 HelloWorld 샘플을 패키지하는 방법을 보여 줍니다.


c:\samples\HelloWorld>cspack HelloWorld\ServiceDefinition.csdef /out:HelloWorld.cspkg /role:HelloWorld_WebRole;HelloWorld_WebRole /sites:HelloWorld_WebRole;Web;d:\HelloWorld_WebRole\HelloWorld_WebRole

다음 예제에서는 작업자 역할이 포함된 샘플을 패키지하는 방법을 보여 줍니다.


c:\samples\HelloFabric>cspack HelloFabric\ServiceDefinition.csdef 
   /role:HelloFabric_WorkerRole;HelloFabric_WorkerRole\bin\Debug;HelloFabric_WorkerRole.dll 
   /out:HelloFabric.cspkg

c:\samples\Thumbnails>cspack ThumbnailsWorkerOnly\ServiceDefinition.csdef 
/role:Thumbnails_WorkerRole;Thumbnails_WorkerRole\bin\Debug;Thumbnails_WorkerRole.dll 
/out:ThumbnailsWorkerOnly.cspkg

다음 예제에서는 작업자 역할인 OrderProcessingRole과 웹 역할인 FrontendWebRole이 포함된 샘플을 패키지하는 방법을 보여 줍니다.


C:\samples\MultiTierApp>cspack MultiTierApp\ServiceDefinition.csdef /out:MultiTierApp.cspkg
/role:FrontendWebRole;FrontendWebRole /sites:FrontendWebRole;Web;c:\MyDirectory\MultiTierApp\FrontendWebRole 
/role:OrderProcessingRole;OrderProcessingRole\bin\Debug;OrderProcessingRole.dll

참고 항목

Microsoft는 MSDN 웹 사이트에 대한 귀하의 의견을 이해하기 위해 온라인 설문 조사를 진행하고 있습니다. 참여하도록 선택하시면 MSDN 웹 사이트에서 나가실 때 온라인 설문 조사가 표시됩니다.

참여하시겠습니까?
표시:
© 2014 Microsoft