4.50.00 Edge for Private Cloud 版本说明

<ph type="x-smartling-placeholder"></ph> 您正在查看 Apigee Edge 文档。
转到 Apigee X 文档
信息

本部分将介绍 4.50.00 版 Edge for Private Cloud 功能版本。

版本摘要

下表总结了此版本中的变更:

新功能

此版本包含以下新功能:

○ API 代理中现在提供 TLS 连接信息
○ ZooKeeper 升级
○ Drupal 8 门户的可用性,以及 Drupal 7 的服务终止 (EOL)

如需详细了解上述各项新功能,请参阅 新功能

向后兼容性 此版本中引入了以下影响向后兼容性的问题 适用于私有云的 Apigee Edge: <ph type="x-smartling-placeholder">
    </ph>
  • 由于问题 132443137(如 2001 年 3 月 19 日公开 Cloud 版本说明),消息处理器现在会忽略以 X-Apigee-*。因此,您必须重构所有使用 X-Apigee-* 标头,并将这些标头替换为受支持的标头。
  • Cassandra 日志文件的名称已更改。现在是:

    /opt/apigee/var/log/apigee-cassandra/system.log
包含的版本

自上一个 Edge for Private Cloud 功能版本以来,以下版本 已发布并包含在此版本中:

○ 边缘:
20.04.06(运行时、API 管理、变现管理)
20.03.27(界面)
20.03.16(Edge Analytics)
20.03.11(界面)
20.02.27(API 监控)
20.02.24(界面)
20.02.03(API 监控)
20.01.29(界面)
20.01.22(界面)
20.01.06(API 管理/运行时)
○ Edge(续):
20.01.06(界面)
19.11.13(API 安全报告)
19.10.01(界面)
19.09.26(Edge 界面/门户)
19.08.27(界面)
19.08.15(API 安全报告)
19.07.29(界面)
○ 门户网站:
20.05.27.00
20.04.13.00
20.03.20.00
19.12.20.00
19.11.21.00
19.09.25.00
退休
弃用

4.50.00 发布后:

  • 4.18.05::适用于私有云的 Apigee Edge 4.18.05 版 现已弃用。

此版本中已弃用的功能包括:

  • 支持 Node.js 代理和安全保险柜
  • 支持 OAuth v1 政策
  • 对“并发速率限制”政策的支持
  • 支持 Istio 的 Apigee 适配器
  • Teams 抢先体验功能支持

有关弃用的更多详细信息(包括移除时间表),请参阅 Apigee 弃用和停用

bug 修复

此版本修复了以下问题:

○ 使用类似的密钥配置密钥库时,消息处理器无法加载环境 或别名。(154428338)
○ 安装补丁 (152574421) 时出现 QPid 依赖项冲突
○ 缓存内存限制器未遵循 L1 缓存大小上限 (151449163)
○ 备份脚本失败 (150710952)
○ QPid 服务器发送额外日志消息 (148231209)
○ 未存储单点登录信息的 Postgresql 备份 (147458330)
○ apigee-nginx 版本未升级。(146872858)
○ 不再显示“试用新界面”消息 (145419621)
○ Apigee SmartDocs API 漏洞 (145340106)
○ Postgres 备份脚本失败 (145254693)
○ 各种安全修复程序 (142150706)
○ 路由器到消息处理器的高速率超时 (138107618)
○ SSO 设置脚本失败 (135616498)
○ JMX 端口 (132044907)
○ 因竞态条件而导致运行时流量出现间歇性 404 错误 (130653816)
○ 升级期间 OpenLDAP 损坏 (120799182)
○ 多个数据中心配置中出现 DataAccessException (76087166)
○ 将 MessageLogging 政策中的 FormatMessage 设置为 false (68722102)

如需详细了解各项修复,请参阅问题修复

已知问题

此版本包含以下已知问题:

○ JWT 验证失败 (159788170)
○ Mint 评级服务器内存泄漏 (137865184)
apigee-monit 在 Amazon Linux 1 (122370980) 上不受支持
○ 消息处理器备份功能未备份正确的文件集 (121095148)
○ 升级后缓存未命中率提高 (160109014)
○ 针对正文和 Content-Encoding: gzip 的 GET 请求的 HTTP 408 响应。(159858015)

有关每个已知问题(包括解决方法)的详细信息,请参阅 已知问题

升级路径

下表显示了此版本的升级路径:

从 4.19.01 或 4.19.06 开始 直接从 4.19.01/4.19.06 升级到 4.50.00
从 4 月 18 日 直接从 4.18.05 升级到 4.50.00

新功能

本部分列出了此版本中的新功能。此外,此版本还包含 Edge 界面、Edge 管理和门户版本中的功能,请参阅 包含的版本

除了以下增强功能外,此版本还具有多种易用性, 性能、安全性和稳定性增强

API 代理中现在提供 TLS 连接信息

在通过支持 TLS 的虚拟主机向 API 代理发出请求期间, Edge 可以捕获有关 TLS 连接的信息。您的 API 代理现在可以访问这些信息 执行其他分析和验证。 如需了解详情,请参阅在 API 代理中访问 TLS 连接信息

ZooKeeper 升级

此版本包含 ZooKeeper 3.4.14。

Drupal 8 门户可用性,以及 Drupal 7 服务终止

Drupal 8 已经取代 Drupal 7,成为 Apigee 推荐的私有云开发者门户。 由于 Drupal 7 本身将于 2021 年 11 月终止长期支持, 从 2021 年 11 月起,将不再支持适用于 Drupal 7 的 Apigee 模块。静止不动时 Drupal 7 的安装/升级脚本,不应再使用,而是会 从未来版本中移除

如需了解与 Apigee 集成的 Drupal 8 模块,请参阅: 使用 Drupal 8 构建门户

支持的软件

此版本对受支持的软件进行了以下更改:

已添加支持 不再受支持

此版本新增了对以下平台的支持:

  • Red Hat Enterprise Linux (RHEL) 7.8
  • CentOS 7.8
  • Oracle Linux 7.8

此版本不再支持以下平台:

  • Red Hat Enterprise Linux (RHEL) 6.10
  • CentOS 6.10
  • Oracle Linux 6.9

如需查看受支持平台的完整列表,请参阅 支持的软件和支持的版本

bug 修复

本部分列出了此版本中修复的 Private Cloud 错误。此外, 版本包含 Edge 界面、Edge Management 和门户版本中的所有 bug 修复(如 包含的版本

问题 ID 说明
154428338

当密钥库配置类似的库时,消息处理器无法加载环境 名称或别名。

修复了加载具有相似命名的密钥库时出现的正则表达式查找冲突 。此错误会导致消息处理器无法加载关联的环境 或当在测试期间返回多个有冲突的密钥库时无法启动 查询。
152574421

安装补丁时出现 QPid 依赖项冲突

现已安装正确版本的 QPid。
151449163

缓存内存限制器未遵循 L1 缓存大小上限

缓存内存限制器现在遵循 L1 缓存大小上限。
150710952

备份脚本失败

已根据更新后的备份脚本更新了备份过程。
148231209

QPid 服务器发送额外的日志消息

QPid 服务器不再发送额外的日志消息。
147458330

Postgresql 备份未存储单点登录信息

Postgresql 备份现在会存储单点登录信息。
146872858

apigee-nginx 版本未升级。

apigee-nginx 版本现已正确升级。
145419621

不再显示“试用新界面”消息

界面不再显示“试用新界面”消息。
145340106

Apigee SmartDocs API 漏洞

更新了 Apigee SmartDocs 代理,以解决安全漏洞。请参阅 有关更多信息和必要步骤的 SmartDocs 安装过程。
145254693

Postgres 备份脚本失败

Postgres 备份脚本现在可正常运行。
142150706

各种安全修复程序

修复了安全问题,包括 #111390246。
138107618

路由器到消息处理器的高超时率

此问题现已解决。
135616498

单点登录设置脚本失败

修复了使用文件架构网址会导致 SSO 设置脚本失败的问题。
132044907

JMX 端口

JMX 端口不得对外开放,只能对内部服务器开放。
130653816

由于竞态条件而导致运行时流量出现间歇性 404 错误

修复了 MP 引导期间导致某些代理无法正确部署的竞态条件的问题。
120799182

升级期间 OpenLDAP 损坏

此问题现已解决。
76087166

多个数据中心配置中的 DataAccessException

在多个数据中心配置中,如果一个数据存储区变得不可用,您不会再看到 DataAccessException 错误。
68722102

在 MessageLogging 政策中将 FormatMessage 设置为 false

您现在可以在 MessageLogging 政策中将 FormatMessage 设置为 false。

已知问题

下表列出了此版本中的已知问题:

问题 ID 说明
159788170

JWT 验证失败

对于小于 2048 位的 RSA 密钥,JWT 验证会失败。

临时解决方法:

确保您的密钥不小于 2048 位。
137865184

Mint 评级服务器内存泄漏

在 mxgroup 中注册新的 Qpid 实例时,在没有使用者的情况下建立队列,这会导致队列深度增加,直到它用完所有可用资源为止。

临时解决方法:

无。
122370980

在 Amazon Linux 1 上不支持 apigee-monit

临时解决方法:

无。
121095148

消息处理器备份功能未备份正确的文件集

临时解决方法:

再次运行备份,它应该会备份正确的文件集。

160109014

升级后缓存未命中率提高

升级到版本 4.50.00 后,代理的缓存未命中率可能会增大。这些未命中可能伴随着 MP 日志中的错误消息增加,类似如下内容:

InvalidClassException when fetching cps cache entry from second level - com.apigee.jsonparser.LinkedJSONObject; local class incompatible: stream classdesc serialVersionUID = -8575741446425131573, local class serialVersionUID = 752634431212433936. Considering it as cache miss.

临时解决方法:

无。缓存命中率预计会随着时间的推移保持稳定。

159858015

针对正文和 Content-Encoding: gzip 的 GET 请求的 HTTP 408 响应。

当 API 客户端发出标头为 Content-Encoding: gzip 且请求正文为空的 GET 请求时,会收到 408 超时响应。

临时解决方法:

在以空正文发出 GET 请求时省略 Content-Encoding 标头。

下一步

如需开始使用适用于 Private Cloud 4.50.00 的 Edge,请访问以下链接:

新安装:
新安装概览
现有安装次数:
升级路径