1.1.0 - Apigee Hybrid 运行时版本说明

您正在查看的是 Apigee Edge 文档。
转到 Apigee X 文档。 信息

2020 年 1 月 27 日，Google 发布了 Apigee hybrid 运行时版本 1.1.0。本部分介绍 1.1.0 版本中发布的新功能和变更。

升级

您无法从 1.0.0 升级到 1.1.0，并且新版本不向后兼容 1.0.0。1.1.0 版需要新的安装。

新功能和改进

Apigee Connect（Alpha 版）

Apigee Connect Alpha 版允许 Apigee Hybrid MART 服务连接到管理平面，而无需公开 MART 端点。如果您使用 Apigee Connect，则无需使用主机别名和授权 DNS 证书配置 MART 入站流量网关。如需了解详情，请与您的 Apigee 代表联系。

基本路径路由

基本路径路由允许您配置和管理 Apigee Hybrid 将 API 代理调用路由到特定环境的方式。如需了解详情，请参阅配置基本路径路由。

变更

已对 Hybrid 运行时版本 1.1.0 进行以下更改。如前所述，其中一些更改不向后兼容 1.0.0 版。

  • apigeectl CLI 现在将在 istio-system 命名空间中安装 Istio。这是 Istio 的默认命名空间。此更改与 Hybrid 版本 1.0.0 向后兼容。
  • apigeectl CLI 现在会将 CertManager 安装到 cert-manager 命名空间。此更改与 Hybrid 版本 1.0.0 向后兼容。
  • 使用 Apigee hybrid 运行时部署的 Istio 受支持版本已迁移到 1.4.2，因为版本 1.2.x 不再受支持。

已修复 Bug

Apigee hybrid 1.0.0 版本说明中列出的以下问题已修复：

问题 说明
144886537 基本路径路由无法在 Apigee Hybrid v1.0.0 中使用。将替换设置为路由到具有相同 hostAlias 的不同环境时，入站流量不会根据路径路由到环境。
143774187 Hybrid 界面会在“应用”视图中显示“公司”标签。

已知问题

下表说明了此版本的已知问题：

问题 说明
不适用 您不能同时为 mart 和 envs 配置的 hostAlias 属性使用 *。最佳做法是为 mart 配置使用特定的主机名。
不适用 Apigee Connect Alpha 版不支持设置 HTTP_PROXY、HTTPS_PROXY 和 NO_PROXY 变量。
不适用

无效的 HTTP 标头错误：Istio Ingress 会将所有传入的目标响应切换到 HTTP2 协议。由于混合消息处理器仅支持 HTTP1，因此调用 API 代理时，您可能会看到以下错误：

http2 error: Invalid HTTP header field was received: frame type: 1, stream: 1,
   name: [:authority], value: [domain_name]

如果出现此错误，您可以采取以下任一措施来纠正问题：

  • 修改目标服务以忽略响应中的主机标头。
  • 如有必要，使用 API 代理中的 AssignMessage 政策移除主机标头。
144584813 如果您创建了一个调试会话，但会话内还没有任何事务，则 List Debug Sessions API 不会在此列表中包括该会话。仅当会话至少包含一个事务时，API 才会在响应中包括会话。
144436206 在缓存性能视图中，缓存命中率计算不正确。
144321491 Apigee Hybrid 记录表示性能可能下降的“创建缺少缓存”通知。这些是预期的消息，可以忽略。
144321144 具有安全 虚拟主机的代理无法重新加载。
144286363

env.json 中的调试掩码不会遮盖响应数据。

使用 responseJSONPaths 字段更新 env.json 调试掩码的以下 API 不起作用：

PATCH /v1/organizations/org/environments/env/debugmask?replaceRepeatedFields=true
{
  "responseJSONPaths": ["$.maskedDataEnv"]
}

如需解决跟踪记录的此问题，您可以在界面中删除整个跟踪会话，也可以使用跟踪记录 API 删除会话中的各个事务。
143659917

PopulateCache 政策的到期时间设置必须设为 1 到 30 之间的显式值。例如：

<ExpirySettings>
  <TimeoutInSec>30</TimeoutInSec>
</ExpirySettings>
133192879

摘要：使用 API 或界面获取组织的部署状态时，出现极高的延迟。此延迟可能会导致 HTTP 204 (No Content) 或 HTTP 400 (Bad Request) 响应。

解决方法：刷新浏览器（或重新发送请求）。