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

Edge для частного облака v. 4.16.05

Используйте команду setup-org для выполнения процесса регистрации. Вы должны запустить команду на узле Сервера управления.

В рамках процесса адаптации сценарий:

При необходимости создается новый пользователь, который будет выполнять функции администратора организации.

  • Создает организацию.
  • Добавляет указанного пользователя в качестве администратора организации. Пользователь должен уже существовать; в противном случае скрипт выдает ошибку.
  • Связывает организацию с модулем. По умолчанию она связывается с модулем «шлюз».
  • Создайте среду.
  • Создайте виртуальный хост для среды.
  • Свяжите среду со всеми процессорами сообщений.
  • Включает аналитику.

Тихий файл конфигурации для регистрации

Передайте файл конфигурации команде setup-org. Вызовите команду setup-org и укажите опцию -f, включая путь к файлу автоматической конфигурации:

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

Единственное требование к автоматической установке — файл конфигурации должен быть доступен или доступен для чтения пользователю «apigee». Например, поместите файл в каталог /tmp на узле.

Ниже показан пример файла автоматической конфигурации. Отредактируйте его по мере необходимости в соответствии с вашими требованиями:

IP1=192.168.1.1

# Specify the IP or DNS name of the Management Server.
MSIP="$IP1"

# Specify the Edge admin credentials.
ADMIN_EMAIL="admin@email.com"
APIGEE_ADMINPW=adminPassword     # If omitted, you are prompted for it.

# Specify organization name and administrator.
ORG_NAME=myorg  # lowercase only, no spaces, underscores, or periods.

#
# Set the organization administrator.
# Do not use sys admin as 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

# 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, дополнительную информацию см. в разделе Настройка виртуального хоста.
  • Для настройки TLS/SSL см. разделы Хранилища ключей и доверенных сертификатов и Настройка TLS/SSL для Edge On Premises для получения дополнительной информации о создании файла JAR и других аспектах настройки TLS/SSL.

Регистрация

  1. Установите apigee-provision на узле Management Server:
    > /opt/apigee/apigee-service/bin/apigee-service установка apigee-provision
  2. Запустите команду на узле Management Server:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

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

Проверка при входе

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

  1. Проверьте статус пользователя и организации на сервере управления, введя следующие команды CURL:
    > curl -u <adminEmail>:<пароль администратора> http://localhost:8080/v1/users
    > curl -u <adminEmail>:<пароль администратора> http://localhost:8080/v1/organizations
    > curl -u <adminEmail>:<пароль администратора> http://localhost:8080/v1/organizations/<имя организации>/deployments
  2. Если вы включили аналитику, то используйте эту команду:
    > curl -u <adminEmail>:<пароль администратора> http://localhost:8080/v1/organizations/<имя организации>/environments/<имя среды>/provisioning/axstatus
  3. Вы также можете проверить состояние базы данных PostgreSQL, выполнив на компьютере 2 следующую команду для запуска psql:
    > psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee

    В командной строке введите следующую команду, чтобы просмотреть таблицу аналитики для вашей организации:
    apigee=# : \d Analytics."<имя организации>.prod.fact"

    Используйте следующую команду для выхода из psql:
    апигей=# \q
  4. Получите доступ к пользовательскому интерфейсу Apigee Edge с помощью веб-браузера. Помните, что вы уже записали URL-адрес консоли управления в конце установки.
    1. Запустите предпочитаемый вами браузер и введите URL-адрес пользовательского интерфейса Edge. Он выглядит примерно так, как показано ниже, где IP-адрес соответствует компьютеру 1 или компьютеру, на котором вы установили пользовательский интерфейс для альтернативных конфигураций:
      http://192.168.56.111:9000/логин

      9000 — это номер порта, используемый пользовательским интерфейсом. Если вы запускаете браузер непосредственно на сервере, на котором размещен пользовательский интерфейс Edge, вы можете использовать URL-адрес в форме:
      http://localhost:9000/логин

      Примечание . Убедитесь, что порт 9000 открыт.
    2. На странице входа в консоль укажите имя пользователя и пароль системного администратора Apigee.
      Примечание . Это глобальный пароль системного администратора, который вы установили во время установки. Альтернативно вы можете:
  5. Зарегистрируйте новую учетную запись пользователя Apigee и используйте новые учетные данные пользователя для входа.
    1. Нажмите «Войти», браузер перенаправит на:
      http://192.168.56.111:9000/platform/#/<имя организации>/

      и открывает панель мониторинга, которая позволяет вам настроить созданную ранее организацию (если вы вошли в систему с использованием учетных данных администратора Apigee).
    2. Если вы новичок в Edge, теперь вы можете создать свой первый прокси-сервер API. Дополнительные сведения см. в разделе Создание первого прокси-сервера API .
,

Edge для частного облака v. 4.16.05

Используйте команду setup-org для выполнения процесса регистрации. Вы должны запустить команду на узле Сервера управления.

В рамках процесса адаптации сценарий:

При необходимости создается новый пользователь, который будет выполнять функции администратора организации.

  • Создает организацию.
  • Добавляет указанного пользователя в качестве администратора организации. Пользователь должен уже существовать; в противном случае скрипт выдает ошибку.
  • Связывает организацию с модулем. По умолчанию она связывается с модулем «шлюз».
  • Создайте среду.
  • Создайте виртуальный хост для среды.
  • Свяжите среду со всеми процессорами сообщений.
  • Включает аналитику.

Тихий файл конфигурации для регистрации

Передайте файл конфигурации команде setup-org. Вызовите команду setup-org и укажите опцию -f, включая путь к файлу автоматической конфигурации:

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

Единственное требование к автоматической установке — файл конфигурации должен быть доступен или доступен для чтения пользователю «apigee». Например, поместите файл в каталог /tmp на узле.

Ниже показан пример файла автоматической конфигурации. Отредактируйте его по мере необходимости в соответствии с вашими требованиями:

IP1=192.168.1.1

# Specify the IP or DNS name of the Management Server.
MSIP="$IP1"

# Specify the Edge admin credentials.
ADMIN_EMAIL="admin@email.com"
APIGEE_ADMINPW=adminPassword     # If omitted, you are prompted for it.

# Specify organization name and administrator.
ORG_NAME=myorg  # lowercase only, no spaces, underscores, or periods.

#
# Set the organization administrator.
# Do not use sys admin as 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

# 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, дополнительную информацию см. в разделе Настройка виртуального хоста.
  • Для настройки TLS/SSL см. разделы Хранилища ключей и доверенных сертификатов и Настройка TLS/SSL для Edge On Premises для получения дополнительной информации о создании файла JAR и других аспектах настройки TLS/SSL.

Регистрация

  1. Установите apigee-provision на узле Management Server:
    > /opt/apigee/apigee-service/bin/apigee-service установка apigee-provision
  2. Запустите команду на узле Management Server:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

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

Проверка при входе

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

  1. Проверьте статус пользователя и организации на сервере управления, введя следующие команды CURL:
    > curl -u <adminEmail>:<пароль администратора> http://localhost:8080/v1/users
    > curl -u <adminEmail>:<пароль администратора> http://localhost:8080/v1/organizations
    > curl -u <adminEmail>:<пароль администратора> http://localhost:8080/v1/organizations/<имя организации>/deployments
  2. Если вы включили аналитику, то используйте эту команду:
    > curl -u <adminEmail>:<пароль администратора> http://localhost:8080/v1/organizations/<имя организации>/environments/<имя среды>/provisioning/axstatus
  3. Вы также можете проверить состояние базы данных PostgreSQL, выполнив на компьютере 2 следующую команду для запуска psql:
    > psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee

    В командной строке введите следующую команду, чтобы просмотреть таблицу аналитики для вашей организации:
    apigee=# : \d Analytics."<имя организации>.prod.fact"

    Используйте следующую команду для выхода из psql:
    апигей=# \q
  4. Получите доступ к пользовательскому интерфейсу Apigee Edge с помощью веб-браузера. Помните, что вы уже записали URL-адрес консоли управления в конце установки.
    1. Запустите предпочитаемый вами браузер и введите URL-адрес пользовательского интерфейса Edge. Он выглядит примерно так, как показано ниже, где IP-адрес соответствует компьютеру 1 или компьютеру, на котором вы установили пользовательский интерфейс для альтернативных конфигураций:
      http://192.168.56.111:9000/логин

      9000 — это номер порта, используемый пользовательским интерфейсом. Если вы запускаете браузер непосредственно на сервере, на котором размещен пользовательский интерфейс Edge, вы можете использовать URL-адрес в форме:
      http://localhost:9000/логин

      Примечание . Убедитесь, что порт 9000 открыт.
    2. На странице входа в консоль укажите имя пользователя и пароль системного администратора Apigee.
      Примечание . Это глобальный пароль системного администратора, который вы установили во время установки. Альтернативно вы можете:
  5. Зарегистрируйте новую учетную запись пользователя Apigee и используйте новые учетные данные пользователя для входа.
    1. Нажмите «Войти», браузер перенаправит на:
      http://192.168.56.111:9000/platform/#/<имя организации>/

      и открывает панель мониторинга, которая позволяет вам настроить созданную ранее организацию (если вы вошли в систему с использованием учетных данных администратора Apigee).
    2. Если вы новичок в Edge, теперь вы можете создать свой первый прокси-сервер API. Дополнительные сведения см. в разделе Создание первого прокси-сервера API .