구입하기Buy
1-855-856-7678
지원Support
Windows Azure 서비스 구성 스키마
업데이트 날짜: 2011년 9월
서비스 구성 파일은 서비스의 각 역할에 배포할 역할 인스턴스의 수, 모든 구성 설정의 값 및 역할과 연결된 모든 인증서의 지문을 지정합니다. 서비스 모델은 Windows Azure 서비스 정의 스키마에 의해 설명됩니다.
서비스 구성 파일의 기본 확장명은 .cscfg입니다.
서비스 구성 파일의 기본 형식은 다음과 같습니다.
<ServiceConfiguration serviceName="<service-name>" osFamily=”[1|2]” osVersion="<os-version>">
<Role name="<role-name>">
<Instances count="<number-of-instances>" />
<ConfigurationSettings>
<Setting name="<setting-name>" value="<setting-value>" />
</ConfigurationSettings>
<Certificates>
<Certificate name="<certificate-name>" thumbprint="<certificate-thumbrint>" thumbprintAlgorithm="<algorithm>" />
</Certificates>
<OsImage href="<vhd_image_name>" />
</Role>
</ServiceConfiguration>
서비스 구성 파일의 XML 네임스페이스는 다음과 같습니다.
http://schemas.microsoft.com/ServiceHosting/2008/10/ServiceConfiguration
서비스 구성 파일에는 이러한 요소가 포함되며 다음 항목의 후속 단원에서 자세하게 설명됩니다.
ServiceConfiguration 요소는 서비스 구성 파일의 상위 수준 요소입니다.
다음 표는 ServiceConfiguration 요소의 특성에 대한 설명입니다.
| 특성 | 형식 | 설명 | ||
|---|---|---|---|---|
| serviceName | string | 필수 사항입니다. 서비스 이름입니다. 여기 제공된 이름은 서비스 정의 파일에 지정한 이름과 일치해야 합니다. | ||
| osFamily | string | 선택 사항입니다. 서비스가 실행될 OS 제품군입니다. 유효한 값은 다음과 같습니다.
osFamily 값을 포함시키지 않고 osVersion 특성을 특정 Windows Azure 게스트 OS 버전으로 설정하지 않은 경우 기본값 1이 사용됩니다. 이 특성은 VM 역할에 의해 무시됩니다. | ||
| osVersion | string | 선택 사항입니다. 이 서비스가 실행될 Windows Azure 게스트 OS 버전입니다. 지정하는 Windows Azure 게스트 OS는 개발에 사용한 Windows Azure SDK 버전과 호환되어야 합니다. 호환 가능한 버전의 매트릭스는 Windows Azure 게스트 OS 릴리스 및 SDK 호환성 매트릭스를 참조하십시오. Windows Azure 게스트 OS에 대한 업그레이드 처리 옵션에는 다음 두 가지가 있습니다.
게스트 OS가 자동 업그레이드되도록 지정하려면 osVersion 특성 값을 *로 설정합니다. *로 설정하면 호스팅된 서비스가 지정된 OS 제품군의 최신 게스트 OS 버전을 사용하여 배포되고 새 게스트 OS 버전이 릴리스될 때 자동으로 업그레이드됩니다.
특정 버전을 수동으로 지정하려면 osVersion 특성의 값을 다음 형식으로 지정합니다. 여기서
osVersion 특성의 기본값은 *입니다. 서비스가 현재 실행되고 있는 버전을 확인하는 방법에 대한 자세한 내용은 운영 체제 버전 구성 방법을 참조하십시오. 사용 가능한 버전을 검토하고 Windows Azure SDK와의 호환성을 확인하려면 Windows Azure 게스트 OS 릴리스 및 SDK 호환성 매트릭스를 참조하십시오. |
참고 서비스 구성 파일에는 ServiceConfiguration 요소 하나가 포함되어야 합니다.
ServiceConfiguration 요소에는 임의 개수의 Role 요소가 포함될 수 있습니다.
Role 요소는 서비스에서 정의된 역할의 인스턴스, 구성 설정 및 인증서 지문의 수에 대해 설명합니다.
다음 표에서는 Role 요소의 특성에 대해 설명합니다.
| 특성 | 형식 | 설명 |
|---|---|---|
| name | string | 필수 사항입니다. 역할 이름입니다. 이름은 서비스 정의 파일의 역할에 제공된 이름과 일치해야 합니다. |
Instances 요소는 서비스 배포 중에 배포할 이 역할의 인스턴스 수를 지정합니다. Instances은 구성 파일의 필수 선택 요소입니다.
다음 표에서는 Instances 요소의 특성에 대해 설명합니다.
| 특성 | 형식 | 설명 |
|---|---|---|
| count | int | 필요한 역할 인스턴스의 수입니다. |
ConfigurationSettings 요소는 역할의 구성 설정 컬렉션을 설명합니다. ConfigurationSettings는 구성 파일의 선택 요소입니다.
Setting 요소는 역할 인스턴스의 구성 설정에 값을 제공하는 이름-값 쌍을 설명합니다. 구성 설정의 이름은 서비스 정의 파일에 선언됩니다.
다음 표에서는 Setting 요소의 특성에 대해 설명합니다.
| 특성 | 형식 | 설명 |
|---|---|---|
| name | string | 필수 사항입니다. 구성 설정의 고유한 이름입니다. 이름은 서비스 정의 파일의 구성 설정에 선언된 이름과 일치해야 합니다. |
| value | string | 필수 사항입니다. 구성 설정의 값입니다. |
Certificates 요소는 역할의 인증서 컬렉션을 설명합니다. Certificates는 구성 파일의 선택 요소입니다.
Certificate 요소는 이 역할에 정의된 인증서와 연결된 지문 및 알고리즘에 대해 설명합니다.
다음 표에서는 Certificate 요소의 특성에 대해 설명합니다.
| 특성 | 형식 | 설명 |
|---|---|---|
| name | string | 필수 사항입니다. 인증서 이름은 서비스 정의 파일에 제공된 이름과 일치해야 합니다. |
| thumbprint | string | 필수 사항입니다. 인증서 지문입니다. 이 값의 문자열은 비워 둘 수 없습니다. 인증서 지문은 공백이 없는 16진수 문자열입니다. 16진수는 숫자와 대문자 영문자를 사용하여 표시됩니다. |
| thumbprintAlgorithm | string | 필수 사항입니다. 인증서 지문을 생성하는 데 사용되는 알고리즘입니다. |
OSImage 요소는 VM 역할에 대한 VHD의 이름을 지정합니다. OSImage는 VM 역할에 대한 구성 파일의 필수 요소입니다.
| 특성 | 형식 | 설명 |
|---|---|---|
| href | string | VM 역할 배포의 필수 사항입니다. VHD 이름입니다. |
