Как развернуть прокси-серверы с помощью командной строки

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

В этой статье рассказывается, как развернуть прокси-сервер с помощью командной строки. Apigee Edge предлагает два варианта развертывания из командной строки. Первый способ – использовать инструмент развертывания Apigee Edge, написанный на языке Python. Другой способ – настроить и запустить сценарий командной строки.

Используйте методы развертывания с помощью командной строки, если вы работаете непосредственно с исходными файлами прокси на своем компьютере. Причин, по которым вы можете работать в офлайн-режиме, много. Вы можете использовать любимый XML-редактор или разрабатывать правила, требующие кодирования на Java, и работать в основном в IDE. Описанные в этом разделе методы позволяют загружать и развертывать исходные файлы в выбранной среде API Services.

Если вы в основном работаете с интерфейсом управления, ознакомьтесь с разделом Развертывание прокси-серверов в интерфейсе.

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

Запуск инструмента развертывания Apigee Edge Python

Инструмент развертывания Python Apigee Edge работает с API управления Edge, чтобы импортировать и развертывать прокси API. Инструмент доступен в составе дистрибутива API Platform Samples на GitHub. Подробнее об использовании примеров прокси API…

Используйте инструмент Apigee Edge Python, чтобы импортировать (загрузить) и развернуть API за один простой процесс.

Инструмент развертывания необходимо запустить из базового каталога в дистрибутиве образцов API Platform, где базовый каталог является родительским каталогом для каталогов setup и tools.

В следующей команде замените название прокси-сервера, имя пользователя и пароль Edge, организацию и среду Edge, а также путь к каталогу, содержащему каталог apiproxy" прокси-сервера API:

python tools/deploy.py -n proxyname -u name:passW -o org -e env -d proxypath -p /

Пример:

python tools/deploy.py -n weatherapi -u me@myCo.com:foo -o myCo -e test -d weatherapi -p /

Эта команда архивирует файлы, отправляет их в организацию в Apigee Edge и развертывает в указанной среде.

Инструмент развертывания автоматически обнаруживает текущую версию прокси API, отменяет ее развертывание и развертывает следующую версию прокси API.

Если все пройдет успешно, вы увидите сообщение в следующем формате:

Writing ./<proxybasedir>/apiproxy/weatherapi.xml to apiproxy/weatherapi.xml
Writing ./<proxybasedir>/apiproxy/proxies/default.xml to apiproxy/proxies/default.xml
Writing ./<proxybasedir>/apiproxy/targets/default.xml to apiproxy/targets/default.xml
Imported new proxy version 1
Environment: test
  Revision: 1 BasePath = /
  State: deployed

По умолчанию инструмент загружает прокси-сервер API в https://api.enterprise.apigee.com, соответствующий Edge в облаке. Вы также можете использовать этот инструмент, чтобы загрузить прокси-сервер API в локальную версию Edge, указав флаг -h:

python tools/deploy.py -n weatherapi -u me@myCo.com:foo -o myCo -e test -d weatherapi -p / -h https://192.168.11.111:8080

В этом примере вы указываете IP-адрес сервера управления Edge. Если вы создали запись DNS для сервера управления, вы можете указать URL в следующем формате:

https://ms_URL:8080

Полный список флагов для команды:

  • -n – название прокси-сервера API.
  • -u – имя пользователя и пароль для вашего аккаунта в организации в Apigee Edge.
  • -o – название организации, в которой у вас есть аккаунт.
  • -e – среда, в которой должен быть развернут прокси-сервер API (test или prod).
  • -d – путь к каталогу, в котором хранятся файлы прокси-сервера API. Файлы прокси-сервера API должны храниться в каталоге apiproxy. Это путь к каталогу, содержащему каталог apiproxy, а не к самому каталогу apiproxy.
  • -p – путь URI, используемый в качестве шаблона для маршрутизации входящих сообщений в это развертывание прокси API. В большинстве случаев можно указать значение "/", если у вас нет особых требований к развертыванию и маршрутизации. Основной путь, используемый для маршрутизации прокси-сервера API, определяется в файле конфигурации ProxyEndpoint прокси-сервера API.
  • -hURL Edge. По умолчанию URL – https://api.enterprise.apigee.com, соответствующий Edge в облаке. При локальном развертывании используйте URL сервера управления Edge и порт 8080, как показано ниже: 
    https://ms_URL:8080

    Или используйте IP-адрес управляющего сервера, как в примере https://192.168.11.111:8080.

Настройка и запуск скрипта оболочки для развертывания

Проще всего запустить скрипт развертывания, который предоставляется вместе с примером прокси-сервера API. Скрипты оболочки используют инструмент развертывания Apigee Edge Python.

В каталоге /simplyProxy выполните следующую команду:

$ sh deploy.sh

Вы увидите:

Enter your password for user {myname} in the Apigee Enterprise organization {org_name}, followed by [ENTER]:

Введите пароль и нажмите Ввод.

Вы увидите следующее:

Deploying to test on https://api.enterprise.apigee.com using {myname} on enterprise.apigee.com and {org_name} on enterprise.apigee.com

Если вы видите следующее:

Enter your password for user Your USERNAME on enterprise.apigee.com in the Apigee Enterprise organization Your ORG on enterprise.apigee.com, followed by [ENTER]:

Это означает, что вам нужно изменить файл /setup/setenv.sh в дистрибутиве примеров платформы. Инструкции можно найти в файле README или в документации по API Apigee Edge.

После успешного выполнения команды инструмент развертывания архивирует файлы в папке /apiproxy,, импортирует пакет в организацию в Apigee Edge, а затем развертывает прокси-сервер API в тестовой среде.

Прокси-сервер API готов к вызову.