Чтобы зарегистрировать организацию, создайте файл конфигурации и передайте его команде setup-org. Каждый из этих шагов описан в следующих разделах.
Информацию о том, как использовать Management API для регистрации организации, можно найти в статье Создание организации, среды и виртуального хоста.
Как создать файл конфигурации для первого знакомства
В этом разделе приведен пример файла конфигурации для подключения организации с помощью setup-org.
Скопируйте приведенный ниже пример и измените его в соответствии с потребностями вашей организации.
# Specify the IP or DNS name of the Management Server. IP1=MANAGEMENT_SERVER_IP_ADDRESS MSIP="$IP1" # Specify the Edge sys admin credentials. ADMIN_EMAIL="admin@email.com" APIGEE_ADMINPW=admin_password # If omitted, you are prompted for it. # Specify organization name. ORG_NAME=myorg # lowercase only, no spaces, underscores, or periods. # Specify the organization administrator user. # Either specify an existing user, or specify the information # necessary to create a new user. # Do not use the sys admin as the organization administrator. # # Create a new user for the organization administrator. NEW_USER="y" # New user information if NEW_USER="y". USER_NAME=new@user.com FIRST_NAME=new LAST_NAME=user # Org admin password must be at least 8 characters long and contain one uppercase # letter, one lowercase letter, and one digit or special character USER_PWD="newUserPword" ORG_ADMIN=new@user.com # # Or, specify an existing user as the organization admin, # omit USER_NAME, FIRST_NAME, LAST_NAME, USER_PWD. # NEW_USER="n" # ORG_ADMIN=existing@user.com # Specify environment name. ENV_NAME=prod # lowercase only # Specify virtual host information. VHOST_PORT=9001 VHOST_NAME=default # If you have a DNS entry for the virtual host. VHOST_ALIAS=myorg-test.apigee.net # If you do not have a DNS entry for the virtual host, # specify the IP and port of each router as a space-separated list: # VHOST_ALIAS="firstRouterIP:9001 secondRouterIP:9001" # Optionally configure TLS/SSL for virtual host. # VHOST_SSL=y # Set to "y" to enable TLS/SSL on the virtual host. # KEYSTORE_JAR= # JAR file containing the cert and private key. # KEYSTORE_NAME= # Name of the keystore. # KEYSTORE_ALIAS= # The key alias. # KEY_PASSWORD= # The key password, if it has one. # Specify the analytics group. # AXGROUP=axgroup-001 # Default name is axgroup-001.
Примечания
- Для
VHOST_ALIAS, если у вас уже есть запись DNS, которую вы будете использовать для доступа к виртуальному хосту, укажите псевдоним хоста и, при необходимости, порт, например "myapi.example.com". Если у вас ещё нет записи DNS, вы можете использовать IP-адрес маршрутизатора.
Подробнее о том, как настроить виртуальный хост…
- Информацию о настройке TLS/SSL, создании JAR-файла и других аспектах конфигурации TLS/SSL можно найти в статьях Хранилища ключей и доверенных сертификатов и Настройка доступа к API по протоколу TLS для частного облака.
- Подробнее о том, как настроить доступ TLS к API для Private Cloud…
- Нельзя создать две организации с одинаковым названием. В этом случае второй запрос на создание не будет выполнен.
Выполнить команду setup-org
После создания файла конфигурации передайте его скрипту setup-org, чтобы выполнить процесс регистрации. Скрипт необходимо запустить на узле Management Server.
При регистрации организации скрипт setup-org выполняет следующие действия:
- Создает новую организацию.
- Создает среду.
- Создает виртуальный хост для среды.
- Назначает указанного пользователя администратором организации. Обратите внимание на следующее:
- Вы можете использовать существующего пользователя или создать нового для администратора организации.
- Администратор организации не должен быть системным администратором.
- Связывает организацию с подом gateway. (Это значение по умолчанию, и его нельзя изменить.)
- Связывает среду со всеми Message Processor.
- Включает аналитику.
Чтобы выполнить setup-org:
- Установите
apigee-provisionна узел сервера управления:/opt/apigee/apigee-service/bin/apigee-service apigee-provision install
- Запустите скрипт
setup-orgна узле Management Server и укажите файл конфигурации, созданный на шаге Создайте файл конфигурации для интеграции:/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
Файл конфигурации должен быть доступен для чтения пользователю apigee.
- Убедитесь, что вы успешно зарегистрировали организацию. Для этого можно войти в новый интерфейс Edge, указав в браузере следующий URL:
http://IP_address:3001
где IP_address – IP-адрес сервера, на котором установлен новый интерфейс Edge.
Дополнительные инструкции по проверке приведены в разделе Как проверить интеграцию.
- Создайте первый прокси
Как проверить регистрацию
После завершения интеграции проверьте статус системы, выполнив следующие команды curl на узле сервера управления:
- Проверьте статус пользователя и организации на сервере управления, выполнив следующие команды:
curl -u adminEmail:admin_passwd http://localhost:8080/v1/users
curl -u adminEmail:admin_passwd http://localhost:8080/v1/organizationscurl -u adminEmail:admin_passwd http://localhost:8080/v1/organizations/org_name/deployments - Проверьте аналитику, выполнив следующую команду:
curl -u adminEmail:admin_password http://localhost:8080/v1/organizations/org_name/environments/env_name/provisioning/axstatus
- Проверьте статус базы данных PostgreSQL, выполнив следующие команды на узле 2 (как показано в топологиях установки):
psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee
В командной строке введите следующую команду, чтобы посмотреть таблицу аналитики для вашей организации:
\d analytics."org_name.env_name.fact"
Чтобы выйти из psql, используйте следующую команду:
\q
- Откройте новый интерфейс Edge в веб-браузере. Напоминаем, что URL консоли управления вы записали в конце установки.
- Запустите браузер и введите URL нового интерфейса Edge. Он выглядит примерно так, как показано ниже. IP-адрес относится к узлу 1 (как показано в топологиях установки) или к любому узлу, на котором вы установили New Edge UI для альтернативных конфигураций.
http://192.168.56.111:3001
3001 – номер порта, используемый по умолчанию в новом интерфейсе Edge.
Если вы запускаете браузер непосредственно на сервере, на котором размещен новый пользовательский интерфейс Edge, вы можете использовать URL-адрес в форме:
http://localhost:3001
- На странице входа в консоль укажите имя пользователя и пароль системного администратора Apigee.
- Запустите браузер и введите URL нового интерфейса Edge. Он выглядит примерно так, как показано ниже. IP-адрес относится к узлу 1 (как показано в топологиях установки) или к любому узлу, на котором вы установили New Edge UI для альтернативных конфигураций.
- Зарегистрируйте новый аккаунт пользователя Apigee и используйте новые учетные данные для входа. На странице входа в консоль нажмите кнопку Sign In (Войти).
Браузер перенаправит вас на страницу
http://192.168.56.111:3001/edgeи откроет панель управления, на которой вы сможете настроить созданную организацию (если вы вошли в систему с учетными данными администратора Apigee).
Как создать первый прокси-сервер
После того, как вы подключили новую организацию и убедились, что процесс подключения прошел успешно, вы можете создать свой первый прокси-сервер. Подробнее о том, как создать первый прокси-сервер API…
Другие полезные ресурсы: