Организация и поддержание среды

В этом разделе рассматриваются различные административные операции, например, создание, управление и удаление организаций 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 management-server restart

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

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

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

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

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

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

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

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

Если у вас есть DNS-запись для виртуального хоста

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

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

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

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