使用多站点设置从站点故障中恢复

这些指南包括分步说明，以启动 Keycloak 多站点架构的不同组件，例如

一系列指南，介绍如何在 Amazon Web Service 上以各种配置部署 Keycloak。

这些指南包括详细的操作过程，确保用户能够高效地设置和操作其多站点 Keycloak 实例。

将此安装到测试环境中的 Keycloak 服务器中，并根据需要创建尽可能多的用户、客户端、组等，以运行您的性能基准测试。Keycloak 在其内部缓存中缓存大量信息，数据库也是如此，因此只有当您的数据库中有足够的数据时，您才能发现一些问题。

这包含可立即使用的场景，用于身份验证流程和 Keycloak 的管理 REST 端点。如果它还不适合您的需求，请将其用作库来创建您自己的基于现有步骤和自定义步骤的 Gatling 场景。这些测试以 JAR 和 shell 脚本包装器形式部署，因此您只需要在负载运行器上安装 Java，您就可以开始使用。

使用这些 Ansible 剧本启动一组 EC2 实例，以针对 Keycloak 测试安装驱动负载，并汇总结果。

基于 AWS 上的 Red Hat OpenShift 服务 (ROSA)，使用脚本预配置监控、日志记录和有用的操作员来预配实例，准备部署 Keycloak。

在不同的区域或全局变体中设置 Aurora，并将其连接到 ROSA 环境。

这会部署 Keycloak，并附带额外的监控和调试工具，以便我们根据需要查看指标、日志和跟踪。

为主动-被动设置设置 Route 53，以将负载分发到两个不同 OpenShift 集群中的 Keycloak 部署。

我们每周都会使用 GitHub 操作、性能测试套件从头开始创建一个新的多 AZ 设置，并记录结果。这样，我们就可以在功能和性能回归出现时将其捕获。

在高负载下运行 Keycloak 时，请求可能会在 Keycloak 实例中排队。排队的请求越多，回复请求所需的时间就越长。在以前的版本中，对存活性探测（/health/live）的请求也会排队，探测最终会超时，然后 Kubernetes 会重新启动 Pod。在最新版本的 Keycloak 中，探测已重新实现为非阻塞，因此它不会排队，因此不会超时，并且 Pod 不会在高负载下重新启动。

当请求如上所述排队时，调用方将无法及时收到响应，并且 Pod 最终可能会耗尽资源，如内存或网络连接。建议的做法是在实例无法及时处理请求时尽早丢弃请求，这称为负载卸载。Keycloak 23 现在支持新选项 http-max-queued-requests，它可以限制并发阻塞请求的数量。当超过该数量时，Keycloak 会立即返回响应 503 Server not Available。这有两个好处：调用方会立即收到响应，并可以稍后重试，并且服务器端会立即释放资源。

当新的 Keycloak 实例启动或重新启动时，其缓存为空。如果在高负载下，针对 Keycloak 节点上的同一领域或同一客户端的并行请求到达，则以前版本的 Keycloak 会在每个并行请求中从数据库加载数据。这会导致数据库连接使用量激增，并导致初始响应延迟。当缓存或领域条目从缓存中逐出时，也会发生相同的情况，例如，因为它已被修改。最新版本的 Keycloak 会阻止这种情况，以便每个 Keycloak 实例只从数据库中获取一次数据，所有其他并行请求随后都会使用此数据，而不会再次查询数据库（请参阅#21521 和#22988，#24202）。

在集群中运行的 Keycloak 实例越多，并行处理的请求越多，JGroups 线程池上的负载就越高。JGroups 线程池确保 Keycloak 嵌入式 Infinispan 的通信顺畅，如果其容量超过，则会导致内部 Infinispan 通信超时。高可用性文档现在包含有关如何设置 Quarkus 线程池以不超过 JGroup 线程池的文档。

嵌入式 Infinispan 提供了改进的指标，允许您监控集群。Keycloak 指标端点公开的指标现在仅包含当前节点的 Infinispan 指标，因此如果另一个 Pod 当前正在启动或关闭，它们不会阻塞（ISPN-15042 和ISPN-15072）。这样，您就可以在这些关键时刻更好地了解集群情况。指标现在可以将缓存名称作为标签公开，因此可以通过在 Infinispan XML 配置中添加 <metrics names-as-tags="true" /> 来更轻松地将其绘制在仪表板中。还提供针对站点之间延迟的其他指标。

我们彻底测试了 Infinispan 及其通信层 JGroups，并能够修复状态传输停止（ISPN-14982）或初始状态传输失败的情况。多站点设置中使用的 Gossip 路由器现在即使在负载均衡器具有多个 IP 地址的情况下也能正常工作（JGRP-2722，JGRP-2721，infinispan-operator#1857，以及infinispan-operator#1856）。