配置新 Edge 界面

本文档介绍了如何为适用于私有云的 Apigee Edge 安装和配置 New Edge 界面。在 4.54.00 版中，New Edge 界面包含两个 RPM 组件：

  • edge-management-ui：New Edge 界面后端服务器。
  • edge-management-ui-static：New Edge 界面前端的静态 Web 资源。

当您使用 aio（一体式）、sa（独立）或ms（管理 服务器）配置文件运行setup.sh时，系统会默认安装 New Edge 界面，也可以使用ue配置文件在节点上单独安装。

前提条件

在 Apigee Edge for Private Cloud 安装中安装或配置 New Edge 界面之前，请确保节点满足 以下要求：

  • 硬件和操作系统要求：
    • 4 GB RAM
    • 2 个 CPU 核心
    • 60 GB 磁盘可用空间
    • 节点上安装了 4.54.00 版的 apigee-setup 实用程序，如安装 Edge apigee-setup 实用程序中所述。
    • 端口 3001 必须处于打开状态。这是用于向 New Edge 界面发出请求的默认端口。如果您使用 New Edge 界面配置文件中所述的属性更改了端口，请确保该端口处于打开状态。
  • 身份验证：
    • 基本身份验证（默认）：默认启用 (AUTH_MODE=basic)。使用 Edge 管理服务器和 SymasLDAP 凭据 而无需外部身份提供商 (IDP)。
    • SSO / 外部 IDP（可选） ：您可以选择配置 Apigee SSO 或外部 IDP（例如 SAML 或 OIDC）。 如果您通过 TLS 连接到外部 IDP，则您的 IDP 必须支持 TLS v1.2 或更高版本。

如需详细了解 New Edge 界面的功能，请参阅 适用于私有云的 New Edge 界面。

安装和配置概览

概括来讲，使用 ue 配置文件安装或重新配置 New Edge 界面的过程如下：

  • 确保节点上安装了 apigee-setup 实用程序。
  • 创建静默配置文件，并使用您的设置对其进行修改。
  • 运行 /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile。 这会安装并配置 edge-management-ui 和 edge-management-ui-static。
  • 登录并测试 http://new_edge_UI_IP:3001 处的 New Edge 界面。

如果您的管理服务器和 New Edge 界面服务器位于负载均衡器后面，并且 TLS 卸载 发生在负载均衡器上，请确保配置反映了在 负载均衡器上终止 TLS 时配置 New Edge 界面中突出显示的属性 。

New Edge 界面配置文件

以下示例展示了使用默认基本身份验证安装和配置 New Edge 界面的配置文件 。

基本身份验证配置（默认）

# 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>"

安装或配置 New Edge 界面

如需使用 ue 配置文件安装或配置 New Edge 界面，请执行以下操作：

  1. 以管理员身份登录目标节点。
  2. 在节点上安装 4.54.00 版的 apigee-setup 实用程序， 如安装 Edge apigee-setup 实用程序中所述。
  3. 运行以下命令，使用 Yum 清理所有缓存的信息： 
    sudo yum clean all
  4. 按照 New Edge 界面配置文件 中所述创建配置文件，并确保该文件归 "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 界面： 
    http://new_edge_UI_IP:3001

    其中，new_edge_UI_IP 是托管 New Edge 界面的节点的 IP 地址或主机名。

  7. 输入您的凭据。

    随即会显示 New Edge 界面。如需了解如何使用 New Edge 界面，请参阅 适用于私有云的 New Edge 界面。

    如果 New Edge 界面未显示，请确保端口 3001 已打开以进行连接。

可选： 如果您想配置 Apigee SSO 以进行 身份验证，请按照 安装和配置 Apigee SSO 和 在 New Edge 界面上启用外部 IDP 中的步骤操作。

卸载 New Edge 界面

如需从节点卸载 New Edge 界面，请卸载 edge-management-ui 和 edge-management-ui-static 组件。

如需卸载 New Edge 界面组件，请执行以下操作：

/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. 移除所有 Apigee RPM： 
    sudo rpm -e $(rpm -qa | egrep "(apigee-|edge-)")
  4. 移除安装根目录： 
    sudo rm -rf /opt/apigee