Edge для частного облака версии 4.17.09
В этом разделе описаны различные административные операции, например создание, управление и удаление организаций, сред и виртуальных хостов 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 для всех вызовов. Если это не поможет, выполните следующие действия:
- Проверьте журналы сервера управления в каталоге /opt/apigee/var/log/apigee/management-server на наличие ошибок.
- Позвоните на сервер управления, чтобы проверить, правильно ли он работает.
- Удалите сервер из ELB, а затем перезапустите сервер управления:
/opt/apigee/bin/apigee-service management-server restart
Об использовании файлов конфигурации
Команды, приведенные ниже, принимают в качестве входных данных файл конфигурации. Например, вы передаете файл конфигурации команде setup-org, чтобы определить все свойства организации, включая среду и виртуальный хост.
Полный файл конфигурации и информацию о свойствах, которые можно задать в файле конфигурации, можно найти в статье Как зарегистрировать организацию.
Как настроить виртуальный хост
Виртуальный хост в Edge определяет домены и порты маршрутизатора Edge, на которых представлен прокси-сервер API, а также URL, которые приложения используют для доступа к прокси-серверу API. Виртуальный хост также определяет, будет ли доступ к прокси-серверу API осуществляться с помощью протокола HTTP или зашифрованного протокола HTTPS.
Чтобы создать виртуальный хост, используйте скрипты и вызовы API, приведенные ниже. При создании виртуального хоста необходимо указать следующую информацию:
- Название виртуального хоста, которое используется для ссылки на него в прокси API.
- Порт на маршрутизаторе для виртуального хоста. Обычно эти порты начинаются с 9001 и увеличиваются на единицу для каждого нового виртуального хоста.
- Псевдоним хоста виртуального хоста. Обычно это имя DNS виртуального хоста.
Пограничный маршрутизатор сравнивает заголовок 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.
Примечание. Команда curl, большинство браузеров и многие другие утилиты автоматически добавляют заголовок Host с доменом как часть запроса, поэтому вы можете использовать команду curl в следующем формате:
curl http://<routerIP>: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}