Включить 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 в обновленной организации, а затем просмотрите файлы журнала обработчика сообщений. Запись журнала для событий развертывания должна содержать mode:API .

Дополнительную информацию см. в разделе Файлы журналов .

,

По умолчанию 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 в обновленной организации, а затем просмотрите файлы журнала обработчика сообщений. Запись журнала для событий развертывания должна содержать mode:API .

Дополнительную информацию см. в разделе Файлы журналов .