배포 만들기

Create Deployment 비동기 작업은 새 서비스 패키지를 업로드하고 스테이징 또는 프로덕션 환경에서 새 배포를 만듭니다.

이 작업을 실행하려면 먼저 다음 작업을 완료해야 합니다.

  • 구독을 만들고 구독 식별자를 가져옵니다. 구독 식별자는 관리 포털의 설정 페이지에서 가져올 수 있습니다.

  • 작업 권한을 부여하기 위한 관리 인증서를 만들고 업로드합니다.

  • 클라우드 서비스를 만듭니다.

  • 응용 프로그램을 스테이징 또는 프로덕션에 배포해야 하는지를 결정합니다.

요청

다음과 같이 Create Deployment 요청을 지정합니다. <subscription-id>를 구독 ID로 바꾸고, <cloudservice-name>을 클라우드 서비스의 이름으로 바꾸고, <deployment-slot>staging 또는 production으로 바꾸십시오.

메서드 요청 URI
POST https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deploymentslots/<deployment-slot>

URI 매개 변수

없음

요청 헤더

다음 표에서는 요청 헤더에 대해 설명합니다.

요청 헤더 Description
Content-Type 필수 요소. 이 헤더를 application/xml로 설정합니다.
x-ms-version 필수 요소. 이 요청에 사용할 작업의 버전을 지정합니다. 이 헤더는 이상으로 설정 2009-10-01 해야 합니다.

요청 본문

요청 본문의 형식은 다음과 같습니다.

  
<?xml version="1.0" encoding="utf-8"?>  
<CreateDeployment xmlns="http://schemas.microsoft.com/windowsazure">  
  <Name>deployment-name</Name>  
  <PackageUrl>package-url-in-blob-storage</PackageUrl>  
  <Label>base64-encoded-deployment-label</Label>  
  <Configuration>base64-encoded-configuration-file</Configuration>  
  <StartDeployment>start-deployment</StartDeployment>  
  <TreatWarningsAsError>prioritize-warnings</TreatWarningsAsError>  
  <ExtendedProperties>  
    <ExtendedProperty>  
      <Name>property-name</Name>  
      <Value>property-value</Value>  
    </ExtendedProperty>  
  </ExtendedProperties>  
  <ExtensionConfiguration>  
    <AllRoles>  
      <Extension>  
        <Id>identifier-of-extension</Id>  
        <State>state-of-extension</State>  
      </Extension>  
    </AllRoles>  
    <NamedRoles>  
      <Role>  
        <RoleName>role_name1</RoleName>  
        <Extensions>  
          <Extension>  
            <Id>identifier-of-extension</Id>  
            <State>state-of-extension</State>  
          </Extension>  
        </Extensions>  
      </Role>  
    </NamedRoles>  
  </ExtensionConfiguration>  
</CreateDeployment>  
  

다음 표에서는 요청 본문의 요소에 대해 설명합니다.

요소 이름 Description
속성 필수 사항입니다. 배포의 이름을 지정합니다.
PackageUrl 필수 요소. Blob 서비스에서 서비스 패키지의 위치를 참조하는 URL을 지정합니다. 서비스 패키지는 동일한 구독 아래의 저장소 계정 또는 저장소 계정의 SAS(공유 액세스 서명) URI에 위치할 수 있습니다.
구성 필수 요소. 배포에 대해 Base-64로 인코딩된 서비스 구성 파일을 지정합니다.
레이블 필수 요소. Base-64로 인코딩된 배포의 식별자를 지정합니다. 식별자의 길이는 최대 100자입니다. 구독 내에서 고유 레이블을 지정하는 것이 좋습니다. 레이블은 추적용으로 사용할 수 있습니다.
StartDeployment 선택 사항입니다. 배포를 만든 후 즉시 시작할지 여부를 나타냅니다. 기본값은 false입니다.

false인 경우 서비스 모델이 계속 배포되지만 코드가 즉시 실행되지 않습니다. 대신 업데이트 배포 상태를 호출하고 상태 Running로 설정할 때까지 서비스가 Suspended 시작됩니다. 배포된 서비스는 일시 중단된 경우에도 계속 요금이 청구됩니다.

StartDeployment 요소는 버전 01.04.10 이후인 경우에만 사용할 수 있습니다.
TreatWarningsAsError 선택 사항입니다. 패키지 유효성 검사 경고를 오류로 처리할지 여부를 나타냅니다. 기본값은 false입니다. true로 설정되면 서비스 패키지에 대한 유효성 검사 경고가 있는 경우 Created Deployment 작업이 실패합니다.

TreatWarningsAsError 요소는 버전 01.04.11 이후인 경우에만 사용할 수 있습니다.
Name (선택 사항) 확장 배포 속성의 이름을 지정합니다. 각 확장 속성에는 정의된 이름과 값이 모두 있어야 합니다. 확장 속성 이름 및 값 쌍은 25개까지 지정할 수 있습니다.

Name 요소의 최대 길이는 64자이고, 영숫자와 밑줄만 포함할 수 있으며, 문자로 시작해야 합니다.

Name 요소는 버전 01.03.12 이후인 경우에만 사용할 수 있습니다.
선택 사항입니다. 확장 클라우드 서비스 속성의 값을 지정합니다. 각 확장 속성에는 정의된 이름과 값이 모두 있어야 합니다. 확장 속성 이름 및 값 쌍은 25개까지 지정할 수 있으며 각 확장 속성 값의 최대 길이는 255자입니다.

Value 요소는 버전 01.03.12 이후인 경우에만 사용할 수 있습니다.
ExtensionConfiguration 선택 사항입니다. 클라우드 서비스에 추가된 확장을 지정합니다. Azure에서는 프로세스가 클라우드 서비스의 확장으로 실행될 수 있습니다. 확장을 배포에 추가하려면 먼저 확장 추가 를 사용하여 클라우드 서비스에 확장을 추가해야 합니다.

요소는 ExtensionConfiguration 버전 2013-03-01 이상을 사용하는 경우에만 사용할 수 있습니다.

ExtensionConfiguration

클라우드 서비스에 추가된 확장을 지정합니다.

요소 이름 Description
AllRoles 선택 사항입니다. 배포의 모든 역할에 적용되는 확장 목록을 지정합니다.
내선 번호 필수 요소. 클라우드 서비스의 역할에 배포될 확장을 지정합니다.
NamedRoles 선택 사항입니다. 배포의 특정 역할에 적용될 확장 목록을 지정합니다.

내선 번호

클라우드 서비스의 역할에 배포될 확장을 지정합니다.

요소 이름 설명
Id 필수 요소. 확장의 식별자를 지정합니다. 클라우드 서비스에 확장을 추가할 때 ID가 생성됩니다. 목록 확장을 사용하여 클라우드 서비스에 추가된 확장의 식별자를 찾을 수 있습니다.
시스템 상태 선택 사항입니다. 확장의 상태를 지정합니다. 이 요소는 JSON으로 구성된 확장에만 적용됩니다.

가능한 값은 다음과 같습니다.

- Enable
- Disable
- Uninstall

기본값은 Enable입니다.

요소는 State 버전 2014-06-01 이상을 사용하는 경우에만 사용할 수 있습니다.

NamedRoles

배포의 특정 역할에 적용될 확장 목록을 지정합니다.

요소 이름 설명
역할 필수 요소. 확장이 추가되는 특정 역할을 지정합니다.
RoleName 필수 요소. 역할 이름을 지정합니다.
내선 번호 필수 요소. 클라우드 서비스의 역할에 배포될 확장을 지정합니다.

응답

응답에는 HTTP 상태 코드 및 응답 헤더 집합이 포함되어 있습니다.

상태 코드

작업에 성공하면 상태 코드 200(정상)이 반환됩니다.

응답 헤더

이 작업의 응답에는 다음과 같은 헤더가 포함됩니다. 응답에는 추가 표준 HTTP 헤더가 포함될 수도 있습니다.

응답 헤더 Description
x-ms-request-id 관리 서비스에 대해 수행된 요청을 고유하게 식별하는 값입니다. 비동기 작업의 경우 헤더 값으로 작업 상태 가져오기 를 호출하여 작업이 완료되었는지, 실패했는지 또는 아직 진행 중인지 확인할 수 있습니다.

응답 본문

없음