您正在查看 Apigee Edge 文档。
前往 Apigee X 文档。 信息
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 节点上执行以下步骤：
-
在所有 Edge 节点上：
- 清理 Yum 代码库：
sudo yum clean all
- 将最新的 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
- 安装 Edge 4.52.00
apigee-service实用程序和依赖项：sudo bash /tmp/bootstrap_4.52.00.sh apigeeuser=uName apigeepassword=pWord
其中，uName 和 pWord 是您从 Apigee 收到的用户名和密码。 如果您省略 pWord，系统会提示您输入该值。
- 使用
source命令执行 apigee-service.sh 脚本：source /etc/profile.d/apigee-service.sh
- 清理 Yum 代码库：
- 在所有 Edge 节点上，针对边缘进程执行
update.sh脚本：/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- 在所有节点上执行
update.sh脚本以实现 SSO： - 在所有界面节点上，针对界面执行
update.sh脚本：/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- 如果您使用的是新版 Edge，请执行以下命令：
/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
/opt/apigee/apigee-setup/bin/update.sh -c sso -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 中创建的访问令牌的过期时间。
问题修复
本部分列出了在此版本中修复的私有云 bug。
| 问题 ID | 说明 |
|---|---|
| 290242749 |
在 DataMasking 中使用 |
| 260397807 |
电子邮件模板中的一个问题导致无法在电子邮件中发送多字节字符。 此问题已修复。 |
| 234544436 |
在新版 Edge 界面中更改组织时，左侧菜单会消失。 此问题已修复。 |
| 293268203 |
管理服务器节点上的 Analytics 依赖项未自动升级。 此问题已修复。 |
| 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 |
改进了某些统计信息 API 的性能。 |
已知问题
如需查看已知问题的完整列表，请参阅 Edge for Private Cloud 的已知问题。
应用多个补丁版本
本部分介绍了如何应用多个补丁版本（如果您要从早于上一个补丁版本发布的 Edge for Private Cloud 版本进行更新）。
每个补丁版本都包含对 Edge for Private Cloud 特定组件（例如 edge-management-server）的更新。
如需应用多个补丁版本，您需要更新每个 Edge 组件，这些组件包含在比您当前安装的版本更新的补丁版本中。您可以查看 Edge for Private Cloud 的版本说明（适用于所有高于当前版本的版本），并检查这些版本的 RPM 列表，找到这些组件。如需查看所有 Edge 私有云版本说明的链接，请参阅 Apigee 版本说明。
注意：您只需安装补丁版本中包含的最新版本组件的 RPM，即可更新每个组件一次。按照相应版本的版本说明中的说明更新组件。
注意：升级组件会自动安装组件的最新补丁版本。如果您想升级到非最新的补丁版本，则需要使用 Apigee 镜像维护 Apigee 代码库的 tarball 副本，并使用此镜像进行 Apigee 安装。 如需了解详情，请参阅 使用本地 Edge 代码库来维护 Edge 版本。