4.52.02.04 - Edge for Private Cloud 版本说明

您正在查看 Apigee Edge 文档。
前往 Apigee X 文档
信息

2025 年 7 月 25 日,我们发布了 Apigee Edge for Private Cloud 的新版本。

更新过程

本部分介绍了如何安装此版本(如果您要从 Edge for Private Cloud 的先前版本进行更新)。如果您需要从早期版本进行更新,请参阅应用多个补丁版本

更新此版本将更新以下列出的组件:

  • edge-gateway-4.52.02-0.0.60308.noarch.rpm
  • edge-management-server-4.52.02-0.0.60308.noarch.rpm
  • edge-message-processor-4.52.02-0.0.60308.noarch.rpm
  • edge-postgres-server-4.52.02-0.0.60308.noarch.rpm
  • edge-qpid-server-4.52.02-0.0.60308.noarch.rpm
  • edge-router-4.52.02-0.0.60308.noarch.rpm
  • apigee-cassandra-3.11.16-0.0.2596.noarch.rpm
  • apigee-cassandra-client-3.11.16-0.0.2544.noarch.rpm
  • apigee-lib-4.52.02-0.0.1028.noarch.rpm
  • apigee-setup-4.52.02-0.0.1150.noarch.rpm
  • apigee-qpidd-8.0.6-0.0.2537.noarch.rpm

您可以输入以下命令来检查当前安装的 RPM 版本,以确定是否需要更新:

apigee-all version

如需更新安装,请在 Edge 节点上执行以下程序:

  1. 在所有边缘节点上:

    1. 清理 Yum 代码库:
      sudo yum clean all
    2. 将最新的 Edge 4.52.02 bootstrap_4.52.02.sh 文件下载到 /tmp/bootstrap_4.52.02.sh
      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
    3. 安装 Edge 4.52.02 apigee-service 实用程序和依赖项:
      sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord

      其中,uNamepWord 是您从 Apigee 收到的用户名和密码。如果您省略 pWord,系统会提示您输入该实参。

    4. 使用 source 命令执行 apigee-service.sh 脚本:
      source /etc/profile.d/apigee-service.sh
    5. 更新 apigee-setup 实用程序:
      apigee-service apigee-setup update
  2. 在所有 Cassandra 节点上执行 update.sh 脚本:
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  3. 在所有 Edge 节点上,针对 Edge 进程执行 update.sh 脚本:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  4. 在所有 Qpid 节点上,执行 update.sh 脚本:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

问题修复

本部分列出了在此版本中修复的私有云 bug。

问题 ID 说明
429056579 修复了 qpid's wait_for_ready 脚本。

已解决的安全问题

此版本中未添加任何新的安全问题。

支持的软件发生变化

新增了对 Amazon-Linux-2023.7(AL2023.7) 的支持。

如需查看受支持软件的完整列表,请参阅 Edge for Private Cloud 支持的软件

弃用和停用

此版本中没有新的弃用或停用功能。

新功能

本部分列出了此版本中的新功能。

问题 ID 说明
390047431

添加了对 Amazon-Linux-2023(AL2023) 的支持。

Edge for Private Cloud API Hub 连接器集成

此版本支持 Apigee API Hub 连接器,用于 Private Cloud 集成,使组织能够将 API 元数据和运行时分析数据同步到 Google Cloud API Hub。该集成包括一个新的 Apigee API Hub 连接器二进制文件,以及对消息处理器的增强功能,该消息处理器可将运行时数据导出到网络文件系统 (NFS)。Private Cloud 的 API Hub 连接器会使用此数据并将其发布到 API Hub。没有针对现有适用于私有云的 Apigee Edge 行为的 bug 修复或更改。如需详细了解 Edge for Private Cloud API Hub 连接器集成,请参阅 API Hub 连接器集成概览和流程

主要亮点:

  • 新的 Apigee API Hub 连接器二进制文件
  • 增强了消息处理器,可将运行时数据导出到 NFS
  • 全面支持将 API 元数据和运行时数据发布到 API Hub
  • 使用标准 Apigee API Hub 连接器为私有云 API 流选择启用基于选择的激活
  • 与连接器的新 API 集成,支持上传环境和代理软件包
  • 连接器的服务账号现在需要新的 IAM 权限 (roles/apihub.admin),才能启用新的 API 功能

个人身份信息 (PII) 遮盖

此功能可让您在将 API 代理和共享流软件包同步到 API Hub 之前,先屏蔽其中的敏感数据,从而确保数据隐私和合规性。

  • 默认遮盖:连接器会自动应用内置的 XPath 表达式列表(默认遮盖),以遮盖政策配置中已知的个人身份信息来源(例如硬编码的基本身份验证密码、JWT/JWS 政策中的私钥)。
  • 自定义遮盖:您可以在 /opt/apigee/customer/application/uapim-connector.properties 文件中设置 conf_uapim_connector.uapim.mask.xpaths 属性来配置其他自定义遮盖,从而定位特定客户的敏感字段。

组织协调

该连接器现在提供了一个明确的流程,用于将现有 Apigee 组织的整个 API 元数据集与 API Hub 进行协调(或回填)。

  • 流程:通过暂时从连接器的配置中选择退出组织(清除 runtimeDataPubsubmetadataPubsub 属性值),然后立即选择重新加入组织(恢复这些值)来实现协调。
  • 功能:此操作会强制连接器对指定组织的所有元数据执行完整提取和完全重新同步,从而解决潜在的数据不一致问题。

已知问题

如需查看已知问题的完整列表,请参阅 Edge for Private Cloud 的已知问题

应用多个补丁版本

本部分介绍了如何应用多个补丁程序版本(如果您要从早于上一个补丁程序版本发布的 Edge for Private Cloud 版本进行更新)。

每个补丁版本都包含对 Edge Private Cloud 特定组件的更新,例如 edge-management-server。 如需应用多个补丁版本,您需要更新每个 Edge 组件,这些组件包含在比您当前安装的版本更新的补丁版本中。您可以查看当前版本之后的所有 Edge for Private Cloud 版本的版本说明,并检查这些版本的 RPM 列表,找到这些组件。如需获取指向所有 Edge for Private Cloud 版本说明的链接,请参阅 Apigee 版本说明

注意:您只需更新每个组件一次,方法是安装补丁版本中包含的最新版本组件的 RPM。按照相应版本的版本说明中的说明更新组件。

注意:升级组件会自动安装组件的最新补丁版本。如果您想升级到非最新版本的补丁版本,则需要使用 Apigee 镜像维护 Apigee 代码库的自有 tarball 副本,并使用此镜像进行 Apigee 安装。 如需了解详情,请参阅 使用本地 Edge 代码库来维护 Edge 版本