Edge for Private Cloud версии 4.17.01
Чтобы выполнить процесс регистрации, используйте команду setup-org. Команду необходимо выполнить на узле сервера управления.
В процессе настройки скрипт:
- Создает организацию.
- Назначает указанного пользователя администратором организации.
- Этот пользователь не должен быть системным администратором. То есть не используйте системного администратора в качестве администратора организации.
- Вы можете указать существующего пользователя в качестве администратора организации или настроить скрипт для создания нового пользователя.
- Связывает организацию с подом. По умолчанию это под gateway.
- Создайте среду.
- Создайте виртуальный хост для среды.
- Свяжите среду со всеми Message Processor.
- Включает аналитику.
Файл конфигурации для регистрации
Передайте файл конфигурации команде setup-org. Вызовите команду setup-org и укажите параметр -f, включая путь к файлу конфигурации для автоматической установки:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
Единственное требование к автоматической установке – файл конфигурации должен быть доступен или доступен для чтения пользователю apigee.
Ниже приведен пример файла конфигурации для автоматической установки. Измените его в соответствии со своими требованиями:
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=adminPassword # 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 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 # 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-адрес маршрутизатора.
Подробнее о том, как настроить виртуальный хост, рассказывается в статье Требования к установке демоверсии Edge. - Информацию о настройке TLS/SSL, в том числе о создании JAR-файла, можно найти в статьях Keystores and Truststores (Хранилища ключей и доверенных сертификатов) и Configuring TLS access to an API for the Private Cloud (Настройка доступа к API по протоколу TLS для Private Cloud).
Процедура регистрации
- Установите apigee-provision на узле сервера управления:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision install - Выполните команду на узле Management Server:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
Файл конфигурации должен быть доступен или доступен для чтения пользователю apigee.
Проверка при регистрации
После завершения регистрации проверьте статус системы, выполнив следующие команды CURL на узле сервера управления.
- Проверьте статус пользователя и организации на сервере управления, выполнив следующие команды 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 - Если вы включили аналитику, используйте следующую команду:
> curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations/<orgname>/environments/<envname>/provisioning/axstatus - Вы также можете проверить статус базы данных PostgreSQL, запустив psql на компьютере 2 с помощью следующей команды:
> psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee
В командной строке введите следующую команду, чтобы посмотреть таблицу аналитики для вашей организации:
apigee=# : \d analytics."<orgname>.prod.fact"
Чтобы выйти из psql, используйте следующую команду:
apigee=# \q - Откройте пользовательский интерфейс Apigee Edge в браузере. Напомним, что вы уже записали URL консоли управления в конце установки.
- Запустите браузер и введите URL пользовательского интерфейса Edge. Он выглядит примерно так, как показано ниже. IP-адрес относится к компьютеру 1 или к любому другому компьютеру, на котором вы установили пользовательский интерфейс для альтернативных конфигураций:
http://192.168.56.111:9000/login
9000 – это номер порта, используемый пользовательским интерфейсом. Если вы запускаете браузер непосредственно на сервере, на котором размещен пользовательский интерфейс Edge, вы можете использовать URL в следующем формате:
http://localhost:9000/login
Примечание. Убедитесь, что порт 9000 открыт. - На странице входа в консоль укажите имя пользователя и пароль системного администратора Apigee.
Примечание. Это глобальный пароль системного администратора, который вы задали во время установки. Вы также можете:
- Запустите браузер и введите URL пользовательского интерфейса Edge. Он выглядит примерно так, как показано ниже. IP-адрес относится к компьютеру 1 или к любому другому компьютеру, на котором вы установили пользовательский интерфейс для альтернативных конфигураций:
- Зарегистрируйте новый аккаунт пользователя Apigee и используйте новые учетные данные для входа.
- Нажмите "Войти". Браузер перенаправит вас на страницу
http://192.168.56.111:9000/platform/#/<orgname>/
и откроет панель управления, на которой можно настроить созданную ранее организацию (если вы вошли с учетными данными администратора Apigee). - Если вы только начинаете работать с Edge, вы можете создать свой первый прокси-сервер API. Подробнее о том, как создать первый прокси-сервер API…
Также ознакомьтесь с разделами о примерах, включая список примеров, и с имитацией целевых RESTful API, которые можно использовать в собственных экспериментах по созданию API, в разделе Mock Target API.
- Нажмите "Войти". Браузер перенаправит вас на страницу