Продажи: 1-800-867-1389
Развернуть Свернуть

Обновление развертывания

Обновлено: Февраль 2015 г.

Асинхронная операция Upgrade Deployment инициирует обновление экземпляров роли в развертывании с помощью указанных вами пакета и конфигурации. Дополнительные сведения об обновлении экземпляров ролей см. в разделе Обновление службы Azure.

Запрос Upgrade Deployment можно указать следующим образом. Заменит�� <subscription-id> идентификатором подписки, <cloudservice-name> — именем облачной службы, <deployment-slot> — вариантом staging или production либо <deployment-name>— именем развертывания.

 

Метод URI запроса

POST

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

POST

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

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

 

Параметр URI Описание

comp=upgrade

Обязательно. Указывает, что развертывание необходимо обновить.

В следующей таблице описаны заголовки запросов.

 

Заголовок запроса Описание

Content-Type

Обязательно. Задайте для этого заголовка значение application/xml.

x-ms-version

Обязательно. Задает версию операции, используемой для этого запроса. Этот заголовок должен быть установлен в значение 01.10.09 или на более позднюю дату. Дополнительные сведения об управлении версиями заголовков см. в разделе Работа с версиями при управлении службами.

Далее приведен формат текста запроса.


<?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>
        <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>
</UpgradeDeployment>

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

 

Имя элемента Описание

Режим

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

  • Auto

  • Manual

  • Simultaneous

Если не указано, то значение по умолчанию равно - Auto. Если это значение равно Manual, то необходимо вызвать WalkUpgradeDomain для применения обновления. Если это значение равно Auto, то обновление автоматически применяется к каждому домену обновления по очереди.

Параметр Simultaneous доступен только в версии 2012-12-01 или более поздней.

PackageUrl

Обязательно. Задает URL-адрес, который указывает на расположение пакета служб в службе BLOB-объектов. Пакет служб может находиться либо в учетной записи хранения в той же подписке, либо по идентификатору URI подписанного URL-адреса (SAS) с любой учетной записи хранения. Дополнительные сведения о подписях общего доступа см. в разделе Делегирование доступа с подписью коллективного доступа.

Конфигурация

Обязательно. Задает файл конфигурации службы для развертывания (в кодировке Base64).

Метка

Обязательно. Указывает имя для облачной службы в кодировке base-64. Имя может содержать до 100 символов. Рекомендуется использовать в подписке уникальную метку. Имя может определять облачную службу в целях отслеживания.

RoleToUpgrade

Необязательно. Указывает имя конкретного обновляемого экземпляра роли.

Force

Обязательно. Указывает, должно ли продолжаться обновление даже в том случае, когда оно приводит к потере локальных данных в каких-либо экземплярах роли. True, если обновление следует продолжить; в противном случае — false.

Элемент Force доступен только при использовании версии 01.10.11 или более поздней.

Название

Необязательно. Задает имя расширенного свойства облачной службы. Каждое расширенное свойство должно иметь и заданное имя, и значение. Может быть максимум 25 расширенных пар из имени свойства и значения.

Максимальная длина элемента Name - 64 символа, в имени допустимы только буквенно-цифровые символы и подчеркивания, имя должно начинаться с буквы. Попытка использовать другие символы, начать имя не с буквы или ввести имя, которое уже имеется у другого расширенного свойства в той же облачной службе, приведет к ошибке с кодом состояния 400 (неправильный запрос).

Элемент Name доступен только при использовании версии 01.03.12 или более поздней.

Значение

Необязательно. Указывает значение расширенного свойства облачной службы. Каждое расширенное свойство должно иметь и заданное имя, и значение. Можно задать не более 25 пар из имени и значения расширенных свойств, максимальная длина каждого расширенного свойства — 255 символов.

Расширенное свойство удаляется путем задания для него значения NULL.

Элемент Value доступен только при использовании версии 01.03.12 или более поздней.

ExtensionConfiguration

Необязательно. Указывает расширение, добавляемое к облачной службе. В Azure процесс может выполняться как расширение облачной службы. Чтобы облачную службу можно было добавлять в развертывание во время обновления, необходимо добавить расширение облачной службы с помощью Добавление расширения.

Элемент ExtensionConfiguration доступен только при использовании версии 01.03.13 или более поздней.

Указывает расширение, добавляемое к облачной службе.

 

Имя элемента Описание

AllRoles

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

Расширение

Обязательно. Указывает расширение для развертывания в роли в облачной службе.

NamedRoles

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

Указывает расширение для развертывания в роли в облачной службе.

 

Имя элемента Описание

Id

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

Область

Необязательно. Указывает состояние расширения. Этот элемент применяется только к настроенным расширениям JSON.

Возможные значения:

  • Enable

  • Disable

  • Uninstall

Значение по умолчанию — Enable.

Элемент State доступен только при использовании версии 01.06.2014 или более поздней.

Задает список расширений, применяемых к конкретным ролям в развертывании.

 

Имя элемента Описание

Роль

Обязательно. Указывает конкретную роль, в которую добавляется расширение.

RoleName

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

Расширение

Обязательно. Указывает расширение для развертывания в роли в облачной службе.

Ответ включает код состояния HTTP и набор заголовков ответа.

Успешная операция возвращает код состояния 200 (ОК). Сведения о кодах состояния см. в разделе Коды состояний и ошибок управления службами.

Ответ для этой операции включает следующие заголовки. Ответ может также включать дополнительные стандартные заголовки HTTP. Все стандартные заголовки соответствуют спецификации протокола HTTP/1.1.

 

Заголовок ответа Описание

x-ms-request-id

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

Отсутствует.

Чтобы выполнить автоматическое обновление развертывания, вызовите Обновление развертывания или Изменение конфигурации развертывания с элементом Mode в значении automatic. После этого обновление продолжится, никаких дополнительных данных вводить не потребуется. Можно вызвать Получение состояния операции, чтобы определить, что обновление завершено.

Выполнять ручное обновление, сначала вызовите Обновление развертывания с элементом Mode в значении manual. Затем вызовите Обновление отдельного домена, чтобы обновить каждый домен в пределах развертывания. Необходимо убедиться, что операция завершена, вызвав получение состояния операции, прежде чем обновлять следующий домен.

ImportantВажно!
Обновление, добавляющее или удаляющее экземпляры ролей, приведет к обновлению конфигурации для всех ролей, развернутых в облачной службе. Существующим экземплярам ролей следует отправить уведомления о новых экземплярах ролей, чтобы все экземпляры ролей могли работать совместно в облачной службе.

По умолчанию облачная служба развертывается с 5 доменами обновления, которые обновляются по одному во время обновления на месте. Дополнительные сведения об изменении числа доменов обновления в файле определения службы см. в разделе Схема определения службы Windows Azure (файл CSDEF).

Для определения домена обновления, в котором выполняется конкретный экземпляр, воспользуйтесь свойством UpdateDomain класса RoleInstance. Дополнительные сведения см. в разделе Microsoft Azure Managed Library Reference.

Была ли вам полезна эта информация?
(1500 символов осталось)
Спасибо за ваш отзыв
Показ:
© 2015 Microsoft