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

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

Edge Microgateway v. 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, см. раздел Обновление Edge Microgateway при наличии подключения к Интернету .

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

Operation 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] можно настроить. См. папки npm для получения дополнительной информации о том, куда по умолчанию устанавливаются модули Node.js, и о том, как настроить место установки.

Удаление 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