1.2.0 - Apigee Hybrid 运行时版本说明

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

我们于 2020 年 4 月 3 日发布了 Apigee Hybrid 运行时版本 1.2.0。

正在升级

新功能和更新

以下是此版本中的新功能和更新:

添加了新的虚拟主机配置以指定路由规则

新的 virtualhosts 配置功能解决了基本路径路由到多个环境时采用的顺序不确定这个问题。如需了解详情,请参阅配置虚拟主机。(150336519)

OASValidation 政策的 Beta 版

借助 OASValidation(OpenAPI 规范验证)政策(Beta 版),您可以根据 OpenAPI 3.0 规范(JSON 或 YAML)验证传入的请求或响应消息。如需了解详情,请参阅 OASValidation 政策(Beta 版)。(144949685)

WebSocket 支持 Beta 版

Apigee Hybrid 支持 WebSocket 连接。API 代理客户端现在可以请求将协议从 HTTP 升级到 WebSocket。如需了解详情,请参阅使用 WebSocket(Beta 版)

从 Kubernetes Secret 访问政策密钥值

借助新功能,您可以在代理流变量中访问存储在 Kubernetes Secret 中的值。如需了解详情,请参阅在 Kubernetes Secret 中存储数据。(133377603)

Apigee Operators (AO) 元素替换了 ADAC 和 ADAH

Apigee Operators (AO) 创建和更新部署和维护 AD 所需的低级 Kubernetes 和 Istio 资源。例如,控制器会执行消息处理器的发布。此外,先验证 ApigeeDeployment 配置,然后再将其保留在 Kubernetes 集群中。AO 替换了 Apigee Deployment Admissionhook (ADAH) 和 Apigee Deployment Controller (ADC)。请参阅配置属性参考文档中的 AO。(151250559)

替换和弃用某些集群和项目配置属性

新增了 k8sClustergcp 这两个配置属性。这些属性替换了以下已弃用的属性:k8sClusterNamegcpRegiongcpProjectID。如需了解详情,请参阅配置属性参考文档。(146299599)

Kubernetes 上 Cassandra 的永久性卷扩展

添加了一个过程,以便扩展 apigee-cassandra 使用的永久性卷来满足存储需求,而无需添加更多节点来增加存储空间。请参阅扩展 Cassandra 永久性卷。(138167919)

支持适用于证书、加密密钥和 SA 的其他来源

添加了新的配置属性,您可以通过这些属性更灵活地指定 TLS 证书、加密密钥和服务账号密钥。下文列出了新属性:

  • kmsEncryptionPath
  • kmsEncryptionSecret.key
  • kmsEncryptionSecret.name
  • cassandra.backup.serviceAccountSecretRef
  • cassandra.restore.serviceAccountSecretRef
  • envs[].cacheEncryptionPath
  • envs[].cacheEncryptionSecret.key
  • envs[].cacheEncryptionSecret.name
  • envs[].kmsEncryptionPath
  • envs[].kmsEncryptionSecret.key
  • envs[].kmsEncryptionSecret.name
  • envs[].serviceAccountSecretRefs.synchronizer
  • envs[].serviceAccountSecretRefs.udca
  • envs[].sslSecret
  • logger.serviceAccountSecretRef
  • mart.serviceAccountSecretRef
  • mart.sslSecret
  • metrics.serviceAccountSecretRef
  • synchronizer.serviceAccountSecretRef
  • udca.serviceAccountSecretRef

如需了解详情,请参阅配置属性参考文档。(145303466)

允许客户在将数据发送到分析之前先进行模糊处理

添加了一项功能,以允许您在将部分分析数据发送到管理层面之前先进行模糊处理。如需了解详情,请参阅混淆用于分析的用户数据。(142578910)

扩展 StatefulSet 的永久性卷

添加了一项功能,允许您扩展 apigee-cassandra 使用的永久性卷以满足存储需求,而无需增加更强的计算能力。如需了解详情,请参阅扩展 StatefulSet 的永久性卷。(138167919)

升级所支持的最低版本的 GKE、Anthos 和 AKS

Apigee Hybrid 现在支持 GKE 1.14.x、Anthos 1.2 和 AKS 1.14.x。(149578101)

支持适用于北向连接的 TLS 1.3

通过两个新的配置属性,您可以为 Ingress 设置最小和最大 TLS 版本:ingress.minTLSProtocolVersionmaxTLSProtocolVersion。可能的值包括 1.0、1.1、1.2 和 1.3。如需了解详情,请参阅配置属性参考文档。(117580780)

支持混合运行时的转发代理配置

部署到环境的 API 代理现在支持 HTTP 转发代理功能。如需了解详情,请参阅配置转发代理功能。(148970527)

支持每个环境配置多个主机别名

已添加新的配置属性 envs[].hostAliases。通过此属性,您可以为一个环境添加多个主机别名。使用此元素来替代已弃用的 hostAlias。如需了解详情,请参阅在一个环境中添加多个主机别名。(150738495)

允许使用面向属性集的模板

在 <AssignMessage> 政策的 <AssignVariable> 元素中添加了一个新元素 <PropertySetRef>。<PropertySetRef> 可让您动态创建属性集名称/键对。此功能仅适用于部署到 Apigee Hybrid 的 API 代理。请参阅 AssignVariable。(148612340)

已修复 Bug

此版本中修复了以下 Bug。此列表主要供用户检查其支持服务工单中的问题是否已修复,并非旨在为所有用户提供详细信息。

问题 ID 组件名称 说明
147958049 运行时 解决了运行时启动顺序中的计时问题,该问题有时会阻止同步器正确启动。
149867244 K8S 平台 多地区设置中的 apigee-cps-setup pod 失败
150187652 / 149117839 运行时 不能在环境名称中使用连字符。
149220463 MP pod 之前部署的代理需要重新部署。
144321144 运行时 无法重新加载包含安全虚拟主机的代理。
147685310 运行时 由于初始化期间 GCP 令牌提取失败,导致同步器初始化失败。
151115900 运行时 HybridMART 不会定期进行内部探测,从而导致误报结果。

已知问题

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

问题 说明
不适用

无效的 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 才会在响应中包括会话。
143659917

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

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

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

解决方法:刷新浏览器(或重新发送请求)。