Edge для частного облака v4.19.01
Чтобы зарегистрировать организацию, необходимо создать файл конфигурации адаптации, а затем передать его команде setup-org
. Каждый из этих шагов описан в следующих разделах.
Информацию об использовании API управления для адаптации организации см. в разделе Создание организации, среды и виртуального хоста .
Создайте файл конфигурации подключения
В этом разделе приведен пример файла конфигурации для регистрации организации с помощью setup-org
.
Скопируйте следующий пример и отредактируйте его по мере необходимости для вашей организации:
IP1=192.168.1.1 # Specify the IP or DNS name of the Management Server. 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 см. разделы «Хранилища ключей и доверенных сертификатов» и «Настройка доступа TLS к API для частного облака» для получения дополнительной информации о создании файла JAR и других аспектах настройки TLS/SSL.
- Дополнительные сведения о настройке виртуальных хостов см. в разделе Настройка доступа TLS к API для частного облака .
- Вы не можете создать две организации с одинаковым названием. В этом случае второе создание завершится неудачно.
Выполнить setup-org
После создания файла конфигурации подключения вы передаете его сценарию setup-org
для выполнения процесса подключения. Вы должны запустить сценарий на узле Сервера управления.
При регистрации организации сценарий setup-org
выполняет следующие действия:
- Создает новую организацию.
- Создает среду.
- Создает виртуальный хост для среды.
- Устанавливает указанного пользователя в качестве администратора организации. Обратите внимание, что:
- Вы можете использовать существующего пользователя или создать нового для администратора организации.
- Администратор организации не должен совпадать с системным администратором.
- Связывает организацию с модулем «шлюз». (Это значение по умолчанию, которое нельзя изменить.)
- Связывает среду со всеми процессорами сообщений.
- Включает аналитику.
Чтобы выполнить setup-org
:
- Установите
apigee-provision
на узле Management Server:/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».
- Убедитесь, что вы успешно зарегистрировали организацию. Один из способов сделать это — войти в пользовательский интерфейс, запросив в браузере следующий URL-адрес:
http://IP_address:9000/login
Где IP_address — это IP-адрес сервера, на котором вы установили пользовательский интерфейс Edge.
Дополнительные шаги проверки см. в разделе Проверка регистрации .
- Создайте свой первый прокси!
Подтвердите регистрацию
По завершении подключения проверьте состояние системы, введя следующие команды curl
на узле Management Server:
- Проверьте статус пользователя и организации на сервере управления, выполнив следующие команды:
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/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
- Получите доступ к пользовательскому интерфейсу Apigee Edge с помощью веб-браузера. Помните, что вы уже записали URL-адрес консоли управления в конце установки.
- Запустите предпочитаемый вами браузер и введите URL-адрес пользовательского интерфейса Edge. Он выглядит примерно так, как показано ниже, где IP-адрес предназначен для узла 1 (как показано в топологиях установки ) или любого узла, на котором вы установили пользовательский интерфейс для альтернативных конфигураций:
http://192.168.56.111:9000/login
9000 — это номер порта, используемый пользовательским интерфейсом.
Если вы запускаете браузер непосредственно на сервере, на котором размещен пользовательский интерфейс Edge, вы можете использовать URL-адрес в форме:
http://localhost:9000/login
- На странице входа в консоль укажите имя пользователя и пароль системного администратора Apigee.
- Запустите предпочитаемый вами браузер и введите URL-адрес пользовательского интерфейса Edge. Он выглядит примерно так, как показано ниже, где IP-адрес предназначен для узла 1 (как показано в топологиях установки ) или любого узла, на котором вы установили пользовательский интерфейс для альтернативных конфигураций:
- Зарегистрируйте новую учетную запись пользователя Apigee и используйте новые учетные данные пользователя для входа в систему. На странице входа в консоль нажмите кнопку «Войти» .
Браузер перенаправляется на
http://192.168.56.111:9000/platform/#/ org_name /
и открывает панель мониторинга, позволяющую настроить созданную вами организацию (если вы вошли в систему, используя учетные данные администратора Apigee).
Создайте свой первый прокси
После того как вы подключили новую организацию и убедились, что процесс регистрации прошел успешно, вы можете создать свой первый прокси. Дополнительные сведения см. в разделе Создание первого прокси-сервера API .
Другие ресурсы, которые могут оказаться вам полезными, включают: