Развертывание прокси из командной строки

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

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

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

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

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

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

Инструмент развертывания Apigee Edge Python работает с API управления Edge для импорта и развертывания прокси-серверов API. Инструмент доступен как часть дистрибутива примеров платформы API на GitHub. См. Использование примеров прокси-серверов API .

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

Инструмент развертывания необходимо запускать из базового каталога дистрибутива образцов платформы API, где базовый каталог является родительским каталогом каталога 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-адрес пограничного сервера управления. Если вы создали запись 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.
  • -h : URL-адрес Edge. По умолчанию URL-адрес — https://api.enterprise.apigee.com , что соответствует Edge в облаке. Для локального развертывания используйте URL-адрес пограничного сервера управления и порт 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]:

Введите пароль, нажмите 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 готов к вызову.