4.50.00 Edge for Private Cloud 版本说明

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

本部分介绍了 Edge for Private Cloud 4.50.00 版功能发布版本。

版本摘要

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

新功能

此版本包含以下新功能:

○ API 代理中现在提供 TLS 连接信息
○ Zookeeper 升级
○ Drupal 8 门户的可用性以及 Drupal 7 的生命周期结束 (EOL)

如需详细了解每项新功能,请参阅新功能

向后兼容性 此版本的 Apigee Edge for Private Cloud 中引入了以下影响向后兼容性的问题:
     
  • 由于修复了问题 132443137(如19.03.01 版公共云版本说明中所述),消息处理器现在会忽略以 X-Apigee-* 开头的标头。因此,您必须重构所有使用 X-Apigee-* 标头的代码,并将这些标头替换为受支持的标头。
  • Cassandra 日志文件的名称已发生更改。现在:

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

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

○ Edge:
   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 政策
  • 对 ConcurrentRateLimit 政策的支持
  • 对 Apigee Adapter for Istio 的支持
  • 支持 Teams 抢先体验功能

如需详细了解弃用(包括移除时间表),请参阅 Apigee 弃用和停用

bug 修复

此版本包含以下 bug 修复:

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

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

已知问题

此版本存在以下已知问题:

○ JWT 验证失败 (159788170)
○ Mint 评分服务器内存泄漏 (137865184)
○ Amazon Linux 1 不支持 apigee-monit (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.05 起 直接从 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 针对 Private Cloud 推荐的开发者门户。 由于 Drupal 7 本身将于 2021 年 11 月结束其长期支持,因此自 2021 年 11 月起,Apigee 模块将不再支持 Drupal 7。虽然 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。此外,此版本还包含 Included Releases(包含的版本)中所示的 Edge 界面、Edge 管理和门户版本中的所有 bug 修复。

问题 ID 说明
154428338

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

我们修复了在加载具有类似命名惯例的密钥库时出现的正则表达式查找冲突。这会导致消息处理器无法加载与密钥库关联的环境,或者在查找期间返回多个冲突的密钥库时无法启动。
152574421

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

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

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

缓存内存限制器现在会考虑 L1 缓存大小上限。
150710952

备份脚本失败

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

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

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

Postgresql 的备份未存储 SSO 信息

Postgresql 备份现在会存储 SSO 信息。
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 评分服务器内存泄漏

当新 Qpid 实例在 mxgroup 中注册时,队列会在没有消费者的状态下构建,这会导致队列深度不断增加,直到用尽所有可用资源。

临时解决方法:

无。
122370980

apigee-monit 在 Amazon Linux 1 上不受支持

临时解决方法:

无。
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 标头。

下一步

如需开始使用 Edge for Private Cloud 4.50.00,请点击以下链接:

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