4.16.05 - Edge for Private Cloud 版本说明

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

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

<ph type="x-smartling-placeholder">

自上一个 Edge for Private Cloud 功能版本 (4.16.01) 以来，以下版本 已包含在以下功能版本中：

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

新功能和增强功能

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

如需更多详细信息和说明，请参阅“适用于私有云的 Edge”文档。

安装和 操作指南已移到线上

您现在可以访问 4.18.01 版的 Edge for Private Cloud 安装和操作指南。

软件更新

该版本中包含以下软件更新：

  • Java JDK 1.8 - 为了利用最新的 Java 功能，此 版本与 Java 1.8 兼容。中需要 Oracle JDK 1.8 或 OpenJDK 8 您的环境
    在更新到 Java 8 的过程中，Oracle JDK 1.8 中不再提供某些 TLS 加密。 如需完整列表，请参阅“默认停用的加密套件”部分http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.
  • Cassandra 2.1.13 - 从 Cassandra 2.0.15 更新。

安装、升级、 回滚

以下是对安装、升级和相关脚本的更改。相关信息 请参阅“适用于私有云的 Edge”文档。

  • 从 4.16.01 更新的新流程 - 此版本取代了 将 apigee-migrate 实用程序与 update.sh 实用程序搭配使用，以更新您的 安装版本从 4.16.01 到 4.16.05。请参阅将 Apigee Edge 4.16.01 更新为 4.16.05.
  • 引导 <ph type="x-smartling-placeholder">
      </ph>
    • bootstrap.sh（4.16.01 版）现为 bootstrap_4.16.05.sh（在 4.16.05 中）。
    • 您无需再指定 uname:pword 即可下载 bootstrap_4.16.05.sh。
  • 回滚 - 要将更新回滚到 4.16.05，您需要卸载 4.16.05 版组件并重新安装之前的版本。上一个 移除了 rollback.sh 实用程序。请参阅 4.16.05 回滚流程。
  • setup.sh 和 update.sh 可将日志文件写入 /tmp - 默认情况下，setup.sh 和 update.sh 实用程序写入日志信息 发送至 /opt/apigee/var/log/apigee-setup。如果运行该实用程序的用户没有 有权访问该目录，它会将日志写入 /tmp 目录。 如果用户无权访问 /tmp，则实用程序将失败。
  • API BaaS 更新过程 - 在 4.16.01 版中，您必须 重新安装 API BaaS 以进行迁移。新的 update.sh 实用程序支持 更新 API BaaS。请参阅将 Apigee Edge 4.16.01 更新为 4.16.05.

管理

以下是 Private Cloud 管理和配置的新功能。

  • 安装验证 - apigee-validate 实用程序用于测试 Edge Private Cloud 现在可以从管理服务器运行安装。以前，需要运行脚本 消息处理器上请参阅测试 安装。
  • 区域名称 - 区域可以是任何名称。在之前的版本中，此名称为 格式为“dc-#”，其中 # 是一个整数值。
  • 网关 pod - 网关 pod 可以具有任何名称。在之前的版本中 必须将 Pod 命名为“gateway”
  • 基于脚本的管理 - A 新的 apigee-adminapi.sh 命令行实用程序可让你执行 通过调用 Edge Management API 执行的 Edge 配置任务。请参阅 使用 apigee-adminapi.sh 实用程序，
  • 虚拟主机 SSL 静默配置 - 创建组织或 环境中，您现在可以传递属性以在虚拟主机上配置 SSL。请参阅对组织进行初始配置。

API 服务

以下是 Edge API 服务的新功能，这些功能在之前的云中提供 不同版本。

syslog 消息日志记录的固定长度前缀 (Cloud 16.03.30)

消息日志记录政策在<FormatMessage> Syslog 配置修改者 设置 <FormatMessage>true</FormatMessage>，Syslog 消息 以固定数量的字符开头，这可以过滤掉 Apigee 插入的数据。有关 请参阅提示 日志记录政策。(APIRT-1398)

API 代理基本路径中的通配符（Cloud 16.03.09 界面）

管理界面支持在 API 代理中使用一个或多个 /*/ 通配符 基本路径例如，/team/*/members 的基本路径允许客户端调用 将代理设置为 https://[host]/team/blue/members 或 https://[host]/team/green/members，而无需创建新代理 为新团队提供支持。请注意，不允许使用 /**/。(MGMT-3154)

API 代理链（Cloud 16.03.02、Cloud 16.03.09 界面）

Edge 支持本地 API 代理链接，这允许一个 API 代理调用另一个 API 代理 部署在 Edge 组织中，而不会产生额外的网络开销。以前，API 代理 链接需要对另一个 API 代理进行 http(s) 调用，而该代理通过 负载平衡器、路由器和消息处理器

API 代理的 API 代理中提供了新的 LocalTargetConnection 元素 TargetEndpoint，可让您指定 API 代理名称，即特定 ProxyEndpoint 的名称 或简单地是本地 API 代理资源（例如 /v1/myresource）。在代理编辑器界面中添加或更新 TargetEndpoint。

服务调用程序政策也支持代理链。

如需了解详情，请参阅链接 API 代理 一起。XML 中也列出了新的 LocalTargetConnection 元素 示例架构：https://github.com/apigee/api-platform-samples/blob/master/schemas/configuration/configuration_schemas.xsd。 （MGMT-3049、MGMT-3050）

已修复 Bug

此版本中修复了以下 Bug。此列表主要供用户查看 看看他们的支持服务工单是否已解决。这些信息的目的不是提供 所有用户的信息。

适用于私有云 4.16.05 的 Edge

问题 ID 说明
PRC-770 16.01 安装程序无法在 轴组
PRC-758 拥有用户角色的用户能够修改自定义报告
PRC-883 采用主备用配置的 Postgres 服务器的更新 失败

Cloud 16.03.30

问题 ID 说明
SECENG-584 如果对证书链中的证书之间有换行符进行验证检查，会导致问题 一些证书在生产环境中
MGMT-3217 如果 KVMap 名称以“keys”结尾，则 Management API 调用会失败
MGMT-3214 在 JavaCallouts 期间可能会发生类冲突，导致客户的 Java 代码 失败
MGMT-3185 将组织管理员添加到组织时出错
EDGEUI-127 新的代理编辑器权限不足
EDGEUI-119 界面会话超时问题
CORESERV-671 看到“未配置任何响铃；无法初始化 cps 服务” 错误
AXAPP-2345 为非 CPS 客户列出 AX 自定义报告时出现问题
AXAPP-2302 “开发者”下的每日 Apigee 分析摘要显示零 采用率
APIRT-2750 特定组织的流量失败情况较高
APIRT-2516 JavaScript 调用程序中的运行时错误指定的行不正确 数字
APIRT-2508 在保险柜回调中调用快速监听时出现退出错误
APIRT-2336 与 Node.js 相关的 Gzip 问题
APIRT-1975 掩码配置不适用于 message.content

Cloud 16.03.16 界面

问题 ID 说明
MGMT-3142 错误分析信息中心的图表无法加载（更新了修复）

Cloud 16.03.09 界面

问题 ID 说明
MGMT-3158 通过 API
MGMT-3142 错误分析信息中心的图表无法加载
MGMT-3118 界面显示“clientAuthEnabled”的 SSL 虚拟主机配置不正确 参数
DEVRT-2344 单日报告定义不会在界面中加载交易

云 16.03.02

问题 ID 说明
MGMT-3083 Node.js 日志自动刷新功能过于冗长，并且日志消息过多
DEVRT-2275 自定义属性费率方案仅显示 5 个属性，而不是 10 个 允许
DEVRT-1275 “价格方案”下拉菜单中未显示所有开发者
DEVRT-1074 余额为零的预付费开发者会抛出 NullpointerException 已应用

Google Cloud 16.02.17

问题 ID 说明
MGMT-3083 Node.js 日志自动刷新功能过于冗长，并且日志消息过多
MGMT-3077 界面通过使用默认的 WSDL 生成无效的代理软件包 命名空间
MGMT-1642 自定义用户角色缺少“get”开发者应用的权限

已知问题

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

问题 ID 说明
APIRT-2978

路由器无法启动 Nginx 或路由器无法启动

如果边缘路由器无法启动 Nginx 或根本无法启动，如 /opt/apigee/var/log/edge-router/logs/system.log 文件，然后删除 /opt/nginx/conf.d 目录中的所有文件，并且 重启路由器：

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

消息处理器在 IPv4 和 IPv6 上执行 DNS 查找

如果您已安装并启用 NSCD（名称服务缓存守护程序） 请注意，消息处理器会进行两次 DNS 查找：一次用于 IPv4，一次用于 IPv6。

要在 IPv6 上停用 DNS 查找功能，请执行以下操作：

  1. 在每个消息处理器节点上，修改 /etc/nscd.conf。
  2. 设置以下属性：

    启用缓存主机 否
PRC-1118

运行“apigee-service apigee-postgresql pg-data-purge”时出错 命令

如果运行“apigee-service apigee-postgresql pg-data-purge”命令和 会看到以下形式的错误：

错误：必须是关系的所有者

修改 /opt/apigee/apigee-postgresql-4.16.05-0.0.894/lib/actions/pg-data-purge 并将以下属性设为“apigee”：

POSTGRES_USER=apigee
DOC-1687 由于已知的软件包依赖项冲突，Satellite 中使用的 Katello 代理 服务器 6 将无法在运行 Qpid 的 Apigee Edge 主机上正确安装 守护程序。

JSON 载荷 分配 Message、Java 调用程序和引发错误政策

通过“Assign Message”（分配消息）、Java 调用程序和“Raise Fault”（引发故障）策略，您可以生成消息 使用 <Set><Payload> 元素指定内容。作为这些消息的一部分 可以包含其值在运行时自动填充的变量。例如，如果您希望 从 HTTP 标头中输出日期 在您的邮件中插入 {message.header.date}。

如果消息格式为 JSON，则如下所示：

{"The date is: " : "{message.header.date}"}

但是，您可以看到这是格式不正确的 JSON。要解决此问题， 选项：

  • 使用反斜杠转义左花括号： 
    \{"The date is: " : "{message.header.date}"}
  • 在载荷元素配置中，使用 variablePrefix 和 variableSuffix 属性，用于指示 JSON 载荷中的变量。对于 示例：
    <Payload contentType="application/json" variablePrefix="#" variableSuffix="%">{"The date is: " : "#message.header.date%"}</Payload>

在下一个 Edge for Private Cloud 功能版本中，您将能够为 变量。(APIRT-1160)

路由器无法启动 Nginx 或 路由器无法启动

如果边缘路由器无法启动 Nginx 或根本无法启动（如 /opt/apigee/var/log/edge-router/logs/system.log 中所示） 文件，然后删除 /opt/nginx/conf.d 目录中的所有文件，并重启 路由器：

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
上一页
4 月 16 日
下一页
4 月 16 日