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

업그레이드 배포

업데이트 날짜: 2014년 4월

Upgrade Deployment 작업은 지정된 패키지 및 구성을 사용하여 배포에서 역할 인스턴스의 업데이트를 시작합니다. 역할 인스턴스 업데이트에 대한 자세한 내용은 Windows Azure 서비스 업데이트를 참조하십시오.

Upgrade Deployment 작업은 비동기 작업입니다. 요청을 처리했는지 여부를 확인하려면 작업 상태 가져오기를 호출합니다. 비동기 작업에 대한 자세한 내용은 비동기 서비스 관리 요청 추적을 참조하십시오.

다음과 같이 Upgrade Deployment 요청을 지정할 수 있습니다. 배포 환경(스테이징 또는 프로덕션)을 지정하거나 배포의 고유 이름을 지정하여 배포를 업데이트할 수 있습니다.

요청 URI를 생성하려면 <subscription-id>를 구독 ID로 바꾸고, <cloudservice-name>을 클라우드 서비스 이름으로 바꾸고, <deployment-slot>staging 또는 production으로 바꾸고, <deployment-name>을 배포의 고유 이름으로 바꾸십시오.

 

메서드 요청 URI HTTP 버전

POST

https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deploymentslots/<deployment-slot>/

HTTP/1.1

POST

https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deployments/<deployment-name>/

HTTP/1.1

 

URI 매개 변수 설명

comp=upgrade

필수 사항입니다. 배포가 업데이트되도록 지정합니다.

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

 

요청 헤더 설명

Content-Type

필수 사항입니다. 이 헤더를 application/xml로 설정합니다.

x-ms-version

필수 사항입니다. 이 요청에 사용할 작업의 버전을 지정합니다. 이 헤더는 2009-10-01 이후로 설정되어야 합니다. 버전 관리 헤더에 대한 자세한 내용은 서비스 관리 버전 관리를 참조하십시오.

요청 본문의 형식은 다음과 같습니다. 요청에 있는 XML 요소는 표시된 순서대로 지정해야 합니다.


<?xml version="1.0" encoding="utf-8"?>
<UpgradeDeployment xmlns="http://schemas.microsoft.com/windowsazure">
  <Mode>type-of-upgrade</Mode>
  <PackageUrl>url-to-package</PackageUrl>
  <Configuration>base64-encoded-config-file</Configuration>
  <Label>base-64-encoded-label</Label>
  <RoleToUpgrade>role-name</RoleToUpgrade>
  <Force>true|false</Force>
  <ExtendedProperties>
    <ExtendedProperty>
      <Name>property-name</Name>
      <Value>property-value</Value>
    </ExtendedProperty>
  </ExtendedProperties>
  <ExtensionConfiguration>
    <AllRoles>
      <Extension>
        <Id>identifier-of-extension</Id>
      </Extension>
      ...
    </AllRoles>
    <NamedRoles>
      <Role>
        <RoleName>role_name1</RoleName>
        <Extensions>
          <Extension>
            <Id>identifier-of-extension</Id>
          </Extension>
          ...
        </Extensions>
      </Role>
    </NamedRoles>
  </ExtensionConfiguration>
</UpgradeDeployment>

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

 

요소 이름 설명

Mode

필수 사항입니다. 시작할 업데이트 유형입니다. 서비스가 배포될 때 업데이트 도메인에 역할 인스턴스가 할당됩니다. 업데이트는 각 업데이트 도메인에서 수동으로 시작되거나 모든 업데이트 도메인에서 자동으로 시작될 수 있습니다. 가능한 값은 아래와 같습니다.

  • Auto

  • Manual

  • Simultaneous

지정하지 않으면 기본값은 Auto입니다. Manual로 설정하면 WalkUpgradeDomain을 호출하여 업데이트를 적용해야 합니다. Auto로 설정되면 업데이트가 각 업데이트 도메인에 순서대로 자동 적용됩니다.

Simultaneous 설정은 버전 2012-12-01 이상의 경우에만 사용할 수 있습니다.

PackageUrl

필수 사항. Blob 서비스에서 서비스 패키지의 위치를 참조하는 URL입니다. 서비스 패키지는 동일한 구독 아래의 저장소 계정 또는 저장소 계정의 SAS(공유 액세스 서명) URI에 위치할 수 있습니다. 공유 액세스 서명에 대한 자세한 내용은 공유 액세스 서명으로 액세스 위임(REST API)을 참조하십시오.

Configuration

필수 사항입니다. 배포에 대해 Base-64로 인코딩된 서비스 구성 파일입니다.

Label

필수 사항입니다. Base-64로 인코딩된 클라우드 서비스의 이름입니다. 이름의 길이는 최대 100자입니다.

구독 내에서 고유 레이블을 지정하는 것이 좋습니다. 클라우드 서비스를 식별하는 데 추적용으로 사용할 수 있는 이름입니다.

RoleToUpgrade

선택 사항입니다. 업데이트할 특정 역할 인스턴스의 이름입니다.

Force

필수 사항입니다. 일부 역할 인스턴스에서 로컬 데이터가 손실되더라도 롤백을 진행하는지 여부를 지정합니다. True이면 롤백이 진행되면, false이면 진행되지 않습니다.

Force 요소는 버전 2011-10-01 이후인 경우에만 사용할 수 있습니다.

Name

선택 사항입니다. 확장 클라우드 서비스 속성의 이름을 나타냅니다. 각 확장 속성에는 정의된 이름과 값이 모두 있어야 합니다. 확장 속성 이름/값 쌍은 25개까지 지정할 수 있습니다.

Name 요소의 최대 길이는 64자이고, 이름에 영숫자와 밑줄만 포함할 수 있으며, 이름은 문자로 시작해야 합니다. 다른 문자를 사용하거나, 이름을 문자로 시작하지 않거나, 동일한 클라우드 서비스에서 소유하고 있는 다른 확장 속성의 이름과 동일한 이름을 입력하면 상태 코드 400(잘못된 요청) 오류가 반환됩니다.

Name 요소는 버전 2012-03-01 이후인 경우에만 사용할 수 있습니다.

Value

선택 사항입니다. 확장 클라우드 서비스 속성의 값을 나타냅니다. 각 확장 속성에는 정의된 이름과 값이 모두 있어야 합니다. 확장 속성 이름 및 값 쌍은 25개까지 지정할 수 있으며 각 확장 속성 값의 최대 길이는 255자입니다.

값을 NULL로 설정하여 확장 속성을 삭제합니다.

Value 요소는 버전 2012-03-01 이후인 경우에만 사용할 수 있습니다.

ExtensionConfiguration

선택 사항입니다. 클라우드 서비스에 추가된 확장을 나타냅니다. Windows Azure에서는 프로세스가 클라우드 서비스의 확장으로 실행될 수 있습니다. 예를 들어 원격 데스크톱 액세스 또는 Windows Azure 진단 에이전트가 클라우드 서비스의 확장으로 실행될 수 있습니다. 업데이트 동안 배포에 추가하기 전에 확장 추가를 사용하여 클라우드 서비스에 확장을 추가해야 합니다.

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

클라우드 서비스에 추가된 확장을 나타냅니다.

 

요소 이름 설명

AllRoles

선택 사항입니다. 배포의 모든 역할에 적용되는 확장 목록을 지정합니다.

Extension

필수 사항입니다. 클라우드 서비스의 역할에 배포될 확장을 나타냅니다.

NamedRoles

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

클라우드 서비스의 역할에 배포될 확장을 나타냅니다.

 

요소 이름 설명

Id

필수 사항입니다. 확장의 ID입니다. 클라우드 서비스에 확장을 추가할 때 ID가 생성됩니다. 확장 나열을 사용하여 클라우드 서비스에 추가된 확장의 ID를 찾을 수 있습니다.

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

 

요소 이름 설명

Role

필수 사항입니다. 확장이 추가되는 특정 역할을 나타냅니다.

RoleName

필수 사항입니다. 역할 이름을 지정합니다.

Extension

필수 사항입니다. 클라우드 서비스의 역할에 배포될 확장을 나타냅니다.

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

Upgrade Deployment은 비동기 작업이므로 항상 상태 코드 202(수락)를 반환합니다. 작업이 완료된 후 작업의 상태 코드를 확인하려면 작업 상태 가져오기를 호출합니다. 상태 코드는 이 작업에 대한 응답에 포함됩니다. 성공한 경우의 상태 코드는 200(정상)입니다. 상태 코드에 대한 자세한 내용은 서비스 관리 상태 및 오류 코드를 참조하십시오.

이 작업의 응답에는 다음과 같은 헤더가 포함됩니다. 응답에는 추가 표준 HTTP 헤더가 포함될 수도 있습니다. 모든 표준 헤더는 HTTP/1.1 프로토콜 사양을 따릅니다.

 

응답 헤더 설명

x-ms-request-id

관리 서비스에 대해 수행된 요청을 고유하게 식별하는 값입니다. 비동기 작업의 경우 이 값과 함께 작업 상태 가져오기를 호출하여 작업이 완료되었는지, 실패했는지, 계속 진행 중인지 여부를 확인할 수 있습니다. 자세한 내용은 비동기 서비스 관리 요청 추적을 참조하십시오.

<subscription-id>로 지정된 구독에 연결된 관리 인증서를 사용하여 이 작업을 인증할 수 있습니다. 자세한 내용은 서비스 관리 요청 인증을 참조하십시오.

배포의 자동 업데이트를 수행하려면 automatic으로 설정된 Mode 요소를 사용하여 업그레이드 배포 또는 Change Deployment Configuration을 호출합니다. 추가 입력할 필요 없이 해당 지점에서 업데이트를 진행합니다 작업 상태 가져오기를 호출하여 업데이트가 완료된 시기를 확인할 수 있습니다.

수동 업데이트를 수행하려면 먼저 manual로 설정된 Mode 요소를 사용하여 업그레이드 배포를 호출합니다. 다음으로 업그레이드 도메인 탐색을 호출하여 배포 내의 각 도메인을 업데이트합니다. 다음 도메인을 업데이트하기 전에 작업 상태 가져오기를 호출하여 작업이 완료되었는지 확인해야 합니다.

Important중요
역할 인스턴스가 추가 또는 제거되는 업데이트의 경우 클라우드 서비스에 배포된 모든 역할에 대해 구성 업데이트가 수행됩니다. 모든 역할 인스턴스가 클라우드 서비스에서 함께 통신할 수 있도록 기존 역할 인스턴스는 새 역할 인스턴스에 대해 알림을 받아야 합니다.

기본적으로 클라우드 서비스는 5개의 업데이트 도메인과 함께 배포되며 이러한 업데이트 도메인은 내부 업데이트 동안 한 번에 하나씩 업데이트됩니다. 서비스 정의 파일의 업데이트 도메인 수를 수정하는 방법에 대한 자세한 내용은 Windows Azure 서비스 정의 스키마(.csdef 파일)를 참조하십시오.

Windows Azure에서 특정 인스턴스가 실행되는 업데이트 도메인을 확인하려면 RoleInstance 클래스의 UpdateDomain 속성을 사용합니다. 자세한 내용은 Azure Developer References를 참조하십시오.

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

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