Экспорт (0) Печать
Развернуть все

Схема WebRole

Обновлено: Август 2014 г.

[В этом разделе содержатся предварительные сведения для текущего выпуска Microsoft Azure.]

Веб-роль Azure — это роль, приспособленная для программирования веб-приложений, поддерживаемая IIS 7, например ASP.NET, PHP, Windows Communication Foundation и FastCGI.

Расширение по умолчанию для файла определения службы — CSDEF.

Стандартный формат файла определения службы, содержащего веб-роль, имеет следующий вид.


<ServiceDefinition …>
  <WebRole name="<web-role-name>" vmsize="<web-role-size>" enableNativeCodeExecution="[true|false]">
    <Certificates>
      <Certificate name="<certificate-name>" storeLocation="<certificate-store>" storeName="<store-name>" />
    </Certificates>    
    <ConfigurationSettings>
      <Setting name="<setting-name>" />
    </ConfigurationSettings>
    <Imports>
      <Import moduleName="<import-module>"/>
    </Imports>
    <Endpoints>
      <InputEndpoint certificate="<certificate-name>" ignoreRoleInstanceStatus="[true|false]" name="<input-endpoint-name>" protocol="[http|https|tcp|udp]" localPort="<port-number>" port="<port-number>" loadBalancerProbe=”<load-balancer-probe-name>” />
      <InternalEndpoint name="<internal-endpoint-name>" protocol="[http|tcp|udp|any]" port="<port-number>">
         <FixedPort port="<port-number>"/>
         <FixedPortRange min="<minium-port-number>" max="<maximum-port-number>"/>
      </InternalEndpoint>
     <InstanceInputEndpoint name="<instance-input-endpoint-name>" localPort="<port-number>" protocol="[udp|tcp]">
         <AllocatePublicPortFrom>
            <FixedPortRange min="<minium-port-number>" max="<maximum-port-number>"/>
         </AllocatePublicPortFrom>
      </InstanceInputEndpoint>
    </Endpoints>
    <LocalResources>
      <LocalStorage name="<local-store-name>" cleanOnRoleRecycle="[true|false]" sizeInMB="<size-in-megabytes>" />
    </LocalResources>
    <LocalStorage name="<local-store-name>" cleanOnRoleRecycle="[true|false]" sizeInMB="<size-in-megabytes>" />
    <Runtime executionContext="[limited|elevated]">
      <Environment>
         <Variable name="<variable-name>" value="<variable-value>">
            <RoleInstanceValue xpath="<xpath-to-role-environment-settings>"/>
          </Variable>          
      </Environment>
      <EntryPoint>
         <NetFxEntryPoint assemblyName="<name-of-assembly-containing-entrypoint>" targetFrameworkVersion="<.net-framework-version>"/>
      </EntryPoint>
    </Runtime>
    <Sites>
      <Site name="<web-site-name>">
        <VirtualApplication name="<application-name>" physicalDirectory="<directory-path>"/>
        <VirtualDirectory name="<directory-path>" physicalDirectory="<directory-path>"/>
        <Bindings>
          <Binding name="<binding-name>" endpointName="<endpoint-name-bound-to>" hostHeader="<url-of-the-site>"/>
        </Bindings>
      </Site>
    </Sites>
    <Startup priority="<for-internal-use-only>”>
      <Task commandLine="<command-to=execute>" executionContext="[limited|elevated]" taskType="[simple|foreground|background]">
        <Environment>
         <Variable name="<variable-name>" value="<variable-value>">
            <RoleInstanceValue xpath="<xpath-to-role-environment-settings>"/>
          </Variable>          
        </Environment>
      </Task>
    </Startup>
    <Contents>
      <Content destination="<destination-folder-name>" >
        <SourceDirectory path="<local-source-directory>" />
      </Content>
    </Contents>
  </WebRole>
</ServiceDefinition>

Элемент WebRole описывает роль, приспособленную для программирования веб-приложений, поддерживаемую IIS 7 и ASP.NET. Служба может содержать количество веб-ролей от 0 и больше.

В следующей таблице приводится описание атрибутов элемента WebRole.

 

Атрибут Type Описание

name

строка

Обязательно. Имя для веб-роли. Имя роли должно быть уникальным.

enableNativeCodeExecution

boolean

Необязательно. Значение по умолчанию — true, по умолчанию включено выполнение машинного кода и полный уровень доверия. Установите этому атрибуту значение false, чтобы отключить выполнения машинного кода в веб-роли и использовать лишь частичный уровень доверия Azure.

vmsize

строка

Необязательно. Задайте это значение, чтобы изменить размер виртуальных машин, выделяемых роли. Значение по умолчанию — Small. Дополнительные сведения см. в Размеры виртуальных машин и облачных служб для Azure.

Элемент ConfigurationSettings описывает коллекцию параметров конфигурации для веб-роли. Этот элемент является родительским для элемента Setting.

Элемент Setting описывает пару «имя-значение», которая определяет параметр конфигурации для экземпляра роли.

В следующей таблице приводится описание атрибутов элемента Setting.

 

Атрибут Type Описание

name

строка

Обязательно. Уникальное имя параметра конфигурации.

Параметры конфигурации для роли - это пары «имя-значение», которые объявляются в файле определения службы и задаются в файле конфигурации службы.

Элемент LocalResources описывает коллекцию ресурсов локального хранилища для веб-роли. Этот элемент является родительским для элемента LocalStorage.

Элемент LocalStorage определяет ресурс локального хранилища, который обеспечивает место файловой системы для службы во время выполнения. Для роли можно определить нуль и больше ресурсов локального хранилища.

noteПримечание
Элемент LocalStorage может быть потомком элемента WebRole для поддержки совместимости с предыдущими версиями пакета Azure SDK.

В следующей таблице приводится описание атрибутов элемента LocalStorage.

 

Атрибут Type Описание

name

строка

Обязательно. Уникальное имя для локального хранилища.

cleanOnRoleRecycle

boolean

Необязательно. Показывает, должно ли очищаться локальное хранилище при перезапуске роли. Значение по умолчанию: true.

sizeInMb

int

Необязательно. Заданный объем для выделения в локальном хранилище в МБ. Если не указано, по умолчанию выделяется 100 МБ в хранилище. Минимальный объем места хранения, который может быть выделен, — 1 МБ.

Максимальный размер локальных ресурсов зависит от размера ВМ. Дополнительные сведения см. в Размеры виртуальных машин и облачных служб для Azure.

Имя каталога, выделенного для ресурса локального хранилища, соответствует значению, указанному в атрибуте name. Дополнительные сведения по осуществлению доступа к ресурсу локального хранилища из кода, запущенного в рамках роли экземпляра, см. в разделе Настройка ресурсов локального хранилища.

Элемент Endpoints описывает коллекцию конечных точек ввода (внешних), внутренних конечных точек и конечных точек ввода для экземпляра роли. Этот элемент является родительским для элементов InputEndpoint, InternalEndpoint и InstanceInputEndpoint.

Конечные точки ввода и внутренние конечные точки выделяются по отдельности. Служба может иметь в общей сложности до 25 конечных точек (входных, внутренних и конечных точек экземпляров), которые могут быть распределены между 25 ролями службы. Например, если имеется 5 ролей, можно выделить по 5 конечных точек ввода каждой роли или 25 конечных точек ввода одной роли, можно также выделить по 1 конечной точке ввода каждой из 25 ролей.

noteПримечание
Для каждой развернутой роли требуется один экземпляр. По умолчанию провизионирование для подписки ограничено 20 ядрами и, следовательно, 20 экземплярами роли. Если приложению требуется больше экземпляров, чем это гарантирует стандартное провизионирование, см. в разделе Выставление счетов, управление подпиской и поддержка квот для получения дополнительных сведений об увеличении квот.

Элемент InputEndpoint описывает внешнюю конечную точку веб-роли.

Можно определить несколько конечных точек, которые могут являться сочетанием точек с протоколом HTTP, HTTPS, UDP и TCP. Для входной конечной точки можно задать любой номер порта, но номера портов, указанные для каждой роли в службе, должны быть уникальными. Например, если задать веб-роли порт 80 для HTTP и порт 443 для HTTPS, затем можно указать, что вторая веб-роль использует порт 8080 для HTTP и порт 8043 для HTTPS.

В следующей таблице приводится описание атрибутов элемента InputEndpoint.

 

Атрибут Type Описание

name

строка

Обязательно. Уникальное имя внешней конечной точки.

protocol

строка

Обязательно. Транспортный протокол для внешней конечной точки. Для веб-роли допустимы следующие значения: HTTP, HTTPS, UDP и TCP.

port

int

Обязательно. Порт для внешней конечной точки. Можно задать любой номер порта, но номера, указанные для каждой роли в службе, должны быть уникальными.

Возможный диапазон значений: от 1 до 65 535 включительно (Azure пакет SDK версии 1.7 и выше).

certificate

строка

Требуется для конечной точки HTTPS. Имя сертификата, определенное в Certificate.

localPort

int

Необязательно. Определяет порт для внутренних соединений на конечной точке. Атрибут localPort сопоставляет внешний порт конечной точки с внутренним портом в роли. Это полезно в тех случаях, когда роль взаимодействует с внутренним компонентом через порт, отличный от того, что открыт наружу.

Если не указано, значение localPort совпадает со значением атрибута port. Установите свойство localPort в значение «*», чтобы автоматически назначался нераспределенный порт, который можно обнаружить с помощью API среды выполнения.

Возможный диапазон значений: от 1 до 65 535 включительно (Azure пакет SDK версии 1.7 и выше).

Атрибут localPort доступен только при использовании Azure SDK версии 1,3 и выше.

ignoreRoleInstanceStatus

boolean

Необязательно. Если значение этого атрибута равно true, состояние службы не учитывается и конечная точка не удаляется подсистемой балансировки нагрузки. Задание значения true для этого атрибута может быть полезно при выполнении отладки занятых экземпляров службы. Значение по умолчанию — false.

noteПримечание
Конечная точка все еще может получить трафик, даже если роль не находится в состоянии Ready.

loadBalancerProbe

строка

Необязательно. Имя зонда подсистемы балансировки нагрузки, связанного с конечной точкой ввода. Дополнительные сведения см. в Схема LoadBalancerProbe.

Элемент InternalEndpoint описывает внутреннюю конечную точку веб-роли. Внутренняя конечная точка доступна только для других экземпляров ролей, выполняемых в рамках службы. Она недоступна клиентам вне службы. Веб-роли, не имеющие элемента Sites, могут иметь только одну внутреннюю конечную точку HTTP, UDP или TCP.

В следующей таблице приводится описание атрибутов элемента InternalEndpoint.

 

Атрибут Type Описание

name

строка

Обязательно. Уникальное имя внутренней конечной точки.

protocol

строка

Обязательно. Транспортный протокол для внутренней конечной точки. Возможные значения: HTTP, TCP, UDP или ANY.

Значение ANY обозначает, что разрешены любые протоколы и порты.

port

int

Необязательно. Порт, используемый для внутренних, сбалансированных по нагрузке соединений в конечной точке. Конечная точка, сбалансированная по нагрузке, использует два порта. Порт, используемый для открытого IP-адреса, и порт, используемый для закрытого IP-адреса. Обычно им даются одинаковые номера, но вы можете использовать разные порты.

Возможный диапазон значений: от 1 до 65 535 включительно (Azure пакет SDK версии 1.7 и выше).

Атрибут Port доступен только при использовании Azure SDK версии 1,3 и выше.

Элемент InstanceInputEndpoint описывает конечные точки ввода экземпляра для веб-роли. Конечная точка ввода экземпляра связана с определенным экземпляром роли благодаря перенаправлению портов в подсистеме балансировки нагрузки. Каждая конечная точка ввода экземпляра сопоставляется с определенным портом из диапазона возможных портов. Этот элемент является родительским для элемента AllocatePublicPortFrom.

Элемент InstanceInputEndpoint доступен только при использовании пакета Azure SDK версии 1,7 и выше.

В следующей таблице приводится описание атрибутов элемента InstanceInputEndpoint.

 

Атрибут Type Описание

name

строка

Обязательно. Уникальное имя конечной точки.

localPort

int

Обязательно. Указывает внутренний порт, который будут слушать все экземпляры роли для получения пересланного из подсистемы балансировки нагрузки входящего трафика. Возможный диапазон значений: от 1 до 65 535 включительно.

protocol

строка

Обязательно. Транспортный протокол для внутренней конечной точки. Возможные значения — udp или tcp. Используйте tcp для HTTP- или HTTPS-трафика.

Элемент AllocatePublicPortFrom описывает диапазон открытых портов, который может быть использован внешними клиентами для обращения к каждой конечной точке ввода экземпляра. Номер открытого (VIP) порта выделяется из этого диапазона и назначается каждой конечной точке конкретного экземпляра роли во время развертывания и обновления клиента. Этот элемент является родительским для элемента FixedPortRange.

Элемент AllocatePublicPortFrom доступен только при использовании пакета Azure SDK версии 1,7 и выше.

Элемент FixedPort указывает порт для внутренней конечной точки, которая обеспечивает подключения с выравниванием нагрузки к конечной точке.

Элемент FixedPort доступен только при использовании пакета Azure SDK версии 1,3 и выше.

В следующей таблице приводится описание атрибутов элемента FixedPort.

 

Атрибут Type Описание

port

int

Обязательно. Порт для внутренней конечной точки. Это имеет такой же эффект, как задание минимального и максимального FixedPortRange на том же порту.

Возможный диапазон значений: от 1 до 65 535 включительно (Azure пакет SDK версии 1.7 и выше).

Элемент FixedPortRange указывает диапазон портов, назначенных для внутренней конечной точки или конечной точки входа экземпляра, и задает порт, используемый для подключений с балансировкой нагрузки к конечной точке.

noteПримечание
Элемент FixedPortRange работает различным образом в зависимости от элемента, в котором он размещен. Если элемент FixedPortRange находится в элементе InternalEndpoint, он открывает все порты в подсистеме балансировки нагрузки в пределах диапазона атрибутов min и max для всех виртуальных машин, на которых выполняется роль. Если элемент FixedPortRange находится в элементе InstanceInputEndpoint, он откроет только один порт в пределах диапазона атрибутов min и max на каждой виртуальной машине, где выполняется роль.

Элемент FixedPortRange доступен только при использовании пакета Azure SDK версии 1,3 и выше.

В следующей таблице приводится описание атрибутов элемента FixedPortRange.

 

Атрибут Type Описание

min

int

Обязательно. Минимальный порт в диапазоне. Возможный диапазон значений: от 1 до 65 535 включительно (Azure пакет SDK версии 1.7 и выше).

max

строка

Обязательно. Максимальный порт в диапазоне. Возможный диапазон значений: от 1 до 65 535 включительно (Azure пакет SDK версии 1.7 и выше).

Элемент Certificates описывает коллекцию сертификатов для веб-роли. Этот элемент является родительским для элемента Certificate. Роль может иметь любое количество связанных сертификатов. Дополнительные сведения об использовании элементов сертификатов см. в разделе Сопоставление сертификата со службой.

Элемент Certificate описывает сертификат, связанный с веб-ролью.

В следующей таблице приводится описание атрибутов элемента Certificate.

 

Атрибут Type Описание

name

строка

Обязательно. Имя для этого сертификата, которое используется для его указания, если он связан с элементом HTTPS InputEndpoint.

storeLocation

строка

Обязательно. Расположение хранилища сертификатов на локальном компьютере, где находится этот сертификат. Возможными значениями являются CurrentUser и LocalMachine.

storeName

строка

Обязательно. Имя хранилища сертификатов на локальном компьютере, где этот сертификат хранится. Возможные значения включают встроенные имена My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook или любое пользовательское имя хранилища. Если указано пользовательское имя хранилища, то хранилище создается автоматически.

permissionLevel

строка

Необязательно. Задает разрешения доступа, предоставленные процессам роли. Если доступ к закрытому ключу нужно предоставить только повышенным процессам, укажите разрешение elevated. Разрешение limitedOrElevated предоставляет доступ к закрытому ключу всем процессам роли. Возможные значения — limitedOrElevated или elevated. Значение по умолчанию — limitedOrElevated.

Элемент Imports описывает коллекцию модулей импорта для веб-роли, которые добавляют компоненты в гостевую операционную систему. Этот элемент является родительским для элемента Import. Этот элемент не является обязательным, и роль может иметь один блок времени выполнения.

Элемент Imports доступен только при использовании пакета Azure SDK версии 1,3 и выше.

Элемент Import указывает модуль для добавления в гостевую операционную систему.

Элемент Import доступен только при использовании пакета Azure SDK версии 1,3 и выше.

В следующей таблице приводится описание атрибутов элемента Import.

 

Атрибут Type Описание

moduleName

строка

Обязательно. Имя импортируемого модуля. Допустимы следующие модули:

  • RemoteAccess

  • RemoteForwarder

  • Диагностика

Модули RemoteAccess и RemoteForwarder позволяют настроить экземпляр роли для удаленных подключений рабочего стола. Дополнительные сведения см. в статье Настройка удаленного подключения к рабочему столу для роли в Azure.

Модуль Diagnostics позволяет собирать данные диагностики для экземпляра роли. Дополнительные сведения см. в статье Initialize the Azure Diagnostic Monitor.

Элемент Runtime описывает коллекцию параметров переменных среды для веб-роли, которые управляют средой выполнения хост-процесса Azure. Этот элемент является родительским для элемента Environment. Этот элемент не является обязательным, и роль может иметь один блок времени выполнения.

Элемент Runtime доступен только при использовании пакета Azure SDK версии 1,3 и выше.

В следующей таблице приводится описание атрибутов элемента Runtime.

 

Атрибут Type Описание

executionContext

строка

Необязательно. Задает контекст, в котором запускается процесс роли. Контекст о умолчанию — limited.

  • limited — процесс запускается без прав администратора.

  • elevated — процесс запускается с правами администратора.

Элемент Environment описывает коллекцию параметров переменных среды для веб-роли. Этот элемент является родительским для элемента Variable. Роль может иметь любое количество заданных переменных среды.

Элемент Variable указывает переменную среды для установления в гостевой операционной системе.

Элемент Variable доступен только при использовании пакета Azure SDK версии 1,3 и выше.

В следующей таблице приводится описание атрибутов элемента Variable.

 

Атрибут Type Описание

name

строка

Обязательно. Имя задаваемой переменной среды.

value

строка

Необязательно. Значение, устанавливаемое для переменной среды. Необходимо включить либо атрибут значения, либо элемент RoleInstanceValue.

Элемент RoleInstanceValue задает xPath, из которого берется значение переменной.

В следующей таблице приводится описание атрибутов элемента RoleInstanceValue.

 

Атрибут Type Описание

xpath

строка

Необязательно. Путь расположения параметров развертывания для экземпляра. Дополнительные сведения см. в Значения xPath в Azure.

Необходимо включить либо атрибут значения, либо элемент RoleInstanceValue.

Элемент EntryPoint указывает точку входа для роли. Этот элемент является родительским для элементов NetFxEntryPoint. Эти элементы позволяют указать в качестве точки входа приложение, отличное от стандартного WaWorkerHost.exe.

Элемент EntryPoint доступен только при использовании пакета Azure SDK версии 1.5 и выше.

Элемент NetFxEntryPoint задает запускаемую для роли программу.

noteПримечание
Элемент NetFxEntryPoint доступен только при использовании пакета Azure SDK версии 1.5 и выше.

В следующей таблице приводится описание атрибутов элемента NetFxEntryPoint.

 

Атрибут Type Описание

assemblyName

строка

Обязательно. Путь и имя файла сборки, содержащей точку входа. Этот путь является относительным к папке \%ROLEROOT%\Approot (не указывайте \%ROLEROOT%\Approot в commandLine, это подразумевается). %ROLEROOT% — переменная среды, поддерживаемая Azure, представляет расположение корневой папки для роли. Папка \%ROLEROOT%\Approot представляет папку приложения для роли.

Для ролей HWC путь задается всегда по отношению к папке \%ROLEROOT%\Approot\bin.

Для веб-ролей Full IIS и IIS express, если сборку не удается найти относительно папки \%ROLEROOT%\Approot, производится поиск в \%ROLEROOT%\Approot\bin.

Это поведение не рекомендуется использовать для полной версии служб IIS. Возможно, оно будет удалено в будущих версиях.

targetFrameworkVersion

строка

Обязательно. Версия платформы .NET, в которой была построена сборка. Пример: targetFrameworkVersion="v4.0".

Элемент Sites описывает коллекцию веб-сайтов и веб-приложений, которые размещаются в веб-роли. Этот элемент является родительским для элемента Site. Если не указать элемент Sites, то веб-роль будет размещаться как традиционная веб-роль, в которой может размещаться только один веб-сайт. Дополнительные сведения о настройке элемента Sites см. в разделе Настройка веб-роли для нескольких веб-сайтов. Этот элемент не является обязательным, и роль может иметь только один блок Sites.

Элемент Sites доступен только при использовании пакета Azure SDK версии 1,3 и выше.

Элемент Site определяет веб-сайт или веб-приложение, которые являются частью веб-роли.

Элемент Site доступен только при использовании пакета Azure SDK версии 1,3 и выше.

В следующей таблице приводится описание атрибутов элемента Site.

 

Атрибут Type Описание

name

строка

Обязательно. Имя веб-сайта или веб-приложения.

physicalDirectory

строка

Расположение каталога содержимого для корневого каталога сайта. Расположение может быть указано как абсолютный путь или как относительный путь от места размещения файла CSDEF.

Элемент VirtualApplication определяет приложение в службах IIS 7, это группирование файлов, которое предоставляет содержимое или услуги посредством определенных протоколов, например HTTP. При создании приложения в IIS 7 путь приложения включается в состав URL-адреса сайта.

Элемент VirtualApplication доступен только при использовании пакета Azure SDK версии 1,3 и выше.

В следующей таблице приводится описание атрибутов элемента VirtualApplication.

 

Атрибут Type Описание

name

строка

Обязательно. Задает имя, определяющее виртуальное приложение.

physicalDirectory

строка

Обязательно. Указывает путь к виртуальному приложению на компьютере разработчика. В эмуляторе вычислений службы IIS настроены на извлечение содержимого из этого расположения. При развертывании в Azure содержимое физического каталога упаковывается вместе с остальными файлами службы. Если пакет службы разворачивается в Azure, службы IIS настраиваются на расположение распакованного содержимого.

Элемент VirtualDirectory определяет название каталога (он же путь) в IIS и его сопоставление с физическим каталогом на локальном или удаленном сервере.

Элемент VirtualDirectory доступен только при использовании пакета Azure SDK версии 1,3 и выше.

В следующей таблице приводится описание атрибутов элемента VirtualDirectory.

 

Атрибут Type Описание

name

строка

Обязательно. Задает имя, определяющее виртуальный каталог.

value

physicalDirectory

Обязательно. Определяет путь на компьютере разработчика, содержащий содержимое веб-сайта или виртуального каталога. В эмуляторе вычислений службы IIS настроены на извлечение содержимого из этого расположения. При развертывании в Azure содержимое физического каталога упаковывается вместе с остальными файлами службы. Если пакет службы разворачивается в Azure, службы IIS настраиваются на расположение распакованного содержимого.

Элемент Bindings описывает коллекцию привязок для веб-сайта. Этот элемент является родительским для элемента Binding. Элемент является обязательным для каждого элемента Site. Дополнительные сведения о настройке конечных точек см. в разделе Включение обмена данными для экземпляров роли в Azure.

Элемент Bindings доступен только при использовании пакета Azure SDK версии 1,3 и выше.

Элемент Binding определяет детали конфигурации, необходимые для взаимодействия запросов с веб-сайтом и веб-приложением.

Элемент Binding доступен только при использовании пакета Azure SDK версии 1,3 и выше.

 

Атрибут Type Описание

name

строка

Обязательно. Задает имя для идентификации привязки.

endpointName

строка

Обязательно. Задает имя конечной точки для привязки.

hostHeader

строка

Необязательно. Указывает имя узла, что позволяет размещать несколько сайтов с различными именами на одном сочетании IP-адреса и номера порта.

Элемент Startup описывает коллекцию задач, которые выполняются при запуске роли. Этот элемент может быть родительским для элемента Variable. Дополнительные сведения об использовании задач запуска роли см. в разделе Настройка компонентов IIS в Azure. Этот элемент не является обязательным, и роль может иметь только один блок задач запуска.

В следующей таблице приводится описание атрибута элемента Startup.

 

Атрибут Type Описание

priority

int

Только для внутреннего использования.

Элемент Task указывает задачу запуска, которая выполняется при запуске роли. Задачи запуска могут использоваться для провизионирования выполнения роли, например для установки программного обеспечения или запуска других приложений. Задачи выполняются в порядке, в котором они появляются в блоке элемента Startup.

Элемент Task доступен только при использовании пакета Azure SDK версии 1,3 и выше.

В следующей таблице приводится описание атрибутов элемента Task.

 

Атрибут Type Описание

commandLine

строка

Обязательно. Скрипт, например CMD-файл, содержащий выполняемые команды. Команда запуска и пакетные файлы должны храниться в формате ANSI. Форматы файлов, в которых устанавливается маркер порядка следования байтов в начале файла, обрабатываются неправильно.

executionContext

строка

Определяет контекст, в котором выполняется скрипт.

  • limited [по умолчанию] — запуск с такими же правами доступа, как у роли, в которой размещается процесс.

  • elevated — запуск с правами администратора.

taskType

строка

Указывает режим выполнения команды.

  • simple [по умолчанию] — система ждет завершения задачи перед запуском любых других задач.

  • background — система не ждет завершения задачи.

  • foreground— аналогично фоновому режиму, за исключением того, что роль не перезапускается, пока не завершатся все задачи переднего плана.

Элемент Contents описывает коллекцию содержимого для веб-роли. Этот элемент является родительским для элемента Content.

Элемент Contents доступен только при использовании пакета Azure SDK версии 1.5 и выше.

Элемент Content определяет расположение источника содержимого, которое будет скопировано на виртуальную машину Azure и целевой путь копирования.

Элемент Content доступен только при использовании пакета Azure SDK версии 1.5 и выше.

В следующей таблице приводится описание атрибутов элемента Content.

 

Атрибут Type Описание

назначение

строка

Обязательно. Расположение на виртуальной машине Azure, в которое будет помещено содержимое. Задается по отношению к папке %ROLEROOT%\Approot.

Этот элемент является родительским для элемента SourceDirectory.

Элемент SourceDirectory определяет локальный каталог, из которого копируется содержимое. Используйте этот элемент для указания локального содержимого, чтобы скопировать его на виртуальную машину Azure.

Элемент SourceDirectory доступен только при использовании пакета Azure SDK версии 1.5 и выше.

В следующей таблице приводится описание атрибутов элемента SourceDirectory.

 

Атрибут Type Описание

path

строка

Обязательно. Относительный или абсолютный путь локального каталога, чье содержимое будет скопировано на виртуальную машину Azure. Поддерживается расширение переменных среды в пути каталога.

См. также

Основные понятия

Справочник по схеме

Корпорация Майкрософт проводит интернет-опрос, чтобы выяснить ваше мнение о веб-сайте MSDN. Если вы желаете принять участие в этом интернет-опросе, он будет отображен при закрытии веб-сайта MSDN.

Вы хотите принять участие?
Показ:
© 2014 Microsoft