4.17.05 - Edge for Private Cloud 版本说明

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

自上一个 Edge for Private Cloud 功能版本以来，以下版本 已出现，并已包含在此功能版本中：

请参阅关于版本 通过编号来判断特定 Cloud 版本是否 包含在适用于私有云的 Edge 版本中。

版本概览

此版本包含一些值得注意的功能，可帮助您更好地控制 API，包括：

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

在弃用方面，保险柜已弃用。

本主题的其余部分包含有关所有新功能、更新和问题修复的详细信息 。

弃用和停用

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

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

在此版本之前，您可以在管理界面中前往 API 代理， 效果 标签，并创建不同的路径，以便对代理的 “效果”标签页和“业务交易”信息中心内。此功能现已弃用， 界面中的“延续”部分如需了解此功能的替代方案，请参阅以下 Apigee 社区文章：https://community.apigee.com/articles/23936/alternative-to-business-transactions-api.html。 (EDGEUI-902)

退休人员： 开发者服务门户的 buildInfo 网址

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

http://yourportal.com/buildInfo

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

弃用 Apigee 安全存储（保险柜）

Apigee 的 也称为“保险柜”弃用并停用 弃用公告日期显示在 弃用和 弃用页面。创建提供键值对加密存储的保险柜 使用 Management API，并在运行时使用 apigee-access 中的函数访问 Node.js 模块。

不使用安全存储空间，而是使用加密的键值映射 (KVM)，如 使用键值对映射。 加密的 KVM 与保险柜一样安全， 检索。(MGMT-3848)

新功能和更新

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

私有云

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

现在，您必须使用 Edge 安装配置文件。此参数用于指定 在 Edge 自动发送电子邮件时使用，例如当用户请求重置密码时。请参阅 在 node。

(EDGEUI-1020)

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

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

• conf_apigee_apigee.feature.apitimeout 集 界面等待对后端的调用返回的时间（以秒为单位）， 活动如果在此期间调用没有完成，界面会抛出超时错误。通过 默认值为 180 秒（3 分钟）。
• conf_apigee_play.ws.timeout.idle 会设置 界面在服务器上等待 activity 的时间（以毫秒为单位）。它可以设置为与之前相同的值 作为 conf_apigee_apigee_apitimeout 或 一个较小的值。将其设置为更大的值不会产生任何影响。默认值为 180,000 毫秒（3 分钟）。
• conf_apigee_play.ws.timeout.connection 集 界面等待连接建立的时间它可以设置为与之前相同的值 作为 conf_apigee_apigee_apitimeout 或 一个较小的值。将其设置为更大的值不会产生任何影响。默认值为 120000 毫秒（2 分钟）。

请参阅设置超时时间 。。

(EDGEUI-816)

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

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

请参见配置 以重试与消息处理器的连接以获取更多信息。

(APIRT-2912)

添加了更改默认系统管理员的过程

我们现在附上了更改默认系统管理员的文档。

请参阅管理 用户、角色和权限。

(DOS-4895)

添加了关于如何在根用户和非根用户之间分离 Edge 安装任务的文档

新文档介绍了将 Edge 安装任务在 Root 和 非根用户。

请参阅边缘安装 概览了解详情。

(DOS-4573)

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

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

https://domain/login

网域由 Edge 自动确定，通常适合组织。 但是，如果 Edge 界面位于负载平衡器后面，那么自动 生成的域名不正确。如果是这样，您可以使用 conf_apigee_apigee.emails.hosturl 属性 明确设置所生成网址的域名部分。

请参阅将 主机名。

(EDGEUI-1044)

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

Edge 界面根据虚拟主机中的设置显示 API 代理的网址 与部署代理的位置相对应。此显示屏可能包含 虚拟主机。

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

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

适用于私有云 4.17.05 及更高版本的 Edge 支持虚拟主机上名为 &lt;BaseUrl&gt; 中， 替换 Edge 界面显示的网址。下面是一个使用 新的 &lt;BaseURL&gt; 属性。在此示例中，值“http://myCo.com”在 Edge 界面中显示：

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

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

您还可以在创建组织时使用 VHOST_BASEURL 属性 apigee-provision 实用程序。

请参阅配置 TLS 访问适用于私有云的 API。

(EDGEUI-5008)

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

添加了介绍如何为 Edge 启用/停用调试日志记录的文档 组件。

请参阅启用调试日志记录 。

(APIRT-4018)

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

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

此版本的 Edge 包含适用于 apigee-analytics-collector 实用程序。在这个版本中，您现在可以使用 apigee-service 安装 apigee-analytics-collector 实用程序， 而不是 npm，并调用 apigee-analytics-collector 实用程序 apigee-service，而不是通过 独立的命令

请参阅上传 API “流量数据到 Apigee - Beta 版”了解详情。

开发者服务门户更新后新建默认安装目录 从全新 4.17.01 安装的 Nginx/Postgres

更新使用 Nginx/Postgres 的新安装 4.17.01 后，根目录 从：

/opt/apigee/apigee-drupal

to:

/opt/apigee/apigee-drupal/wwwroot

API 服务

对实体进行更严格的输入验证

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

受影响的实体包括：

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

(MGMT-3840)

共享流零停机部署

当您要部署共享流，并确保很少或根本没有传入流量时被拒绝 您现在可以使用零停机的 Deployment Management API。流程如下： 与使用 Management 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。此列表主要供用户检查其支持服务工单中的问题是否已修复，并非旨在为所有用户提供详细信息。

私有云 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（创收）