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

В этом разделе рассматриваются различные административные операции, например создание, управление и удаление организаций, сред и виртуальных хостов 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, на которых размещен прокси-сервер API, и, соответственно, URL, который приложения используют для доступа к прокси-серверу API. Виртуальный хост также определяет, как осуществляется доступ к прокси-серверу API: по протоколу HTTP или по зашифрованному протоколу HTTPS.

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

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

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

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

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

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

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

Если у вас нет записи DNS, вы можете задать псевдоним хоста, указав IP-адрес маршрутизатора и порт виртуального хоста, например routerIP:port. Пример:

192.168.1.31:9001

Затем вы создаете команду curl в форме ниже:

curl http://routerIP:9001/proxy-base-path/resource-path

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

Если у вас несколько маршрутизаторов, добавьте псевдоним хоста для каждого из них, указав 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