На борту организации

Для адаптации организации необходимо создать файл конфигурации адаптации, а затем передать его команде 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 :

1. Установите apigee-provision на узле Management Server:

   /opt/apigee/apigee-service/bin/apigee-service apigee-provision install

2. Запустите сценарий setup-org на узле Management Server и укажите в нем файл конфигурации, который вы создали в разделе Создание файла конфигурации подключения :

   /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

   Файл конфигурации должен быть доступен для чтения пользователю «apigee».

3. Убедитесь, что вы успешно зарегистрировали организацию. Один из способов сделать это — войти в пользовательский интерфейс, запросив в браузере следующий URL-адрес:

   http://IP_address:9000/login

   Где IP_address — это IP-адрес сервера, на котором вы установили пользовательский интерфейс Edge.

   Дополнительные шаги проверки см. в разделе Проверка регистрации .

4. Создайте свой первый прокси!

Подтвердите регистрацию

По завершении подключения проверьте состояние системы, введя следующие команды curl на узле Management Server:

1. Проверьте статус пользователя и организации на сервере управления, выполнив следующие команды:

   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

2. Проверьте аналитику, выполнив следующую команду:

   curl -u adminEmail:admin_password http://localhost:8080/v1/organizations/org_name/environments/env_name/provisioning/axstatus

3. Проверьте состояние базы данных PostgreSQL, выполнив на узле 2 следующие команды (как показано в топологиях установки ):

   psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee

   В командной строке введите следующую команду, чтобы просмотреть таблицу аналитики для вашей организации:

   \d analytics."org_name.env_name.fact"

   Используйте следующую команду для выхода из psql:

   \q

4. Получите доступ к пользовательскому интерфейсу Apigee Edge с помощью веб-браузера. Помните, что вы уже записали URL-адрес консоли управления в конце установки.
   1. Запустите предпочитаемый вами браузер и введите URL-адрес пользовательского интерфейса Edge. Он выглядит примерно так, как показано ниже, где IP-адрес предназначен для узла 1 (как показано в топологиях установки ) или любого узла, на котором вы установили пользовательский интерфейс для альтернативных конфигураций:

      http://192.168.56.111:9000/login

      9000 — это номер порта, используемый пользовательским интерфейсом.

      Если вы запускаете браузер непосредственно на сервере, на котором размещен пользовательский интерфейс Edge, вы можете использовать URL-адрес в форме:

      http://localhost:9000/login

   2. На странице входа в консоль укажите имя пользователя и пароль системного администратора Apigee.
5. Зарегистрируйте новую учетную запись пользователя Apigee и используйте новые учетные данные пользователя для входа. На странице входа в консоль нажмите кнопку «Войти» .

   Браузер перенаправляется на http://192.168.56.111:9000/platform/#/ org_name / и открывает панель мониторинга, которая позволяет вам настроить созданную вами организацию (если вы вошли в систему, используя учетные данные администратора Apigee).

Создайте свой первый прокси

После того как вы подключили новую организацию и убедились, что процесс регистрации прошел успешно, вы можете создать свой первый прокси. Дополнительные сведения см. в разделе Создание первого прокси-сервера API .

Другие ресурсы, которые могут оказаться вам полезными, включают:

• Список образцов
• Имитируйте целевые API-интерфейсы RESTful, которые вы можете использовать в своих собственных экспериментах по созданию API.