Начало работы с Node.js в Apigee Edge

Вы просматриваете документацию Apigee Edge .
Перейдите к документации Apigee X. информация

В этом разделе объясняется самый простой способ обернуть приложение Node.js в прокси-сервер API с помощью пользовательского интерфейса управления.

Введение

Скорее всего, первое приложение Node.js, которое вы когда-либо создали, было HTTP-сервером, который отвечал на запросы фразой «Hello World!» Самый простой способ опробовать Node.js в Apigee Edge — сделать что-то очень похожее. Всего несколькими щелчками мыши вы получите работающий проксируемый HTTP-сервер Node.js, работающий на Edge. После этого вы можете использовать редактор кода в пользовательском интерфейсе, чтобы изменить приложение Node.js, добавить дополнительные файлы Node.js, добавить политики и т. д.

Создание образца Hello World! API-прокси

В этом разделе объясняется, как создать прокси-сервер Edge API, который взаимодействует с HTTP-сервером Node.js. Код HTTP-сервера Node.js уже написан для вас и автоматически развертывается в Edge, когда вы выполняете эти простые шаги.
  1. В мастере создания прокси выберите Приложение Node.js.
  2. Нажмите Далее .
  3. Следуйте указаниям мастера создания прокси-сервера и выберите следующие параметры.
    Поле Выбор
    Подробности
    Имя прокси Введите Nodejs-Hello . Имя, отображаемое для вашего API.
    Базовый путь прокси-сервера Введите nodejs-привет
    Источник Выберите образец «Hello World» . (Другие варианты мы обсудим позже в этой теме.)
    Описание Введите описание API.
    Безопасность
    Пройти (нет) Выберите «Пропустить» (нет) . Создает простой проход через прокси.
    Виртуальные хосты
    по умолчанию, безопасный Не меняйте настройки по умолчанию. Дополнительные сведения о виртуальных хостах см. в разделе О виртуальных хостах (бета-версия) .
    Строить
    Развертывание сред Выберите тест .
  4. Нажмите «Создать и развернуть».
    В ответ вы должны увидеть подтверждение того, что ваш новый прокси-сервер API был успешно создан и развернут в «тестовой» среде.
  5. Нажмите «Просмотреть прокси <имя прокси>» в редакторе, чтобы отобразить страницу сведений о прокси-сервере API.

Вызов прокси-сервера hello

Когда вы вызываете прокси-сервер hello , приложение Node.js запускается автоматически и отвечает «Hello, World!». Обратите внимание: если вы не указали иное, приложение Node.js развертывается в среде под названием test . Вот базовый вызов с использованием Curl (замените myorg на название вашей организации). 
$ curl http://myorg-test.apigee.net/nodejs-hello
Hello, World!

Просмотр и редактирование кода Node.js

Давайте посмотрим на код Node.js, который был добавлен в прокси API. Перейдите на страницу сводки прокси-сервера Hello World и нажмите « Разработать» .



Откроется представление «Разработка», включающее редактор кода. Вы можете редактировать код непосредственно там.

Например, измените ответ на Hello, World! на что-то другое, например Hello, Node! , затем нажмите «Сохранить» . Прокси сохраняется и повторно развертывается.

Наконец, повторно вызовите прокси-сервер, чтобы проверить изменение: 

$ curl http://myorg-test.apigee.net/nodejs-hello
Hello, Node!

Подробнее о запуске приложений Node.js в Apigee Edge

Как и все приложения Node.js, приложения Node.js, работающие в Apigee Edge, выполняются в одном потоке управления. Нет необходимости (и фактически нет возможности) запускать другой поток или синхронизировать переменные между потоками. Поскольку Node.js обеспечивает неблокирующее программирование, один сценарий может поддерживать тысячи одновременных запросов, поскольку сценарий отказывается от использования ЦП всякий раз, когда ему приходится чего-то ждать, и он уведомляется позже, когда это происходит.

Чтобы использовать Node.js в Apigee Edge, вам необходимо указать основной файл сценария Node.js. Этот сценарий необходимо настроить для обработки входящих запросов, что обычно делается с помощью модулей http или https , создания клиента и т. д. (Если основной сценарий не настроен таким образом, он просто выполнится и завершит работу после развертывания.) В Apigee Edge каждый сценарий приложения Node.js запускается с самого начала при развертывании прокси-сервера и останавливается при его развертывании. неразвернутый. В промежутках он будет ждать новых запросов и обрабатывать их. Дополнительные сведения см. в разделе «Вызов импортированного файла Node.js» в разделе «Развертывание автономного приложения Node.js» .

Следующие шаги

Вы также можете создавать и развертывать автономные приложения Node.js непосредственно из своей файловой системы. В следующем разделе « Развертывание автономного приложения Node.js» объясняется, как использовать команду apigeetool для развертывания приложения Node.js из командной строки.