4.16.01 - Edge for Private Cloud 版本说明

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

2016 年 3 月 24 日（星期四），我们发布了适用于私有云的新版 Apigee Edge。

自上一个适用于私有云的 Edge 季度版本 (4.15.07.00) 以来，以下 已发布并包含在此功能版本中：

• Cloud：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

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

弃用

私有云 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 下，也可以位于 。

新的虚拟主机要求

边缘迁移脚本可处理迁移现有 Netty Router 路由器所需的大多数任务 Nginx不过，在升级过程中，您还必须确保所有虚拟主机 定义包含主机别名。

请参阅 Apigee FTP 提供的 Edge 安装指南 网站：ftp://ftp.apigee.com/。 为现有虚拟主机添加主机别名以获取更多网络地址。

包含配置的代码

在 Edge 4.16.01 版中，您不再使用 /&lt;install-dir&gt;/apigee4/conf 目录下的 .properties 文件 来配置 Edge 组件。从 4.16.01 开始，您仍然可以使用 .properties 文件，但它们现在位于以下目录中：

/opt/apigee/customer/application

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

与先前版本的 Edge 不同，Edge 4 .16.01 的.properties 文件不包含全部 组件的属性此版本的其中一项更改是 .properties 文件 仅包含对默认属性值的覆盖。

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

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

如需了解详情，请参阅 Apigee FTP 网站上提供的 Apigee Edge 操作指南： ftp://ftp.apigee.com/.

Edge 配置脚本已替换

您在之前的 Edge 版本中使用的配置脚本已被移除， 替换为：

• 通过 Apigee 实用程序运行的命令，如 apigee-service、apigee-all apigee-setup、apiee-provision 或 apigee-migrate 实用程序。
  例如，all-start.sh 和 all-stop.sh 脚本已替换为以下内容 命令：
  &gt; /opt/apigee/apigee-service/bin/apigee-all start
  &gt;/opt/apigee/apigee-service/bin/apigee-all stop
• 您直接在 Edge 组件上运行的命令。例如，在之前的版本中 您使用了用于更改 OpenLDAP 密码的 chpasswd-openldap.sh 脚本。该脚本包含 已替换为您在 apigee-openldap 组件上运行的以下命令：
  &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-openldap change-ldap-password -o 旧 Pword -n newPword

请参阅 Apigee Edge 操作指南（位于 Apigee FTP 中） 网站：ftp://ftp.apigee.com/。 执行配置。

新的边缘路由器

此版 Edge for the Private Cloud 包含基于 Nginx 路由器。Nginx 路由器取代了 4.16.01.

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

请参阅“边缘安装”部分中的“附录 A：关于 Nginx 路由器” 此指南 可在 Apigee FTP 网站 ftp://ftp.apigee.com/ 获得，

移除了 BaaS 负载平衡器

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

您也可以使用轮循 DNS 来替代负载平衡器。在这种情况下 创建一个 DNS 条目，其中包含多条与 BaaS 栈 IP 地址对应的 A 记录。DNS 期间 DNS 服务器会自动以轮循方式返回 A 记录值。

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

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

已移除组织工具

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

如何在 4.16.01 中执行任务

下表显示了 4.15.07.03 中的任务执行方式以及目前的执行方式 。如需了解详情，请参阅 Apigee FTP 网站上提供的 Edge 运维指南： ftp://ftp.apigee.com/.

Alpha 版 监控工具和信息中心

此版本包含 Alpha 版的新监控工具和信息中心， Edge。通过此工具，您可以了解各种组件（路由器、 处理器、ZooKeeper、Cassandra）以及适用于各种组织和环境的 http 错误代码 。您还可以截取信息中心数据的快照，并将其分享给 Apigee 帮您解决支持突发事件。

Edge 的 ZIP 文件中包含相关文档（包括安装说明）， Apigee FTP 网站上提供的 4.16.01 文档：ftp://ftp.apigee.com/。

但是，您必须先完成 Apigee 评估，然后才能安装和使用信息中心 同意包含在文档 ZIP 文件中，然后通过电子邮件将其发送到 orders@apigee.com，以将其返回给 Apigee。

边缘平台

管理界面样式 (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 创建 API 代理， (Swagger) 文档。在 API 代理向导的第一页上，点击使用 OpenAPI（在选择反向代理时选择）Node.js 应用或无目标。在显示的字段中，输入 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 调用程序、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 代理 配置参考文档
• <ph type="x-smartling-placeholder"></ph> https://community.apigee.com/articles/21424/dynamic-sslinfo-for-targetendpoint-using-variable.html

(APIRT-1475)

SAML 断言策略的 RSA_SHA256 算法支持 (Cloud 16.01.20)

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

对证书上传进行验证 (Cloud 16.01.20)

为了防止将过期或无效证书上传到密钥库和信任库， Management 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 默认会删除 X-Forwarded-For HTTP 请求 包含一个或多个 IP 地址的标头。新的默认行为意味着客户端 IP 地址 Edge 接收的地址将是它从上一个外部 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)

API >通过管理界面中的“环境配置”页面，您现在可以 删除目标服务器。

此外，该页面已经过重新设计，因此可以创建、添加和缓存 而不是转至新页面。一些缓存属性，包括 Element in Memory”，界面将不再提供“Elements in Memory”，因为设置这些属性不再 对运行时缓存行为的任何影响。(MGMT-280)

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

消息日志记录政策支持将 syslog 发送给第三方日志管理提供程序 安全协议。在政策配置中使用以下内容作为父级的直接子级 元素：

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

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

管理界面 (Cloud 15.07.22)

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

Trace 中的 c网址 (Cloud 15.09.02)

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

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

使用数据遮盖来遮盖 JSON 载荷中的敏感数据时，可使用 $、 * 和 { 现在可以遮盖。(APIRT-1727)

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

您现在可以在 Edge 管理功能中创建和管理环境范围的键值对映射 (KVM) 界面。环境级 KVM 包含键/值对，可供 例如测试或生产环境在管理界面菜单中，转到 API > 环境配置 >选择所需的环境 >键值对映射 标签页。有关详情，请参阅创建和修改 环境键值对映射。（MGMT-1393）

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

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

开发者服务

API 产品页面性能，未列出开发者应用 (Cloud 16.01.20)

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

“Developer Apps”页面上的“Key”列 (Cloud 15.08.05)

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

“开发者详细信息”页面的进度旋转图标 (Cloud 15.09.30)

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

创收

修改 API 软件包名称 (Cloud 16.01.20)

在创收生命周期内，您可以随时更新 API 软件包的名称，即使 当 API 套餐包含已发布的费率方案时。（DEVRT-2177）

自定义属性中允许使用小数 (Cloud 16.01.20)

使用“包含自定义属性的价目表”时消息中的自定义属性 用作交易乘数的标头现在可以是小数值（最高 4） 小数点。如需详细了解此类方案，请参阅 指定 价目表自定义属性详细信息 (DEVRT-2191)。

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

使用 Management API 生成收入摘要报告时，您可以添加“费率方案”名称 并为“方案 ID”评分列。为此，请添加“RATEPLAN”作为 groupBy 属性 创建 API 调用，如创建 报告。（请注意，创收报告界面中尚未提供此功能。）在 现有费率方案的名称和 ID 列现在位于 以及其他分组列（DEVRT-1740）

Google Analytics 服务

针对响应时间指标求和( ) 函数 (Cloud 16.01.20)

在 Google Analytics 自定义报告和 API 调用中，“总和”聚合函数现在可用于 目标响应时间、总响应时间和 end_point_response_time。例如，在 /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)

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

改进了管理界面中自定义报告页面上的日期/时间选择器微件。 (MGMT-2881)

GeoMap 上的城市展开细目 (Cloud 15.07.22)

分析 GeoMap 包含“城市”美国和加拿大的数据展开细目。当您 在地图上点击某个州或省/直辖市/自治区，系统将显示发起来电的城市列表。 (MGMT-2282)

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

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

“代理路径后缀”维度 (Cloud 15.09.30)

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

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

使用返回开发者的 /stats API 进行 Edge Analytics API 调用时， 开发者显示名称将与开发者 ID 一起返回。以前，只有开发者 ID 返回。（AXAPP-1759）

已修复 Bug

此版本中修复了以下 bug。

私有云 4.16.01

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

Google Cloud 16.01.20

Google Cloud 15.07.08

Google Cloud 15.07.22

Google Cloud 15.08.05

Google Cloud 15.09.02

Google Cloud 15.09.30

私有云 4.15.07.03

私有云 4.15.07.01

已知问题

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

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