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

업그레이드 도메인 탐색

업데이트 날짜: 2014년 4월

Walk Upgrade Domain 작업은 역할 인스턴스가 업데이트되어야 하는 업데이트 도메인을 지정합니다. 역할 인스턴스 업데이트에 대한 자세한 내용은 Windows Azure 서비스 업데이트를 참조하십시오.

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

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

요청 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>/?comp=walkupgradedomain

HTTP/1.1

POST

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

HTTP/1.1

 

URI 매개 변수 설명

comp=walkupgradedomain

필수 사항입니다. 수동 내부 업데이트 동안 배포의 역할 인스턴스가 업데이트 도메인을 한 번에 하나씩 업데이트하도록 지정합니다.

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

 

요청 헤더 설명

Content-Type

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

x-ms-version

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

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


<?xml version="1.0" encoding="utf-8"?>
<WalkUpgradeDomain xmlns="http://schemas.microsoft.com/windowsazure">
  <UpgradeDomain>update-domain-id</UpgradeDomain>
</WalkUpgradeDomain>

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

 

요소 이름 설명

UpgradeDomain

필수 사항입니다. 업데이트할 업데이트 도메인을 식별하는 정수 값입니다. 업데이트 도메인은 인덱스(0부터 시작)로 식별됩니다. 즉, 첫 번째 업데이트 도메인은 ID가 0이고 두 번째 업데이트 도메인은 ID가 1이 됩니다.

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

Walk Upgrade Domain은 비동기 작업이므로 작업 상태 가져오기를 호출하여 작업이 완료되었는지, 실패했는지, 계속 진행 중인지 여부를 확인해야 합니다. 여러 도메인을 업그레이드하는 경우 다음 도메인을 업그레이드하기 전에 작업 상태 가져오기를 호출하여 업그레이드가 완료되었는지 확인해야 합니다.

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

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

 

응답 헤더 설명

x-ms-request-id

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

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

Walk Upgrade Domain 작업을 호출하기 전에 업그레이드 배포, Change Deployment Configuration 또는 업데이트 또는 업그레이드 롤백을 호출해야 합니다.

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

배포에 대해 수동 업데이트를 수행하려면 다음 순서로 작업을 진행합니다.

  1. Mode 요소를 manual로 설정하고 업그레이드 배포를 호출합니다.

  2. Walk Upgrade Domain을 호출하여 배포 내의 각 도메인을 업데이트합니다. 순서대로 업데이트 도메인을 업데이트해야 합니다. 예를 들어 도메인 0부터 시작하여 도메인 1의 순서로 업데이트합니다.

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

업데이트가 진행되는 동안 배포 가져오기를 호출하여 업데이트 상태를 확인합니다. 업데이트가 진행 중인 경우 Get Deployment는 업데이트에 대한 정보가 들어 있는 UpgradeStatus 요소를 반환합니다. 업데이트가 완료되었거나 진행 중인 업데이트가 없는 경우에는 UpgradeStatus 요소가 Null입니다.

표시:
© 2014 Microsoft