Как настроить новый интерфейс Edge

В этом документе описано, как установить и настроить New Edge UI для Apigee Edge for Private Cloud. В версии 4.54.00 новый интерфейс Edge состоит из двух компонентов RPM:

  • edge-management-ui – бэкенд-сервер New Edge UI.
  • edge-management-ui-static – статические веб-объекты для интерфейса New Edge UI.

Новый интерфейс Edge устанавливается по умолчанию при запуске setup.sh с профилем aio (все в одном), sa (отдельный) или ms (сервер управления) или может быть установлен отдельно на узле с использованием профиля ue.

Требования

Перед установкой или настройкой нового пользовательского интерфейса Edge в Apigee Edge для частного облака убедитесь, что узел соответствует следующим требованиям:

  • Требования к оборудованию и операционной системе:
    • 4 ГБ оперативной памяти;
    • 2 ядра ЦП;
    • 60 ГБ места на диске;
    • Версия 4.54.00 утилиты apigee-setup, установленная на узле, как описано в разделе Установка утилиты apigee-setup для Edge.
    • Порт 3001 должен быть открыт. Этот порт используется по умолчанию для запросов к новому интерфейсу Edge. Если вы измените порт, используя свойства, описанные в файле конфигурации нового интерфейса Edge, убедитесь, что порт открыт.
  • Аутентификация:
    • Базовая аутентификация (по умолчанию). Включена по умолчанию (AUTH_MODE=basic). Использует учетные данные сервера управления Edge и SymasLDAP без необходимости во внешнем поставщике идентификационной информации (IDP).
    • SSO / внешний поставщик идентификационной информации (необязательно). Вы можете настроить Apigee SSO или внешнего поставщика идентификационной информации (например, SAML или OIDC). Если вы подключаетесь к внешнему поставщику идентификационной информации по протоколу TLS, он должен поддерживать TLS версии 1.2 или более поздней.

Подробнее о новом интерфейсе Edge для частного облака…

Обзор установки и настройки

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

  • Убедитесь, что на узле установлена утилита apigee-setup.
  • Создайте файл конфигурации в тихом режиме и измените его настройки.
  • Выполните команду /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile. Это позволит установить и настроить edge-management-ui и edge-management-ui-static.
  • Войдите в систему и протестируйте новый интерфейс Edge по адресу http://new_edge_UI_IP:3001.

Если сервер управления и сервер нового интерфейса Edge находятся за балансировщиком нагрузки с разгрузкой TLS, выполняемой на балансировщике нагрузки, убедитесь, что конфигурация отражает свойства, выделенные в разделе Настройка нового интерфейса Edge, когда TLS завершается на балансировщике нагрузки.

Файл конфигурации нового интерфейса Edge

Ниже приведен пример файла конфигурации для установки и настройки New Edge UI с базовой аутентификацией по умолчанию.

Базовая конфигурация аутентификации (по умолчанию)

# IP of the Edge Management Server.
IP1=management_server_IP

# IP of the New Edge UI node (can be the same as IP1 or a separate node).
IP2=new_edge_UI_server_IP

# Edge sys admin credentials.
ADMIN_EMAIL=your@email.com
APIGEE_ADMINPW=your_password    # If omitted, you are prompted for it.

# Edge Management Server information.
APIGEE_PORT_HTTP_MS=8080
MSIP=$IP1
MS_SCHEME=http

#
# New Edge UI configuration.
#
MANAGEMENT_UI_PORT=3001
MANAGEMENT_UI_IP=$IP2
MANAGEMENT_UI_APP_ENV=OPDK
MANAGEMENT_UI_SCHEME=http
MANAGEMENT_UI_PUBLIC_URIS=$MANAGEMENT_UI_SCHEME://$MANAGEMENT_UI_IP:$MANAGEMENT_UI_PORT

# Authentication mode (basic is default)
AUTH_MODE=basic

## SMTP Configuration
SKIP_SMTP=n       # Skip now and configure later by specifying "y".
SMTPHOST=smtp.example.com
SMTPUSER=your@email.com
SMTPPASSWORD=your_email_password
SMTPSSL=y
SMTPPORT=465      # If no SSL, use a different port, such as 25.
SMTPMAILFROM="My Company <myco@company.com>"

Как установить или настроить новый интерфейс Edge

Чтобы установить или настроить новый интерфейс Edge с помощью профиля ue, выполните следующие действия:

  1. Войдите в целевой узел как администратор.
  2. Установите на узел утилиту apigee-setup версии 4.54.00, как описано в статье Как установить утилиту apigee-setup для Edge.
  3. Чтобы очистить всю кешированную информацию с помощью Yum, выполните следующую команду: 
    sudo yum clean all
  4. Создайте файл конфигурации, как описано в разделе Новый файл конфигурации Edge UI, и убедитесь, что он принадлежит пользователю apigee: 
    chown apigee:apigee configFile
  5. На узле выполните следующую команду: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile

    Утилита apigee-setup устанавливает и настраивает edge-management-ui и edge-management-ui-static.

  6. Войдите в New Edge UI, открыв в браузере следующий URL: 
    http://new_edge_UI_IP:3001

    где new_edge_UI_IP – IP-адрес или имя хоста узла, на котором размещен новый пользовательский интерфейс Edge.

  7. Введите учетные данные.

    Откроется новый интерфейс Edge. Информацию об использовании нового интерфейса Edge можно найти в статье Новый интерфейс Edge для частного облака.

    Если новый интерфейс Edge не отображается, убедитесь, что порт 3001 открыт для подключений.

Необязательно. Если вы хотите настроить Apigee SSO для аутентификации, выполните инструкции в разделах Установка и настройка Apigee SSO и Включение внешнего поставщика идентификационной информации в новом интерфейсе Edge.

Как удалить новый интерфейс Edge

Чтобы удалить интерфейс New Edge из узла, удалите компоненты edge-management-ui и edge-management-ui-static.

Чтобы удалить компоненты New Edge UI, выполните следующие действия:

/opt/apigee/apigee-service/bin/apigee-service edge-management-ui uninstall
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui-static uninstall

Чтобы удалить все компоненты Edge с узла:

  1. Остановите все службы Edge, запущенные на компьютере: 
    /opt/apigee/apigee-service/bin/apigee-all stop
  2. Очистите кеш yum: 
    sudo yum clean all
  3. Удалите все пакеты RPM Apigee: 
    sudo rpm -e $(rpm -qa | egrep "(apigee-|edge-)")
  4. Удалите корневой каталог установки: 
    sudo rm -rf /opt/apigee