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

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

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

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

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

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

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

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

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

Инструмент развертывания необходимо запускать из базового каталога дистрибутива API Platform Samples, где базовый каталог является родительским каталогом для каталогов 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 /

Эта команда архивирует ваши файлы в формате ZIP, отправляет их в вашу организацию через 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-прокси.
  • -h : URL-адрес 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]:

Введите свой пароль и нажмите 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 или в документации Apigee Edge APIs .

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

Ваш API-прокси готов к вызову.