Как включить развертывание HTTP

По умолчанию Edge использует RPC для развертывания прокси API. Хотя этот режим хорошо подходит для большинства установок, в крупных топологиях с большим количеством MP могут возникать тайм-ауты, когда через RPC выполняется большое количество одновременных вызовов. В будущем Apigee планирует прекратить поддержку этой реализации.

Поэтому Apigee рекомендует использовать HTTP, а не RPC для развертывания крупных систем.

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

В этом разделе рассказывается, как включить HTTP для развертывания.

Как обновить информацию об организации

Чтобы включить развертывание HTTP, отправьте запрос PUT к API для обновления свойств организации. В теле запроса задайте следующие свойства:

Свойство Описание
allow.deployment.over.http Определяет, может ли Edge развертывать прокси API через HTTP (в дополнение к RPC). Установите значение true, чтобы разрешить развертывание по протоколу HTTP, или false. Значение по умолчанию – false.

Чтобы включить развертывания HTTP, установите для этого свойства значение true.
use.http.for.configuration

Указывает, какой метод использовать для событий конфигурации. Возможные значения:

  • never: все события конфигурации используют RPC. Это значение используется по умолчанию.
  • retry: все события конфигурации сначала используют RPC; если событие не удается обработать с помощью RPC, Edge пытается использовать HTTP. Если вам нужно использовать HTTP, это может привести к задержкам.
  • always: все события конфигурации используют протокол HTTP.

Чтобы включить развертывания HTTP, Apigee рекомендует задать для этого свойства значение always.

Помимо указания этих свойств в теле письма, необходимо задать для заголовка Content-Type значение application/json или application/xml.

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

curl -u admin_email:admin_password
  "http://management_server_IP:8080/v1/organizations/org_name"
  -X POST -H "Content-Type: application/json" -d
  '{
    "properties" : {
      "property" : [
      {
        "name" : "allow.deployment.over.http",
        "value" : "true"
      },
      {
        "name" : "use.http.for.configuration",
        "value" : "always"
      } ]
    }
  }'

Чтобы включить развертывание HTTP для всех прокси API во всех организациях, вам нужно обновить каждую организацию, как описано выше.

Как протестировать обновление

Чтобы проверить, успешно ли выполнено обновление, запустите событие развертывания в прокси-сервере API в обновленной организации, а затем просмотрите файлы журнала Message Processor. Запись в журнале для событий развертывания должна содержать mode:API.

Подробнее о файлах журналов…