Как установить новую версию Edge (бета)

Edge for Private Cloud v4.18.01

В этом документе описывается, как установить бета-версию New Edge experience для Edge for Private Cloud. Новый интерфейс Edge – это интерфейс Edge следующего поколения.

Чтобы попробовать New Edge в установке Edge для частного облака, вы должны:

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

Подробнее о новом интерфейсе Edge для Private Cloud…

Общие сведения об установке

Чтобы установить бета-версию New Edge experience для Edge for Private Cloud, необходимо выполнить два разных процесса установки:

  • Установите базовый пользовательский интерфейс Edge, который называется shoehorn, и настройте его так, чтобы для аутентификации в Edge использовался протокол SAML.
  • Установите New Edge experience и настройте его для использования SAML при аутентификации в Edge. После установки новой версии Edge вы можете войти в нее и начать работу.

Требования к установке

  • Перед установкой новой версии Edge необходимо включить SAML в Edge. Новая версия Edge поддерживает только SAML в качестве механизма аутентификации.

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

    Информацию о том, как включить SAML в Edge, можно найти в статье Supporting SAML on Edge for Private Cloud (Поддержка SAML в Edge для частного облака).
  • Вы должны установить New Edge на его собственном узле. Его нельзя установить на узел, содержащий другие компоненты Edge. Узел должен соответствовать следующим требованиям:

Что нужно учесть перед установкой новой версии Edge

Как описано выше в разделе "Требования", для работы с новым интерфейсом Edge необходимо включить SAML в Edge. Это означает, что аутентификация пользователей контролируется поставщиком идентификационной информации SAML, в котором вы настраиваете использование адресов электронной почты в качестве идентификаторов пользователей. Поэтому все пользователи New Edge Experience должны быть зарегистрированы у поставщика идентификационной информации SAML.

Классический пользовательский интерфейс Edge, который вы установили по умолчанию вместе с Edge для частного облака, не требует SAML. Для этого можно использовать SAML или базовую аутентификацию. Это значит, что вы можете:

  • Включите поддержку SAML в Edge, а также в классическом интерфейсе и в New Edge experience.

    В этом сценарии все пользователи классического интерфейса и New Edge зарегистрированы у поставщика идентификационной информации SAML. Информацию о том, как добавлять новых пользователей к поставщику идентификационной информации SAML, можно найти в разделе Регистрация новых пользователей Edge.
  • Включите поддержку SAML в Edge, но оставьте базовую аутентификацию включенной. В новом интерфейсе Edge используется SAML, а в классическом – базовая аутентификация.

    В этом сценарии все пользователи классического интерфейса входят в систему с учетными данными базовой аутентификации, которые хранятся в базе данных Edge OpenLDAP. Пользователи новой версии Edge регистрируются у поставщика идентификационной информации SAML и входят в систему с помощью SAML.

    Однако пользователь классического интерфейса не сможет войти в New Edge, пока вы не добавите его в поставщик идентификационной информации SAML, как описано в разделе Регистрация новых пользователей Edge.

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

Файл конфигурации содержит всю информацию, необходимую для установки и настройки New Edge experience. Для установки и настройки базового интерфейса и New Edge experience можно использовать один и тот же файл конфигурации.

Пример файла конфигурации приведен ниже.

# IP of the Edge Management Server. 
# This node also hosts the Edge SSO module and the current, or classic, Edge UI.
IP1=11.111.111.111

# IP of the New Edge experience node.
IP2=22.222.222.222 

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

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

# URLs for the different UIs.
# URL of classic Edge UI.
ROUTES_CLASSICUI="http://$IP1:9000"
# URL of New Edge experience.
ROUTES_SHOEHORN="http://$IP2:9000"

# New Edge experience configuration.
# Enable the New Edge experience.
EDGEUI_ENABLE_UNIFIED_UI=y
# Access port for the New Edge experience.
MANAGEMENT_UI_PORT=3001
MANAGEMENT_UI_APP_ENV=OPDK
MANAGEMENT_UI_IP=$IP2
# Disable TLS on the New Edge experience.
# This release does not support TLS.
MANAGEMENT_UI_USE_HTTPS=n

# SSO configuration for the New Edge experience.
MANAGEMENT_UI_SSO_ENABLED=y
MANAGEMENT_UI_SSO_CLIENT_OVERWRITE=y
MANAGEMENT_UI_SSO_CLIENT_ID=newueclient
MANAGEMENT_UI_SSO_CLIENT_SECRET=secret111

# Location of New Edge experience.
MANAGEMENT_UI_PUBLIC_URIS=http://$IP2:3001
MANAGEMENT_UI_SSO_REGISTERED_PUBLIC_URIS=$MANAGEMENT_UI_PUBLIC_URIS
MANAGEMENT_UI_SSO_CSRF_SECRET=secret222
MANAGEMENT_UI_SSO_CSRF_EXPIRATION_HOURS=24
MANAGEMENT_UI_SSO_STRICT_TRANSPORT_SECURITY_AGE_HOURS=24
MANAGEMENT_UI_SSO_PUBLIC_KEY_CACHE_HOURS=0.5

# Edge SSO configuration.
# Some settings are for the classic UI, 
# but are still required to configure the New Edge experience.
# Enable SSO.
EDGEUI_SSO_ENABLED=y

# Information about Classic UI
EDGEUI_PUBLIC_URIS=http://$IP1:9000
# Information about publicly accessible URL for Classic UI.
EDGEUI_SSO_REGISTERED_PUBLIC_URIS=$EDGEUI_PUBLIC_URIS
# The name of the OAuth client used to connect to apigee-sso. 
# The default client name is edgeui.
# Apigee recommends that you use the same settings as you used
# when enabling SAML on the classic Edge UI.
EDGEUI_SSO_CLIENT_NAME=edgeui
# Oauth client password using uppercase, lowercase, number, and special chars. 
EDGEUI_SSO_CLIENT_SECRET=ssoClient123
# If set, existing EDGEUI client will deleted and new one will be created.
EDGEUI_SSO_CLIENT_OVERWRITE=y

# Information about Edge SSO module.
# Externally accessible IP or DNS of Edge SSO module.
SSO_PUBLIC_URL_HOSTNAME=$IP1
SSO_PUBLIC_URL_PORT=9099
# Default is http. Set to https if you enabled TLS on the Edge SSO module.
# If Edge SSO uses a self-signed cert, you must also set MANAGEMENT_UI_SKIP_VERIFY to "y".
# MANAGEMENT_UI_SKIP_VERIFY=y
SSO_PUBLIC_URL_SCHEME=http
# SSO admin credentials as set when you installed Edge SSO module.
SSO_ADMIN_NAME=ssoadmin
SSO_ADMIN_SECRET=Secret123

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

Установите базовый пользовательский интерфейс Edge (shoehorn)

Прежде чем устанавливать новую версию Edge, необходимо установить базовый интерфейс Edge, который называется shoehorn.

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

  1. Установите на узел утилиту apigee-setup версии 4.18.01, как описано в статье Как установить утилиту apigee-setup для Edge.
  2. Чистота: 
    > sudo yum clean all
  3. Создайте файл конфигурации, как описано выше, и убедитесь, что его владельцем является пользователь apigee. 
    > chown apigee:apigee configFile

    где configFile – файл конфигурации, описанный в разделе Файл конфигурации установки.

  4. Установите версию Shoehorn пользовательского интерфейса Edge: 
    > /opt/apigee/apigee-service/bin/apigee-service edge-ui install
  5. Настройте Edge UI: 
    > /opt/apigee/apigee-service/bin/apigee-service edge-ui setup -f configFile
  6. Включите SAML в интерфейсе Edge: 
    > /opt/apigee/apigee-service/bin/apigee-service edge-ui configure-sso -f configFile

Установите новый браузер Edge

После установки базового пользовательского интерфейса Edge вы можете установить и настроить новый интерфейс Edge.

Чтобы установить новую версию Edge:

  1. Установите новую версию Edge: 
    > /opt/apigee/apigee-service/bin/apigee-service edge-management-ui install
  2. Перейдите в каталог edge-management-ui: 
    > cd /opt/apigee/edge-management-ui
  3. Настройте New Edge: 
    > /opt/apigee/apigee-service/bin/apigee-service edge-management-ui setup -f configFile

    где configFile – файл конфигурации, описанный в разделе Файл конфигурации установки.

  4. Включите SAML в New Edge: 
    > /opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-sso -f configFile
  5. Войдите в New Edge, открыв в браузере следующий URL: 
    http://newEdgeExperienceIP:3001

    где newEdgeExperienceIP – IP-адрес узла, на котором размещен новый интерфейс Edge. Вам будет предложено ввести учетные данные SAML. После ввода учетных данных откроется новая версия Edge.

  6. Дополнительную информацию, в том числе ссылки на сведения об использовании New Edge Experience, можно найти в статье The New Edge Experience for Private Cloud (Beta).

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

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

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

Чтобы удалить базовый пользовательский интерфейс Edge (shoehorn):

> /opt/apigee/apigee-service/bin/apigee-service edge-ui 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-|baas)")
  4. Удалите корневой каталог установки: 
    > sudo rm -rf /opt/apigee