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

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

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