4.17.05 - Edge for Private Cloud 版本说明

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

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

请参阅关于版本编号，了解如何确定您的 Edge for Private Cloud 版本是否包含特定的云版本。

版本概览

此版本包含多项有助于您更好地控制和保护 API 的重要功能，包括：

• 共享流程支持零停机时间部署。
• 现在支持删除组织的创收数据。
• 其他新功能如下所述。

在弃用方面，保险库已被弃用。

本主题的其余部分详细介绍了相应版本中包含的所有新功能、更新和 bug 修复。

弃用和停用

此版本中弃用或停用了以下功能。如需了解详情，请参阅 Edge 弃用政策。

已弃用：在“API 代理性能”标签页上添加路径

在此版本发布之前，您可以在管理界面中前往某个 API 代理，然后前往“性能”标签页，并在该代理的“性能”标签页和“业务交易”信息中心内创建不同的路径，以便进行基于图表的比较。此功能现已停用，不再在界面中提供。如需了解此功能的替代方案，请参阅以下 Apigee 社区文章：Business Transactions API 的替代方案。 (EDGEUI-902)

已弃用： 开发者服务门户的 buildInfo 网址

在之前的门户版本中，如需确定门户版本，您需要在浏览器中打开以下网址：

http://yourportal.com/buildInfo

在 4.17.05 中，此链接已被移除。如需确定版本，请在 Drupal 中打开报告 > 状态报告菜单条目。门户版本会显示在名为安装配置文件的行中的表格中。

Apigee 安全存储区（保险库）已弃用

Apigee 安全存储区（也称为“保险库”）即将被弃用，并将在“弃用和停用”页面上显示的弃用公告日期起一年后停用。保险库提供键值对的加密存储，可通过管理 API 创建，并在运行时通过 apigee-access Node.js 模块中的函数进行访问。

请勿使用安全存储区，而应使用加密的键值对映射 (KVM)，如使用键值对映射中所述。 加密的 KVM 与保险库一样安全，并且在创建和检索方面提供了更多选项。(MGMT-3848)

新功能和更新

以下是此版本中的新功能和增强功能。除了以下增强功能之外，此版本还包含多项可用性、性能、安全性和稳定性增强功能。

私有云

向安装添加了新的必需 SMTP 配置参数

您现在必须在 Edge 安装配置文件中使用 SMTPMAILFROM 参数。此参数用于指定 Edge 在发送自动电子邮件时使用的电子邮件地址，例如在用户请求重置密码时。如需了解详情，请参阅在节点上安装 Edge 组件。

(EDGEUI-1020)

现在可以设置 Edge 界面用于 Edge API 管理调用的超时时间

您现在可以指定 Edge 界面使用的 API 超时时长，以控制界面等待 API 管理调用返回的时间。以下属性用于定义超时时间：

• conf_apigee_apigee.feature.apitimeout 设置了界面等待后端调用返回的时间（以秒为单位），无论界面上是否有任何活动。如果调用未在该时间内完成，界面会抛出超时错误。默认值为 180 秒（3 分钟）。
• conf_apigee_play.ws.timeout.idle 设置了界面等待服务器上活动的时长（以毫秒为单位）。它可以设置为与 conf_apigee_apigee_apitimeout 相同的值，也可以设置为较小的值。将其设置为更大的值没有任何效果。默认值为 180000 毫秒（3 分钟）。
• conf_apigee_play.ws.timeout.connection 设置了界面等待建立连接的时间。它可以设置为与 conf_apigee_apigee_apitimeout 相同的值，也可以设置为较小的值。将其设置为更大的值没有任何效果。默认值为 120000 毫秒（2 分钟）。

如需了解详情，请参阅设置 Edge 界面用于 Edge API 管理调用的超时时间。

(EDGEUI-816)

向路由器添加了消息处理器重试超时

添加了超时时间，以便路由器停止向消息处理器重试请求并返回错误消息。

如需了解详情，请参阅配置路由器以重试与消息处理器的连接。

(APIRT-2912)

添加了更改默认系统管理员的步骤

现在，文档中已包含用于更改默认系统管理员的说明。

如需了解详情，请参阅管理用户、角色和权限。

(DOS-4895)

添加了有关在 root 用户和非 root 用户之间分离 Edge 安装任务的文档

新文档介绍了在根用户和非根用户之间分离 Edge 安装任务的步骤。

如需了解详情，请参阅 Edge 安装概览。

(DOS-4573)

添加了用于设置所生成电子邮件中链接的主机名的属性

Edge 会自动发送电子邮件来响应某些事件，例如当用户被添加到组织时。其中许多电子邮件都包含链接。例如，当新用户添加到组织后，Edge 界面会向该用户发送一封电子邮件，其中包含一个登录网址，格式如下：

https://domain/login

网域由 Edge 自动确定，通常对组织来说是正确的。 不过，如果 Edge 界面位于负载平衡器后面，自动生成的域名可能会不正确。如果是，您可以使用 conf_apigee_apigee.emails.hosturl 属性来明确设置生成的网址的域名部分。

如需了解详情，请参阅为生成的电子邮件中的链接设置主机名。

(EDGEUI-1044)

设置 Edge 界面为 API 代理显示的基准网址

Edge 界面会根据与代理部署位置对应的虚拟主机中的设置显示 API 代理的网址。此显示内容可以包括虚拟主机的路由器端口号。

在大多数情况下，Edge 界面中显示的网址是向代理发出外部请求的正确网址。不过，对于某些配置，显示的网址并不正确。 例如，以下任一配置都可能导致显示的网址与用于向代理发出外部请求的实际网址不对应：

• SSL 终止发生在负载平衡器上
• 端口映射发生在负载平衡器和 Apigee 路由器之间
• 配置了路径重写的负载平衡器

Edge for Private Cloud 4.17.05 及更高版本支持虚拟主机上的一个名为 <BaseUrl> 的属性，该属性可让您替换 Edge 界面显示的网址。以下示例展示了具有新 <Base网址> 属性的虚拟主机对象。在此示例中，Edge 界面中显示的值为“http://myCo.com”：

<VirtualHost name="myVHost">
   <HostAliases>
     <HostAlias>DNS_name_or_IP:9005</HostAlias>
   </HostAliases>
   <BaseUrl>http://myCo.com</BaseUrl>
   <Interfaces/>
   <Port>9005</Port>
</VirtualHost>

如果未设置 <BaseUrl>（默认设置），则 Edge 界面呈现的默认网址将显示为“http://DNS_name_or_IP:9005/”，而实际主机别名设置为“http://myCo.com”。

您还可以使用 apigee-provision 实用程序通过 VHOST_BASE网址 属性在创建组织时设置基本网址。

如需了解详情，请参阅为私有云配置对 API 的 TLS 访问权限。

(EDGEUI-5008)

添加了有关启用调试日志记录的文档

添加了文档，用于说明如何为 Edge 组件启用/停用调试日志记录。

如需了解详情，请参阅启用调试日志记录。

(APIRT-4018)

apigee-analytics-collector 实用程序的新安装程序和命令语法

所有 Edge for Private Cloud 客户都必须使用 apigee-analytics-collector 命令行实用程序的 Beta 版向 Apigee 提交有关 API 代理流量的统计信息。此实用程序会将 API 调用量报告发送回 Apigee。

此版本的 Edge 包含 apigee-analytics-collector 实用程序的新安装说明和命令语法。在此版本中，您现在可以使用 apigee-service 安装 apigee-analytics-collector 实用程序，而不是使用 npm，并通过 apigee-service 调用 apigee-analytics-collector 实用程序，而不是将其作为独立命令调用。

如需了解详情，请参阅将 API 流量数据上传到 Apigee - Beta 版。

在从新的 4.17.01 安装更新 Nginx/Postgres 的 Developer Services 门户后，新的默认安装目录

更新使用 Nginx/Postgres 的 4.17.01 新安装后，根目录从以下位置更改为：

/opt/apigee/apigee-drupal

更改为：

/opt/apigee/apigee-drupal/wwwroot

API 服务

针对实体的输入验证更加严格

在 Apigee Edge 组织的所有实体中强制执行更严格的输入验证。 允许使用的字符通常是字母（所有大小写）、数字和下划线。

受影响的实体包括：

• 组织
• 环境
• API 代理
• API 代理修订版本
• API 代理中的政策名称
• 调试跟踪记录遮盖配置 ID
• 资源名称（Java 调用、xsl、所有资源）
• 密钥库
• CRLstores
• 资源引用
• 目标服务器

(MGMT-3840)

共享流零停机时间部署

如果您想部署共享流，并确保在部署期间拒绝的传入流量很少或没有，现在可以使用零停机时间部署管理 API。此过程与使用管理 API 为 API 代理进行零停机时间部署的过程几乎完全相同。唯一的区别在于管理 API 资源。

以下调用会部署 URI 中指示的共享流修订版本，然后取消部署之前部署的修订版本（override=true 查询参数可实现此目的）：

curl -X POST -H "Content-type:application/x-www-form-urlencoded" \
https://api.enterprise.apigee.com/v1/o/{org_name}/environments/{env-name}/sharedflows/{shared_flow_name}/revisions/{revision_number}/deployments?"override=true" \
-u email:password

(MGMT-3485)

创收

删除组织的创收数据

在以下情况下，您可能需要删除组织的创收数据：

• 删除组织。在这种情况下，您必须先删除创收数据，然后才能删除组织。
• 从您想要重复使用的测试组织中清除创收数据。在这种情况下，您必须在删除创收数据后同步 Apigee Edge 数据。

如需了解详情，请参阅从组织中删除创收数据。(DEVRT-2581)

添加了用于为组织启用创收功能的 API

您现在可以使用 API 为组织启用创收功能。

如需了解详情，请参阅为组织启用创收功能。

(DEVRT-2383)

已修复 Bug

此版本中修复了以下 Bug。此列表主要供用户检查其支持服务工单中的问题是否已修复，并非旨在为所有用户提供详细信息。

Private Cloud 4.17.05

Cloud 17.04.12（界面）

Cloud 17.04.05（界面）

Cloud 17.03.29（界面）

Cloud 17.03.15.01（界面）

Cloud 17.03.15（界面）

Cloud 17.03.13.02（创收）

Cloud 17.03.13.01（创收）

Cloud 17.03.13 (API 管理)

Cloud 17.03.1（界面）

Cloud 17.02.15（界面）

Cloud 17.02.13（API 运行时）

Cloud 17.02.13（API 管理）

Cloud 17.01.18（界面）

Cloud 17.01.16（API 管理）

Cloud 17.01.16（创收）