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

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

一系列关于如何在 Amazon Web Service 上以各种配置部署 Keycloak 的指南。

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

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

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

使用这些 Ansible playbook 启动一组 EC2 实例，以驱动针对 Keycloak 测试安装的负载，并聚合结果。

基于 Red Hat OpenShift Service on AWS (ROSA)，使用脚本配置一个预配置了监控、日志记录和有用的 Operator 的实例，准备部署 Keycloak。

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

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

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

每个工作日，我们都使用 GitHub Actions 从头开始创建一个新的多可用区设置、性能测试套件并记录结果。这样，我们就可以在功能和性能回归发生时及时捕获。

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

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

当新的 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) 或初始状态传输失败的情况。即使在负载均衡器具有多个 IP 地址的情况下，多站点设置中使用的 Gossip 路由器现在也可以工作 (JGRP-2722, JGRP-2721, infinispan-operator#1857, 和 infinispan-operator#1856)。