迁移到新版 Edge 界面

从 Apigee Edge for Private Cloud 4.54.00 开始，经典版界面 (edge-ui) 已被移除，新版 Edge 界面 (edge-management-ui) 是默认的管理界面。 本部分提供了从经典版界面迁移到新版 Edge 界面的指南，包括 使用 IDP（例如 LDAP 或 SAML）的部署。

如需了解详情，请参阅：

哪些人可以执行迁移

如需迁移到新版 Edge 界面，您必须以最初安装 Edge 的用户或根用户身份登录。运行新版 Edge 界面的安装程序后，任何授权用户都可以对其进行配置。

准备工作

在从经典版界面迁移到新版 Edge 界面之前，请阅读以下一般准则：

  • 备份现有的经典版界面配置

    在升级到 4.54.00 之前，Apigee 建议您备份现有的经典版界面 配置文件，以便将自定义设置（例如 SMTP、TLS、会话超时、 和品牌属性）转移到 /opt/apigee/customer/application/management-ui.properties。

  • 端口/防火墙

    默认情况下，经典版界面使用端口 9000。新版 Edge 界面使用端口 3001 （可以使用 conf_uebe_port 进行配置）。

  • 移除经典版界面

    如果您要在之前托管经典版界面的节点上安装新版 Edge 界面， 请先卸载经典版界面 (edge-ui)，然后再安装新版 Edge 界面 (edge-management-ui)。

  • 身份验证（基本身份验证、LDAP 或 SAML）

    在 Edge for Private Cloud 4.54.00 中，新版 Edge 界面同时支持基本 身份验证 (AUTH_MODE=basic) 和通过 Apigee SSO 进行的外部 IDP 身份验证 (AUTH_MODE=sso)：

    • 基本身份验证： 使用内部 OpenLDAP (apigee-openldap) 实现，无需 SSO。
    • LDAP IDP（使用 Apigee SSO）： 使用外部 LDAP IDP 或内部 OpenLDAP (apigee-openldap) 实现，并使用 Apigee SSO。
    • SAML IDP（使用 Apigee SSO）： 使用外部 SAML IDP，并使用 Apigee SSO。

    如需了解详情，请参阅安装和配置 IDP。

  • 同一 IDP

    本部分假设您在迁移后将使用同一 IDP。例如，如果您 之前使用外部 LDAP IDP 和经典版界面，那么您将继续使用外部 LDAP IDP 和新版 Edge 界面。

使用内部 LDAP IDP 进行迁移

如果您使用内部 OpenLDAP (apigee-openldap) 实现，则可以直接在新版 Edge 界面中使用基本身份验证（请参阅配置新版 Edge 界面），也可以 按照以下准则使用内部 LDAP 配置 Apigee SSO：

使用外部 LDAP IDP 进行迁移

在配置中使用外部 LDAP 实现作为 IDP 的情况下，从经典版界面迁移到新版 Edge 界面时，请使用以下准则：

  • LDAP 配置

    使用 配置新版 Edge 界面、 安装和配置 Apigee SSO以及 配置 LDAP IDP配置 Apigee SSO 和新版 Edge 界面。

  • 管理服务器配置

    启用 Apigee SSO 后，从 /opt/apigee/customer/application/management-server.properties 文件中移除任何旧版经典版界面外部 LDAP 属性，然后重启管理服务器。

  • 管理 API 的基本身份验证

    基本身份验证适用于机器用户，但不适用于外部 LDAP 用户。如果您的 CI/CD 流程使用基本身份验证来访问系统，这一点至关重要。

  • Management API 的 OAuth2 身份验证

    外部 LDAP 用户使用 OAuth2 令牌访问 Management API。

使用外部 SAML IDP 进行迁移

迁移到新版 Edge 界面时，SAML IDP 的安装说明没有任何变化。请参阅配置 SAML IDP。