4.16.01 - Edge for Private Cloud 版本说明

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

2016 年 3 月 24 日（星期四），我们发布了新版 Apigee Edge for Private Cloud。

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

• 云：15.07.08、15.07.22、15.08.05、Nginx 迁移、15.09.02、15.09.30、16.01.20
• Private Cloud：4.15.07.01、4.15.07.03

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

弃用

Private Cloud 4.15.07.03

curl http:// <qpid_IP>:8083/v1/servers/self/queues

Google Analytics：多个报告的自定义报告信息中心视图（Cloud 15.09.30）

提供最多四个自定义报告视图的特定自定义报告信息中心功能即将被弃用，并将在未来的版本中移除。(MGMT-2673)。自定义报告的所有其他方面仍将可用。

无法在 Private Cloud 中替换组织名称长度

您无法再通过设置以下内容来覆盖组织名称长度不得超过 20 个字符的限制：

• APIGEE_ORG_NAME_LENGTH=25

• APIGEE_ENV_NAME_LENGTH=25

新功能和增强功能

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

私有云

新增了对 RedHat、CentOS 和 Oracle 6.7 - 7.2 的支持

此版本增加了对 RedHat Enterprise Linux、CentOS 和 Oracle Linux 版本 6.7 至 7.2 的支持。

如需查看完整的系统要求列表，请参阅支持的软件和支持的版本。

基于 RPM 的安装

此版本的 Edge 使用基于 RPM 的安装机制，可大大简化安装和迁移过程。

新基本目录

Edge 4.16.01 版的目录结构已更改。在以前的 Edge 版本中，您将 Edge 安装到基本目录中：

/<install-dir>/apigee4

其中，install-dir 可以位于任何位置，默认值为 /opt。例如：

/opt/apigee4

对于版本 4.16.01，您必须将 Edge 安装到以下目录中：

/opt/apigee

另请注意，apigee4 目录已更改为 apigee。

数据目录的位置不受影响。它可能位于 /opt/apigee 下，也可能位于其他位置。

新的虚拟主机要求

Edge 迁移脚本可处理将现有 Netty 路由器迁移到 Nginx 所需的大部分任务。不过，在升级过程中，您还必须确保所有虚拟主机定义都包含主机别名，然后才能进行迁移。

如需详细了解如何向现有虚拟主机添加主机别名，请参阅 Edge 安装指南 （可在 Apigee FTP 网站 ftp://ftp.apigee.com/ 上找到）。

使用配置进行编码

在 Edge 版本 4.16.01 中，您不再使用 /<install-dir>/apigee4/conf 目录下的 .properties 文件来配置 Edge 组件。自 4.16.01 版起，您仍然可以使用 .properties 文件配置 Edge 组件，但这些文件现在位于以下目录中：

/opt/apigee/customer/application

对于安装在节点上的每个 Edge 组件，该目录中都会有一个 .properties 文件。如需配置组件，请修改相应的 .properties 文件，以更改现有属性的值或添加新属性和值。如果该文件尚不存在，您可以创建它。

与之前的 Edge 版本不同，Edge 4.16.01 的 .properties 文件不包含组件的所有属性。此版本的一项更改是，.properties 文件仅包含对默认属性值的替换。

此架构的优势在于，在迁移到更高版本的 Edge 时，Edge 安装程序永远不会覆盖 /opt/apigee/customer/application 中的文件。这样可以避免 Edge 意外覆盖您的设置。

在迁移时，Edge 安装程序会检查现有的 .properties 文件，并将对默认属性值的更改复制到 /opt/apigee/token 目录。因此，迁移后您应该无需进行任何修改。

如需了解详情，请参阅 Apigee Edge 操作指南，该指南可在 Apigee FTP 站点上找到：ftp://ftp.apigee.com/。

边缘配置脚本已替换

您在之前版本的 Edge 中使用的配置脚本已被移除，并替换为以下任一选项：

• 通过 Apigee 实用程序（例如 apigee-service、apigee-all、apigee-setup、apiee-provision 或 apigee-migrate 实用程序）运行的命令。
  例如，all-start.sh 和 all-stop.sh 脚本已替换为以下命令：
  > /opt/apigee/apigee-service/bin/apigee-all start
  > /opt/apigee/apigee-service/bin/apigee-all stop
• 直接在 Edge 组件上运行的命令。例如，在之前的版本中，您使用 chpasswd-openldap.sh 脚本来更改 OpenLDAP 密码。该脚本已被以下命令取代，您可以在 apigee-openldap 组件上运行该命令：
  > /opt/apigee/apigee-service/bin/apigee-service apigee-openldap change-ldap-password -o oldPword -n newPword

如需详细了解如何通过命令执行配置，请参阅 Apigee Edge 操作指南（可在 Apigee FTP 网站上找到：ftp://ftp.apigee.com/）。

新边缘路由器

此版本的 Edge for Private Cloud 包含基于 Nginx 路由器的新路由器架构。Nginx 路由器取代了 4.16.01 之前 Edge 版本中使用的 Netty 路由器。

Nginx 路由器的硬件和端口要求与 Netty 路由器相同，因此无需对现有节点进行任何更改。

如需了解详情，请参阅 Edge 安装指南 中的附录 A：关于 Nginx 路由器，该指南可在 Apigee FTP 站点上找到：ftp://ftp.apigee.com/，

已移除 BaaS 负载平衡器

已从 API BaaS 门户中移除内部负载平衡器。现在，您必须在 API BaaS 门户和三个 API BaaS 堆栈节点之间使用自己的负载平衡器。

作为负载平衡器的替代方案，您可以使用轮询 DNS。在此方案中，您将创建一个包含多个与 BaaS 堆栈 IP 地址对应的 A 记录的 DNS 条目。在 DNS 查找期间，DNS 服务器会自动以轮询方式返回 A 记录值。

新文档，介绍了如何添加 Cassandra 和 ZooKeeper 节点，以及如何向现有数据中心添加数据中心

Apigee FTP 站点上的文档 ZIP 文件现在包含“Scaling Edge for Private Cloud”，其中介绍了如何添加 Cassandra 和 ZooKeeper 节点，以及如何向现有数据中心添加数据中心。

已移除 Orgtool

orgtool 可以查询 Edge 安装，以获取组织的相关信息。该工具现已移除。现在，您可以使用 Edge 界面或 API 调用来获取组织的相关信息。

如何在 4.16.01 中执行任务

下表显示了您在 4.15.07.03 中执行任务的方式，以及现在在 4.16.01 中执行任务的方式。如需了解详情，请参阅 Edge 操作指南，该指南可在 Apigee FTP 站点上找到：ftp://ftp.apigee.com/。

监控工具和信息中心的 Alpha 版

此版本包含 Edge 的新监控工具和信息中心的 Alpha 版。借助此工具，您可以了解部署中各个组件（路由器、消息处理器、ZooKeeper、Cassandra）的运行状况，以及各个组织和环境的 HTTP 错误代码。您还可以拍摄信息中心数据的快照，并与 Apigee 分享，以帮助解决支持突发事件。

该文档（包括安装说明）包含在 Apigee FTP 站点 (ftp://ftp.apigee.com/) 上提供的 Edge 4.16.01 文档的 ZIP 文件中。

不过，在安装和使用该信息中心之前，您必须填写文档 ZIP 文件中包含的 Apigee 评估协议，并通过电子邮件将其发送到 orders@apigee.com，以便将其返回给 Apigee。

Edge 平台

管理界面样式重设 (Cloud 15.09.30)

管理界面中的多个页面已更新外观。(MGMT-2627)

API 服务

重新设计了 API 代理向导 (Cloud 16.01.20)

API 代理向导已重新设计。当您在管理界面中的“API 代理”页面上点击“+ API 代理”时，新向导会引导您完成 API 代理创建流程。所有设置都与之前的 API 代理向导相同。(MGMT-1376)

使用 OpenAPI (Swagger) 文档创建 API 代理 (Cloud 16.01.20)

作为新的 API 代理向导重新设计的一部分，您现在可以根据 OpenAPI (Swagger) 文档创建 API 代理。在 API 代理向导的第一页上，选择反向代理、Node.js 应用或无目标时，点击使用 OpenAPI。在显示的字段中，输入 OpenAPI 文档的网址。如需了解详情，请参阅构建简单的 API 代理。 (MGMT-1376)

针对 SOAP 代理的 WSDL 1.2 支持（Cloud 16.01.20）

Apigee Edge 支持使用 WSDL 1.2 创建 API 代理来调用 SOAP 服务。(MGMT-2835)

TargetEndpoint 配置中的 SSLInfo 变量 (Cloud 16.01.20)

在 API 代理 TargetEndpoint 中，您可以动态设置 SSL/TLS 详细信息以支持灵活的运行时要求。以下示例演示如何在 TargetEndpoint 配置中设置 SSLInfo，例如，您可以通过 Java Callout、JavaScript 政策或“分配消息”政策在运行时提供这些值。使用包含要设置的值的任何消息变量。

<TargetEndpoint>
...
  <SSLInfo>
    <Enabled>{myvars.ssl.enabled}</Enabled>
    <ClientAuthEnabled>{myvars.ssl.client.auth.enabled}</ClientAuthEnabled>
    <KeyStore>{myvars.ssl.keystore}</KeyStore>
    <KeyAlias>{myvars.ssl.keyAlias}</KeyAlias>
    <TrustStore>{myvars.ssl.trustStore}</TrustStore>
  </SSLInfo>
...
</TargetEndpoint>

如需了解此功能，请参阅以下文档：

• API 代理配置参考文档
• 使用变量引用的 TargetEndpoint 的动态 SSLInfo

(APIRT-1475)

针对 SAML 断言政策的 RSA_SHA256 算法支持（Cloud 16.01.20）

SAML 断言政策现在除了支持 RSA_SHA1 算法之外，还支持 RSA_SHA256 算法。 (APIRT-1779)

验证证书上传（Cloud 16.01.20）

为了帮助防止将过期或无效的证书上传到密钥库和信任库，管理 API 会在上传时验证证书。系统会验证证书，以确保文件大小不超过 50KB，且格式为 PEM 或 DER。 系统还会验证证书是否过期。如需替换默认的过期验证（在上传时不对证书过期情况进行验证），请使用以下查询参数： ?ignoreExpiryValidation=true

如需了解详情，请参阅 将 JAR 文件上传到密钥库和 将证书上传到信任库。(SECENG-516) 和 (APIRT-2213)

Node.js 日志页面上的自动轮询 (Cloud 16.01.20)

在代理编辑器中查看 Node.js 日志时，Node.js 日志页面会自动定期刷新，以列出可用的新日志。点击“停止自动刷新”即可关闭自动刷新功能。(MGMT-1692)

X-Forwarded-For HTTP 标头（Cloud 15.09.30）

为了提高安全性，Edge 默认会剥离可能包含一个或多个 IP 地址的 X-Forwarded-For HTTP 请求标头。新的默认行为意味着 Edge 收到的客户端 IP 地址将是它从最后一次外部 TCP 握手收到的 IP 地址，而不是可能被欺骗以绕过访问控制政策的地址。

如需更改此默认行为并允许 X-Forwarded-For 地址访问您的 API 代理，您必须在组织中设置 feature.enableMultipleXForwardCheckForACL=true 属性。

JavaScript 对政策属性的访问权限（Cloud 15.07.08）

在 API 代理流中使用 JavaScript 时，您可以访问 JavaScript 政策中定义的属性。如果您想在 JavaScript 代码中使用知名变量，此功能会特别有用。例如，假设您的 JavaScript 政策包含以下属性定义：

<Properties>
    <Property name='source'>response.content</Property>
</Properties>

在 JavaScript 中，您可以使用对“source”属性的引用来访问消息响应，如下所示：
var source = properties.get('source'); // returns: response.content
或
var source = properties.source
或
var source = properties['source']

如需了解详情，请参阅 JavaScript 政策。(APIRT-1460)

组织级审核 (Cloud 15.07.08)

组织管理员可以审核组织级层采取的操作的历史记录。 在管理界面中，依次选择管理员 > 组织历史记录。如需了解详情，请参阅审核：API、产品和组织历史记录。(MGMT-2232)

组织管理员自行从角色中移除 (Cloud 15.07.08)

组织管理员可以在管理界面中依次前往管理 > 组织用户，然后点击自己姓名旁边的移除，从而移除自己的组织管理员角色。(MGMT-934)

API 代理软件包导入进度指示器 (Cloud 15.07.08)

在管理界面中上传大型 API 代理软件包时，系统会显示“正在处理”动画，以指示导入仍在进行中，这会阻止您与管理界面互动，直到导入完成。(MGMT-1285)

缓存行为和配置 (Cloud 15.07.22)

为了更好地管理和利用内存中缓存，自 Edge 云版本 15.06.10 起，环境缓存资源上的“内存中的最大元素数”设置已被弃用。在 Edge Cloud 版本 15.07.22 中，此设置已从 Apigee Edge 管理界面的“环境配置”部分的“创建缓存”界面中移除。

所有缓存资源（包括默认缓存）中存在的元素总数取决于分配给缓存的总内存。默认情况下，分配给给定消息处理器上内存中缓存的总内存是可用总内存的 40%。仅当缓存内存不足或元素过期时，元素才会从内存中缓存中逐出。（MGMT-2413、APIRT-1140）

管理界面中的目标服务器配置 (Cloud 15.07.22)

现在，您可以在管理界面的“APIs > Environment Configuration”（API > 环境配置）页面中添加、修改和删除目标服务器。

此外，我们还重新设计了该页面，以便用户可以直接在页面上创建、添加和删除缓存，而无需前往新页面。界面中不再显示多个缓存属性（包括“内存中的最大元素数”），因为设置这些属性不再对运行时缓存行为产生任何影响。(MGMT-280)

SSL，可将消息记录到 syslog (Cloud 15.07.22)

消息日志记录政策支持通过 SSL/TLS 将 syslog 发送到第三方日志管理提供商。在政策配置中，将以下内容用作父元素的直接子元素：

<SSLInfo>
    <Enabled>true</Enabled>
</SSLInfo>

如需了解详情，请参阅消息记录政策。 (APIRT-942)

管理界面 (Cloud 15.07.22)

Apigee 工程团队在管理界面中修复了各种小问题并提升了易用性。

Trace 中的 c网址（Cloud 15.09.02）

在跟踪向目标服务器发出请求的 API 代理调用时，您可以将向目标服务器发出的请求视为 c网址 命令。在“事务映射”图表中选择“请求已发送到目标服务器”阶段，然后点击“阶段详情”窗格中“请求已发送到目标服务器”列上的“显示 Curl”按钮。(MGMT-2589)

数据遮盖特殊字符 (Cloud 15.09.02)

使用数据遮盖功能遮盖 JSON 载荷中的敏感数据时，现在可以遮盖 $、* 和 { 等特殊字符。(APIRT-1727)

管理界面中的键值对映射 (Cloud 15.09.30)

您现在可以在 Edge 管理界面中创建和管理环境范围的键值对映射 (KVM)。环境范围的 KVM 包含任何 API 代理在环境（例如测试或生产）中都可以访问的键/值对。在管理界面菜单中，依次前往 API > 环境配置 > 选择所需环境 > 键值对映射标签页。如需了解详情，请参阅创建和修改环境键值映射。(MGMT-1393)

管理界面中的 PopulateCache 政策默认到期时间（Cloud 15.09.30）

使用 API 代理编辑器添加 PopulateCache 政策时，缓存过期时间的 <TimeoutInSec> 元素会预先填充一个值，即 3600 秒（1 小时）。之前的默认值为 300 秒（5 分钟）。(MGMT-2622)

开发者服务

API 产品页面性能，未列出任何开发者应用（Cloud 16.01.20）

在管理界面中查看 API 产品时，系统会列出与该产品关联的开发者应用。为提升界面性能，在修改 API 产品时，系统不会显示开发者应用列表。(MGMT-2869)

“开发者应用”页面上的关键列（Cloud 15.08.05）

在拥有大量（数千个）开发者应用的组织中，在“开发者应用”页面上显示“密钥”列（显示每个应用的密钥数量）可能会影响显示性能。为了在这种情况下提高显示性能，请与 Apigee 支持团队联系，以设置以下组织级属性：features.appsNoCredentialsEnabled = true。此属性会移除“键”列。不过请注意，移除“密钥”列也会移除按使用方密钥和密码进行搜索的功能。(MGMT-2486)

“开发者详细信息”页面上的进度微调器（Cloud 15.09.30）

当管理界面中加载“开发者详情”页面时，如果应用仍在加载，该页面的“应用”部分会显示一个进度旋转图标。这改进了之前的行为，即在加载应用时，“应用”部分显示为空。(MGMT-2667)

创收

修改 API 软件包名称（Cloud 16.01.20）

您可以在创收生命周期的任何时间更新 API 套餐的名称，即使 API 套餐包含已发布的费率方案也是如此。(DEVRT-2177)

自定义属性中允许使用的小数（Cloud 16.01.20）

使用“含自定义属性的价目表”方案时，消息标头中用作交易乘数的自定义属性现在可以是最多包含四位小数的十进制值。如需详细了解此类方案，请参阅指定费率卡自定义属性详情 (DEVRT-2191)。

摘要报告中的费率方案名称和 ID (Cloud 15.09.02)

使用 Management API 生成收入摘要报告时，您可以向报告中添加“费率方案”名称和费率“方案 ID”列。为此，请按照创建报告中所述，在 API 调用中添加“RATEPLAN”作为 groupBy 属性。（请注意，此功能尚未在创收报告界面中提供。）在详细报告中，现有的费率方案名称和 ID 列现在位于报告的前面，与其他分组列一起显示。(DEVRT-1740)

分析服务

对响应时间指标使用 sum() 函数（Cloud 16.01.20）

在分析自定义报告和 API 调用中，现在可以对“目标响应时间”“总响应时间”和“end_point_response_time”使用“sum”汇总函数。例如，在 /stats API (http://docs.apigee.com/management/apis/get/organizations/%7Borg_name%7D/environments/%7Benv_name%7D/stats/%7Bdimension_name%7D-0) 中，您现在可以使用以下“select”查询参数：?select=sum(total_response_time)。 (AXAPP-2006)

延迟时间分析报告：已排序的 API 代理名称 (Cloud 16.01.20)

在延迟时间分析报告界面（仅限 Apigee Edge 企业版方案）中，API 代理按字母顺序列在“代理”下拉列表中。(MGMT-2858)

信息中心内开发者应用的显示名称（Cloud 16.01.20）

在管理界面信息中心内，“开发者应用”条形图会按显示名称（而非内部名称）列出开发者应用。(MGMT-2853)

自定义报告中的新日期/时间微件 (Cloud 16.01.20)

管理界面中自定义报告页面上的日期/时间选择器 widget 已得到增强。 (MGMT-2881)

地理位置地图上的城市下钻（Cloud 15.07.22）

Google Analytics 地理位置分布图包含美国和加拿大的“城市”展开细目。当您点击地图上的某个州或省份时，系统会显示通话发起地点的城市列表。 (MGMT-2282)

Google Analytics 自定义报告中的竖线 (|) 和等号 (=) 字符 (Cloud 15.09.02)

Google Analytics 自定义报告定义支持使用 |（竖线）和 = 符号。在此之前，需要对这些符号使用 %7C 和 %3D 编码。(MGMT-2504)

“代理路径后缀”维度（Cloud 15.09.30）

分析自定义报告和 API 调用中新增了“代理路径后缀”(proxy_pathsuffix) 维度。代理路径后缀是 API 代理网址中位于基本路径后面的部分，例如为条件流创建的路径。(AXAPP-1902)

报告显示开发者 ID，而非显示名称 (Cloud 15.09.30)

使用返回开发者的 /stats API 进行 Edge Analytics API 调用时，系统会返回开发者显示名称以及开发者 ID。之前，仅返回开发者 ID。(AXAPP-1759)

已修复 Bug

此版本中修复了以下 bug。

Private Cloud 4.16.01

下表列出了自 Edge for Private Cloud 4.16.01 版发布以来修复的 bug。如需获取这些修复，请按照将 Apigee Edge 4.16.01.x 更新到最新的 4.16.01 版本中所述的说明，将 4.16.01 安装更新到最新的 RPM 和支持文件。

Cloud 16.01.20

Cloud 15.07.08

Cloud 15.07.22

Cloud 15.08.05

Cloud 15.09.02

Cloud 15.09.30

Private Cloud 4.15.07.03

Private Cloud 4.15.07.01

已知问题

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

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart