2023-11-23 12:27:47 +00:00
<#import "/templates/guide.adoc" as tmpl>
<#import "/templates/links.adoc" as links>
<@tmpl.guide
2024-08-07 08:22:59 +00:00
title="Building blocks multi-site deployments"
2024-02-16 14:02:11 +00:00
summary="Overview of building blocks, alternatives and not considered options" >
2023-11-23 12:27:47 +00:00
2024-08-07 08:22:59 +00:00
The following building blocks are needed to set up a multi-site deployment with synchronous replication.
2023-11-23 12:27:47 +00:00
The building blocks link to a blueprint with an example configuration.
They are listed in the order in which they need to be installed.
include::partials/blueprint-disclaimer.adoc[]
== Prerequisites
2024-08-07 08:22:59 +00:00
* Understanding the concepts laid out in the <@links.ha id="concepts-multi-site"/> {section}.
2023-11-23 12:27:47 +00:00
== Two sites with low-latency connection
Ensures that synchronous replication is available for both the database and the external {jdgserver_name}.
2024-05-03 12:41:16 +00:00
*Suggested setup:* Two AWS Availability Zones within the same AWS Region.
2023-11-23 12:27:47 +00:00
*Not considered:* Two regions on the same or different continents, as it would increase the latency and the likelihood of network failures.
Synchronous replication of databases as a services with Aurora Regional Deployments on AWS is only available within the same region.
== Environment for {project_name} and {jdgserver_name}
Ensures that the instances are deployed and restarted as needed.
*Suggested setup:* Red Hat OpenShift Service on AWS (ROSA) deployed in each availability zone.
*Not considered:* A stretched ROSA cluster which spans multiple availability zones, as this could be a single point of failure if misconfigured.
== Database
A synchronously replicated database across two sites.
*Blueprint:* <@links.ha id="deploy-aurora-multi-az"/>.
== {jdgserver_name}
2024-04-30 21:45:58 +00:00
A deployment of {jdgserver_name} that leverages the {jdgserver_name}'s Cross-DC functionality.
2023-11-23 12:27:47 +00:00
*Blueprint:* <@links.ha id="deploy-infinispan-kubernetes-crossdc" /> using the {jdgserver_name} Operator, and connect the two sites using {jdgserver_name}'s Gossip Router.
*Not considered:* Direct interconnections between the Kubernetes clusters on the network layer.
It might be considered in the future.
2024-05-22 11:26:26 +00:00
[IMPORTANT]
====
2024-08-07 08:22:59 +00:00
Only {jdgserver_name} server versions 15.0.0 or greater are supported in multi-site deployments.
2024-05-22 11:26:26 +00:00
====
2023-11-23 12:27:47 +00:00
== {project_name}
A clustered deployment of {project_name} in each site, connected to an external {jdgserver_name}.
*Blueprint:* <@links.ha id="deploy-keycloak-kubernetes" /> together with <@links.ha id="connect-keycloak-to-external-infinispan"/> and the Aurora database.
</@tmpl.guide>
2023-11-30 12:47:06 +00:00
== Load balancer
2023-11-23 12:27:47 +00:00
2024-08-07 08:22:59 +00:00
A load balancer which checks the `/lb-check` URL of the {project_name} deployment in each site, plus an automation to detect {jdgserver_name} connectivity problems between the two sites.
2023-11-23 12:27:47 +00:00
2024-08-07 08:22:59 +00:00
*Blueprint:* <@links.ha id="deploy-aws-accelerator-loadbalancer"/> together with <@links.ha id="deploy-aws-accelerator-fencing-lambda"/>.
