Организация и обслуживание среды

Edge для частного облака v4.18.01

В этом разделе рассматриваются различные административные операции, например создание, управление и удаление организаций, сред и виртуальных хостов Apigee в установке Apigee Edge для частного облака.

Общие сведения об организациях, средах и виртуальных хостах см. в разделе «О планетах, регионах, модулях, организациях, средах и виртуальных хостах» .

Проверка статуса пользователей, организации и среды

Сервер управления играет жизненно важную роль в объединении всех остальных компонентов в локальной установке Edge Private Cloud. Вы можете проверить статус пользователя, организации и развертывания на сервере управления, введя следующие команды CURL:

curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/users
curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations
curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations/<orgname>/deployments

Система должна отображать статус HTTP 200 для всех вызовов. Если это не помогло, сделайте следующее:

  1. Проверьте журналы сервера управления по адресу /opt/apigee/var/log/apigee/management-server на наличие ошибок.
  2. Вызовите сервер управления, чтобы проверить, правильно ли он работает.
  3. Удалите сервер из ELB, а затем перезапустите сервер управления:
    /opt/apigee/bin/apigee-service перезапуск сервера управления

Об использовании файлов конфигурации

Команды, показанные ниже, принимают на вход файл конфигурации. Например, вы передаете файл конфигурации команде setup-org, чтобы определить все свойства организации, включая среду и виртуальный хост.

Полный файл конфигурации и информацию о свойствах, которые можно установить в файле конфигурации, см. в разделе «Введение в организацию» .

О настройке виртуального хоста

Виртуальный хост в Edge определяет домены и порты Edge Router, на которых доступен прокси-сервер API, и, как следствие, URL-адрес, который приложения используют для доступа к прокси-серверу API. Виртуальный хост также определяет, осуществляется ли доступ к прокси-серверу API по протоколу HTTP или по зашифрованному протоколу HTTPS.

Используйте сценарии и вызовы API, показанные ниже, для создания виртуального хоста. При создании виртуального хоста необходимо указать следующую информацию:

  • Имя виртуального хоста, которое вы используете для ссылки на него в своих прокси-серверах API.
  • Порт на маршрутизаторе для виртуального хоста. Обычно эти порты начинаются с 9001 и увеличиваются на единицу для каждого нового виртуального хоста.
  • Псевдоним виртуального хоста. Обычно DNS-имя виртуального хоста.

    Edge Router сравнивает заголовок Host входящего запроса со списком псевдонимов хоста в рамках определения прокси-сервера API, который обрабатывает запрос. При выполнении запроса через виртуальный хост либо укажите доменное имя, соответствующее псевдониму виртуального хоста, либо укажите IP-адрес Маршрутизатора и заголовок Host, содержащий псевдоним хоста.

Например, если вы создали виртуальный хост с псевдонимом myapis.apigee.net на порту 9001 , то запрос cURL к API через этот виртуальный хост может использовать одну из следующих форм:

  • Если у вас есть запись DNS для myapis.apigee.net :
    завиток http://myapis.apigee.net:9001 /{proxy-base-path}/{resource-path}
  • Если у вас нет записи DNS для myapis.apigee.net :
    curl http:// <routerIP>:9001 /{proxy-base-path}/{resource-path} -H 'Хост: myapis.apigee.net'

    Во второй форме вы указываете IP-адрес маршрутизатора и передаете псевдоним хоста в заголовке Host.

    Примечание . Команда Curl, большинство браузеров и многие другие утилиты автоматически добавляют заголовок Host с доменом как часть запроса, поэтому вы можете использовать команду Curl в форме:
    завиток http://<routerIP>:9001/{прокси-базовый-путь}/{ресурсный-путь}

Варианты, когда у вас нет записи DNS для виртуального хоста

Один из вариантов, когда у вас нет записи DNS, — установить псевдоним хоста для IP-адреса маршрутизатора и порта виртуального хоста, например <routerIP>:port . Например:

192.168.1.31:9001

Когда вы вводите команду Curl в форме ниже:

curl http://<routerIP>:9001/{proxy-base-path}/{resource-path} 

Этот вариант предпочтителен, поскольку он хорошо работает с пользовательским интерфейсом Edge.

Если у вас несколько маршрутизаторов, добавьте псевдоним хоста для каждого маршрутизатора, указав IP-адрес каждого маршрутизатора и порт виртуального хоста.

Альтернативно вы можете установить псевдоним хоста в значение, например temp.hostalias.com . Затем вам нужно передавать заголовок хоста при каждом запросе:

curl -v http://<routerIP>:9001/{proxy-base-path}/{resource-path} -H 'Host: temp.hostalias.com'

Или добавьте псевдоним хоста в файл /etc/hosts . Например, добавьте эту строку в /etc/hosts :

192.168.1.31   temp.hostalias.com

Затем вы можете сделать запрос, как если бы у вас была запись DNS:

curl -v http://myapis.apigee.net:9001/{proxy-base-path}/{resource-path}