Установка пограничного микрошлюза

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

Пограничный микрошлюз версии 3.0.x

В этом разделе объясняется, как установить или удалить Edge Microgateway.

Минимальные аппаратные требования

Для Edge Microgateway требуется следующая минимальная аппаратная конфигурация:

  • На виртуальной машине (ВМ) для Edge Microgateway требуется не менее 1 ядра и не менее 256 МБ ОЗУ. Сам процесс Edge Microgateway занимает менее 128 МБ ОЗУ.
  • В контейнере Microgateway можно использовать с размером образа менее 100 МБ.

Предпосылки

  • В вашей системе должен быть установлен Node.js версии 8.x LTS или 12.x. Вы можете проверить версию, выполнив следующую команду:
    node -v
    v12.5.0
    
  • Windows требует, чтобы OpenSSL был установлен и добавлен в PATH .
  • Если вы используете частное облако Apigee Edge для настройки Edge Microgateway, вы должны использовать версию частного облака 4.18.01 или более позднюю.

Установка Edge Microgateway, если у вас есть подключение к Интернету

В этом разделе объясняется, как установить Edge Microgateway и инициализировать конфигурацию по умолчанию. Если вы работаете без подключения к Интернету, см. раздел Могу ли я установить Edge Microgateway без подключения к Интернету? .

  1. Установите последнюю версию Edge Microgateway с помощью npm следующим образом. Эта команда устанавливает программное обеспечение и помещает исполняемый файл edgemicro в путь .
    npm install edgemicro -g
    

    Чтобы установить определенную версию Edge Microgateway, вам необходимо указать номер версии в команде установки. Если вы не укажете номер версии, будет установлена ​​последняя версия. Например, чтобы установить версию 2.5.7, используйте следующую команду.

    npm install edgemicro@3.0.2 -g
    
  2. Проверьте номер версии. Например, если вы установили версию 3.0.2:
    edgemicro --version
    current nodejs version is v12.5.0
    current edgemicro version is 3.0.2
    
  3. Следуйте инструкциям по настройке и настройке в разделе Настройка и настройка Edge Microgateway .

Обновление пограничного микрошлюза

Чтобы обновить ранее установленную версию Edge Microgateway, см. Обновление Edge Microgateway, если у вас есть подключение к Интернету .

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

Эксплуатация Edge Microgateway в Windows как услуга

Вы можете использовать Edge Microgateway в Windows как службу. Дополнительные сведения см. в разделе «Рекомендации по оперативному управлению Microgateway (edgemicro) в Windows» в сообществе Apigee.

Могу ли я установить Edge Microgateway без подключения к Интернету?

На сайтах, у которых нет готового доступа в Интернет, администратор может установить и поддерживать частный реестр npm в вашей внутренней сети. Инструкции по настройке частного реестра npm выходят за рамки этого руководства; однако вы можете искать и находить полезные инструкции. Установив частный реестр npm , вы можете следовать приведенным выше инструкциям по установке или обновлению.

Начиная

Если вы новичок в Edge Microgateway, установка и настройка Edge Microgateway — лучшее место для начала после завершения установки. Руководство по установке и настройке охватывает все шаги, необходимые для установки, настройки, запуска и использования экземпляра Edge Microgateway.

Где установлен Edge Microgateway?

Когда вы используете npm с глобальной опцией ( npm install -g edgemicro ), программное обеспечение устанавливается в [prefix]/lib/node_modules/edgemicro . Вы можете найти значение [prefix] с помощью этой команды:

npm config get prefix

Конфигурация префикса по умолчанию соответствует месту, где установлен узел. В большинстве систем это /usr/local . В Windows это %AppData%\npm . Значение [prefix] настраивается. Дополнительные сведения о том, где модули Node.js устанавливаются по умолчанию, и о том, как настроить место установки , см. в разделе npm-folders .

Удаление Edge Microgateway

Если вам нужно удалить Edge Microgateway:

  1. Удалите или заархивируйте каталог установки [prefix]/lib/node_modules/edgemicro , где [prefix] — это префикс npm, как описано в разделе Где установлен Edge Microgateway ?
  2. Удалите или заархивируйте файлы журналов . По умолчанию файлы edgemicro-*.log находятся в /var/tmp/ , но это расположение можно настроить. Проверьте файл конфигурации Edge Microgateway, если сомневаетесь.
  3. Удалите или заархивируйте файлы конфигурации среды выполнения и кэширования:
    ~/.edgemicro/*.yaml
    

Поддержка Кубернетес

Вы можете использовать Edge Microgateway, чтобы обеспечить управление API Apigee для служб, работающих в кластере Kubernetes . См. Обзор интеграции Edge Microgateway с Kubernetes .

Поддержка докера

Теперь вы можете скачать последнюю версию Edge Microgateway в виде образа Docker :

docker pull gcr.io/apigee-microgateway/edgemicro:latest