4.19.06 Edge for Private Cloud 版本说明

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

本部分介绍了 4.19.06 版 Edge for Private Cloud 功能版本。

版本摘要

下表总结了此版本中的变更:

新功能

此版本包含以下新功能:

○ LDAP 支持单点登录
○ HTTP 部署支持
○ 可插入式分析
○ Cassandra 机架支持
○ IPv6 支持
○ 简化了新版 Edge 的安装流程
○ 排除 INVALID_TSC 笔交易(创收)

如需详细了解上述各项新功能,请参阅 新功能

向后兼容性

此版本中引入了以下影响向后兼容性的问题 适用于私有云的 Apigee Edge:

     
  • 由于问题 132443137(如 2001 年 3 月 19 日公开 Cloud 版本说明),消息处理器现在会忽略以 X-Apigee-*。因此,您必须重构所有使用 X-Apigee-* 标头,并将这些标头替换为受支持的标头。

  • Cassandra 日志文件的名称已更改。现在是:

    /opt/apigee/var/log/apigee-cassandra/system.log
包含的版本

自上一个 Edge for Private Cloud 功能版本以来,以下版本 已发布并包含在此版本中:

○ 边缘:
19.07.23(界面)
19.03.01
19.02.19
19.02.04
19.01.23
19.01.14
18.12.04
18.08.31
18.07.31
○ 门户网站:
19.07.08
19.05.23
19.05.08
19.04.18
19.03.20
19.02.27
19.02.21
19.02.04
19.01.16
退休
弃用

在 4.19.06 版中,以下项已被弃用:

  • 4.18.01::适用于私有云的 Apigee Edge 4.18.01 版本现已弃用。

如需了解详情,请参阅 Apigee 弃用、弃用和 CPS 更改

bug 修复

此版本修复了以下问题:

○ 未设置 UseStringDeduplication (140270474)
○ MP 错误 (111445518)
○ 使用 JMX 导致 Cassandra 故障 (113342838)
○ 13 节点升级 (138931337)
○ 同名代理 (119802562)
○ 密钥库无法加载 (118851790)
○ 分析失败 (110988191)
○ 备份失败 (110785400)
HEAD 对 Node.js 的请求 (79993247)
○ apigee-postgres 备份/恢复 (70291825)
○ 重置系统管理员密码 (65737520)

如需详细了解各项修复,请参阅问题修复

已知问题

此版本包含以下已知问题:

○ Mint 最初未对交易进行评分 (141628497)
○ Mint 评级服务器内存泄漏 (137865184)
○ apigee-sso 安装的元数据文件格式 (135616498)
apigee-monit 在 Amazon Linux 1 (122370980) 上不受支持
○ 消息处理器备份功能未备份正确的文件集 (121095148)
○ 多数据中心配置中的 DataAccessExceptions (76087166)
○ MessageLogging 政策,在日志消息中包含额外信息 (68722102)

有关每个已知问题(包括解决方法)的详细信息,请参阅 已知问题

升级路径

下表显示了此版本的升级路径:

从 4.19.01 开始 直接从 4.19.01 升级到 4.19.06
从 4 月 18 日 直接从 4.18.05 升级到 4.19.06
从 4 月 18 日 直接从 4.18.01 升级到 4.19.06

新功能

本部分列出了此版本中的新功能。此外,此版本还包含 Edge 界面、Edge 管理和门户版本中的功能,请参阅 包含的版本

除了以下增强功能外,此版本还具有多种易用性, 性能、安全性和稳定性增强

HTTP 部署支持

默认情况下,Edge 使用 RPC 部署 API 代理。虽然这种模式适合 大量 MP 的较大拓扑,当大量节点 并发调用通过 RPC 进行。

因此,Apigee 建议较大规模的部署使用 HTTP 而不是 RPC 来进行 部署。现在支持启用 HTTP 部署。

有关详情,请参阅启用 HTTP 部署

Cassandra 机架支持

Apigee 现在通过让 Cassandra 为 Cassandra 的扩缩提供一般指导。 适用于 Private Cloud 机架感知型资源。

如需了解详情,请参阅 Cassandra 机架支持

可插入式分析

默认情况下,消息处理器收集的分析数据会上传到 Qpid 和 Postgres 进行处理。然后,您可以在 Edge 界面中查看分析数据。

在此功能发布中,您可以将消息处理器配置为将分析数据写入 也可以同时使用这两个选项

如需了解详情,请参阅 将分析数据写入文件

简化了新版 Edge 的安装流程

我们通过新的脚本简化了新版 Edge 的安装流程。

如需了解详情,请参阅安装新版 Edge 体验

LDAP IDP 支持

通过 Edge 界面和 Edge Management API 调用对用户进行身份验证现在支持 LDAP 对 SAML 的补充。LDAP 支持包括直接绑定和间接绑定方法。

有关详情,请参阅外部 IDP 身份验证

IPv6 支持

默认情况下,对适用于私有云的 Apigee Edge 的所有运行时 API 调用都使用 IPv4。您可以添加 IPv6 。

有关详情,请参阅在 路由器

排除 INVALID_TSC 笔交易(创收)

您现在可以排除 INVALID_TSC 笔交易,使其不添加到 Postgres 数据库。

有关详情,请参见获利 服务器属性

支持的软件

此版本对受支持的软件进行了以下更改:

已添加支持 不再受支持

此版本新增了对以下平台的支持:

  • Red Hat Enterprise Linux (RHEL) 6.10
  • CentOS 6.10
  • Oracle Linux 6.9

此版本不再支持以下平台:

  • Red Hat Enterprise Linux (RHEL) 6.9
  • CentOS 6.9
  • Oracle 6.8

如需查看受支持平台的完整列表,请参阅 支持的软件和支持的版本

bug 修复

本部分列出了此版本中修复的 Private Cloud 错误。此外, 版本包含 Edge 界面、Edge Management 和门户版本中的所有 bug 修复(如 包含的版本

问题 ID 说明
140270474

未设置 UseStringDeduplication

UseStringDeduplication不是 为正式版 edge-message-processor 组件做好准备 环境
111445518

MP 错误

消息处理器每 5 分钟持续记录以下错误消息:
2019-06-29 00:02:05,775 Apigee-Timer-6 ERROR CMgmt -
  ConnectorServiceImpl.refreshToken() : Connector Management API auth token
  generation failed: 0 null
113342838

JMX 导致 Cassandra 故障

启用 JMX 身份验证后,Cassandra 操作无法执行
138931337

13 节点升级

从 17.09、18.01 和 18.05 升级 13 节点安装失败。
119802562

同名的代理

如果同一组织中的两位用户创建了代理 同名的第二个列表,则第二个创建的 将覆盖第一个。仅当 个不同的用户无法看到另一个代理。
118851790

密钥库无法加载

如果一个组织/环境的密钥库数超过 100 个,则密钥库和 Edge 界面中的参考部分未能加载。相反,界面会显示 Internal Error (Error Fetching Keystores) 错误。
110988191

分析失败

向之前指定的 Microgateway 提供数据时,环境的 Google Analytics 失败 设置为将来的日期。
110785400

备份失败

ZooKeeper、Cassandra 和 OpenLDAP 间歇性无法执行 正确备份数据,并显示以下错误:File changed as we read it.
79993247

向 Node.js 发出 HEAD 请求

向 Node.js 目标发出的 HEAD 请求可能会挂起,导致连接处于待处理状态。
70291825

apigee-postgres 备份/恢复

现在,执行 apigee-postgres 备份/恢复操作会备份所有组件的数据。
65737520

重置系统管理员密码

重置包含特殊 就会失败。

已知问题

下表列出了此版本中的已知问题:

问题 ID 说明
141628497

Mint 最初未对交易进行评分

当您首次为组织启用创收功能时,Private Cloud 的 Edge 一开始不会对交易进行评分。这适用于新的和现有的组织。

Monetization enablement API 会提供作业 ID 作为响应,完成后,作业状态将指示作业成功。不过,最初发出的任何用于创收的 API 调用都不会由创收功能处理,也不会被分级。这些交易数据只会显示在常规分析数据中。

临时解决方法:

重启任何消息处理器 (MP),可通过以下方法完成:
apigee-service edge-message-processor restart

启用创收功能后,重启 MP 会导致 Edge 在启动时加载 ZooKeeper 中的配置。每次重启时都会发生这种情况,这意味着问题仅在最初出现。

137865184

Mint 评级服务器内存泄漏

在 mxgroup 中注册新的 Qpid 实例时,在没有使用者的情况下建立队列,这会导致队列深度增加,直到它用完所有可用资源为止。

临时解决方法:

无。
135616498

apigee-sso 安装的元数据文件格式

安装 apigee-sso 并使用 metadata.xml 文件(而非网址)时,如果 metadata.xml 文件在文件末尾未包含换行符 (CRLF),则系统不会读取整个 metadata.xml 文件。

临时解决方法:

如需解决此问题,您可以执行以下任一操作:

  • 将 CRLF 添加到 metadata.xml 文件的末尾

  • 为元数据使用基于网址的位置
122370980

在 Amazon Linux 1 上不支持 apigee-monit

临时解决方法:

无。
121095148

消息处理器备份功能未备份正确的文件集

临时解决方法:

再次运行备份,它应该会备份正确的文件集。

76087166

多个数据中心配置中的 DataAccessException

在多个数据中心配置中,如果一个数据存储区变得不可用,那么您可能会看到 以下错误:

DataAccessException: Error while accessing datastore;
Please retry later

结果是 Management Server 正在尝试连接到 Cassandra,因此可能无法启动 节点。如果 Cassandra 节点DataAccessExceptions 。这也可能导致 API 流量中断,而消息处理器会报告 DataAccessExceptions

请注意,预期状态是管理服务器不连接到数据存储区组件 跨区域。

临时解决方法

解决方法是在不可用的数据中心中取消注册以下 Cassandra 节点类型 在 Cassandra 节点再次可用后重新注册这些节点:

  • kms-datastore
  • dc-datastore
  • keyvaluemap-datastore

如需取消注册和重新注册这些 Cassandra 节点类型,请执行以下操作

  1. 使用以下 curl 命令获取 Cassandra 节点的 UUID:
    curl -u ADMIN_EMAIL:ADMIN_PW \
      "http://MS_IP:MS_PORT/v1/servers?region=REGION&pod=GATEWAY_POD \
      &type=CASSANDRA_NODE_TYPE"

    其中:

    • ADMIN_EMAILADMIN_PW 是您的 Apigee 的凭据 。
    • MS_IPMS_PORT 是管理服务器的 IP 地址和端口 数字。
    • REGION 是管理服务器所在的数据中心的名称 。
    • GATEWAY_POD 是 Pod 名称,默认为“gateway”。您可能有 请将其重命名为其他名称,因此请检查您的实现方式。
    • CASSANDRA_NODE_TYPE”是以下值之一:kms-datastoredc-datastore、 和 keyvaluemap-datastore

    例如:

    curl -u nickdanger@google.com:myP@$$w0rD
      "http://192.168.0.1:8080/v1/servers?region=dc-1&pod=gateway&type=dc-datastore"

    响应使用以下格式:

    {
      "internalIP" : "POD_IP_ADDRESS",
      "isUp" : [true|false],
      "pod" : "GATEWAY_POD",
      "reachable" : [true|false],
      "region" : "dc-1",
      "tags" : {
        "property" : [ ]
      },
      "type" : [ "kms-datastore", "dc-datastore", "keyvaluemap-datastore" ],
        "uUID" : "POD_UUID"
    }

    例如:

    {
      "internalIP" : "192.168.1.11",
      "isUp" : false,
      "pod" : "gateway",
      "reachable" : false,
      "region" : "dc-1",
      "tags" : {
        "property" : [ ]
      },
      "type" : "dc-datastore",
      "uUID" : "13cee956-d3a7-4577-8f0f-1694564179e4"
    }

    请记下响应中 uUID 字段的值。您将使用这些信息来实现以下目的: 取消注册节点

  2. 对以下每个 Cassandra 节点类型重复执行第 1 步:kms-datastoredc-datastorekeyvaluemap-datastore。请务必记下 返回的 UUID。
  3. 使用以下命令取消注册节点:
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers/UUID" -X DELETE

    其中 UUID 是在上一个命令的响应中返回的 UUID。

  4. 针对您在第 1 步和第 2 步中收集的每个 UUID 重复第 3 步。
  5. 使用以下命令重新注册节点:
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers -d \
      "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore& \
      Type=counter-datastore&Type=cache-datastore&InternalIP=POD_IP_ADDRESS& \
      region=REGION&pod=GATEWAY_POD" -H \
      'content-type: application/x-www-form-urlencoded' -X POST

请注意,这些操作会从 Zookeeper 中注册和取消注册节点, 对 Cassandra 集群的影响。如需详细了解这些命令,请参阅 更新数据存储区注册

68722102

MessageLogging 政策,包括在日志消息中包含额外信息

MessageLogging 政策的 FormatMessage 元素用于控制所记录消息的格式。如果为 FormatMessage=false,则记录的消息不应包含 Apigee 生成的任何信息。不过,即使您设置了 FormatMessage=false,日志消息中仍会包含以下信息:

  • 优先级得分
  • 时间戳

临时解决方法:

无。

下一步

如需开始使用适用于私有云 4.19.06 的 Edge,请访问以下链接:

新安装:
新安装概览
现有安装次数:
升级路径