Как добавить организацию

Чтобы зарегистрировать организацию, создайте файл конфигурации регистрации и передайте его команде setup-org. Ниже описаны все эти шаги.

Информацию о том, как использовать 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.

Примечание.

Выполнить команду setup-org

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

При регистрации организации скрипт setup-org выполняет следующие действия:

  • Создает новую организацию.
  • Создает среду.
  • Создает виртуальный хост для среды.
  • Устанавливает указанного пользователя в качестве администратора организации. Обратите внимание на следующее:
    • Вы можете использовать существующего пользователя или создать нового для администратора организации.
    • Администратор организации не должен быть системным администратором.
  • Связывает организацию с подом gateway. (Это значение по умолчанию, и его нельзя изменить.)
  • Связывает среду со всеми обработчиками сообщений.
  • Включает аналитику.

Чтобы выполнить setup-org:

  1. Установите apigee-provision на узле сервера управления: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision install
  2. Запустите скрипт setup-org на узле сервера управления и укажите на файл конфигурации, созданный в разделе Создайте файл конфигурации для регистрации: 
    /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 на узле сервера управления:

  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…

Другие полезные ресурсы: