4.52.00.03 - Edge for Private Cloud 版本说明

您正在查看 Apigee Edge 文档。
转到 Apigee X 文档
info

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

注意 :此版本将支持到 2024 年 10 月 25 日。

更新过程

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

更新此版本将更新以下 RPM 列表中的组件:

  • edge-gateway-4.52.00-0.0.60200.noarch.rpm
  • edge-management-server-4.52.00-0.0.60200.noarch.rpm
  • edge-message-processor-4.52.00-0.0.60200.noarch.rpm
  • edge-postgres-server-4.52.00-0.0.60200.noarch.rpm
  • edge-qpid-server-4.52.00-0.0.60200.noarch.rpm
  • edge-router-4.52.00-0.0.60200.noarch.rpm
  • apigee-sso-4.52.00-0.0.21316.noarch.rpm
  • edge-analytics-4.52.00-0.0.40100.noarch.rpm
  • edge-management-ui-4.52.00-0.0.20029.noarch.rpm
  • edge-ui-4.52.00-0.0.20233.noarch.rpm
  • apigee-service-4.52.00-0.0.1500.noarch.rpm
  • apigee-mirror-4.52.00-0.0.1032.noarch.rpm
  • apigee-tomcat-9.0.82-0.0.939.noarch.rpm
  • apigee-configutil-4.52.00-0.0.624.noarch.rpm

您可以输入以下内容,检查当前安装的 RPM 版本,以查看是否需要更新:

apigee-all version

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

  1. 在所有 Edge 节点上:

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

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

    4. 使用 source 命令执行 apigee-service.sh 脚本:
      source /etc/profile.d/apigee-service.sh
  2. 在所有 Edge 节点上,为 Edge 进程执行 update.sh 脚本:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  3. 在所有节点上为 SSO 执行 update.sh 脚本:
  4. /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
  5. 在所有界面节点上,为界面执行 update.sh 脚本:
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  6. 如果您使用的是新版 Edge 体验,请执行以下命令:
    /opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile

已修复的安全问题

以下列表列出了此版本中已修复的已知安全问题。为避免这些问题,请安装最新版本的 Edge for Private Cloud。
问题 ID 说明
279065506 在 OAuth2 的重定向网址中,状态参数的熵已得到改进 使其不可预测,以避免跨站请求伪造 (CSRF) 漏洞。"
279065586 在标头中添加了内容安全政策,以便为网站提供额外的安全防护层 防止客户端攻击。

对受支持软件的更改

添加了对以下软件版本的支持:

  • Red Hat Enterprise Linux(Intel 64 位):版本 8.8
  • Oracle Linux(Intel 64 位):版本 7.9、8.7 和 8.8
  • Rocky Linux 8
  • Tomcat 9.0.82

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

弃用和停用

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

新功能

此版本引入了以下新功能:

设置组织和环境名称的字符数上限

在此版本中,您可以在创建新组织或环境时限制 组织和环境名称的字符数上限。字符数上限的 默认值为 255。如需设置较低的上限, 请在各自的属性文件中设置以下属性:

  • 在组织属性文件中,设置 org.name.max.length
  • 在组织属性文件中,设置 env.name.max.length

如果将其中任一属性设置为小于 0 或大于 255 的值,系统 将分别使用 1 或 255 的上限值。

设置访问令牌的有效期

在此版本中,您可以通过将属性 conf_keymanagement_oauth_access_token_expiry_time_in_millis 设置为所需的 有效期(以毫秒为单位),来设置访问令牌的有效期。此功能默认处于停用状态。如需启用此功能,请在消息处理器中将 conf_keymanagement_oauth_access_token_is_apply_limit 设置为 true

借助此功能,Apigee 管理员可以更好地控制在 Apigee 中创建的 访问令牌的有效期。

问题修复

本部分列出了在此版本中修复的 Private Cloud bug。

问题 ID 说明
290242749

在 DataMasking 中使用 ServiceCallout.response 变量时, 政策在跟踪中不可见。

此问题已修复。
260397807

电子邮件模板中的问题导致无法在电子邮件中发送多字节字符。

此问题已修复。
234544436

在新版 Edge 界面中更改组织时,左侧菜单会消失。

此问题已修复。
293268203

管理服务器节点上的分析依赖项不会自动升级。

此问题已修复。
261616264

添加了启动检查,以确保在升级过程中不会移除/删除 postgresql。

279065586

在 OAuth2 的重定向网址中,状态参数的熵已得到改进 使其不可预测,以避免跨站请求伪造 (CSRF) 漏洞。

283310836

改进了在解析大型 XML 时显示的出错消息。

245936798

组织和环境名称存在问题,导致 Postgresql <code<create< code="" dir="ltr" translate="no"> 查询失败。</code<create<>

通过改进对长组织 和环境名称 的 postgres 索引名称冲突的处理,此问题已得到修复。
293733533

Edge 网关组件中的 Spring 第三方库已从版本 5.3.20 更新到版本 5.3.27。

294363158

回归导致一些额外的维度显示在 Edge 界面的 分析和监控页面的下拉菜单中。

此问题已修复。
297889765

由 apigee-mirror 生成的工件现在具有正确的所有权。

294989027

提升了某些 Stats API 的性能。

已知问题

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

应用多个补丁版本

本部分介绍了如何应用多个补丁版本,以防您要从 早于上一个补丁版本的 Edge for Private Cloud 版本进行更新。

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

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

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