Guidance on Full Gerrit Sync and High Availability Setup

[Guy Levkowitz]

Hi,

We’re looking to set up a full bidirectional sync between two Gerrit sites.

Currently, we only use the replication plugin with the following configuration:

push = +refs/heads/*:refs/heads/*

push = +refs/tags/*:refs/tags/*

This setup replicates Git data but does not sync metadata, so the secondary site cannot fully access changes, reviews, or see data properly via the WebUI.

Our goal is for both sites to support read and write operations and to be fully synchronized.

Would the Gerrit High-Availability plugin be the best solution for this?

From the documentation, it seems the following are required:

• A shared filesystem mounted externally across the cluster to host the Git repositories

• A load balancer (like HAProxy) to manage traffic between the sites

We’d appreciate your input on whether we also need to share the entire /gerrit installation directory or just the Git repositories folder.

Looking forward to your guidance and expertise.

Thanks!

Guy

[Luca Milanesio]

Hi Guy,

On 24 Jun 2025, at 09:26, Guy Levkowitz <sil...@gmail.com> wrote:

Hi,

We’re looking to set up a full bidirectional sync between two Gerrit sites.

Currently, we only use the replication plugin with the following configuration:

push = +refs/heads/*:refs/heads/*

push = +refs/tags/*:refs/tags/*

This setup replicates Git data but does not sync metadata, so the secondary site cannot fully access changes, reviews, or see data properly via the WebUI.

I believe you should look at Gerrit Multi-Site setup [1]. There is *a lot* of information available for you to look at.

- YouTube playlist with collection of all talks about Gerrit Multi-Site [2]

- Design document [3]

- K8s Gerrit Multi-Site setup [4]

- Gerrit Multi-Site as-a-Service on Google Cloud [5]

Our goal is for both sites to support read and write operations and to be fully synchronized.

Would the Gerrit High-Availability plugin be the best solution for this?

No.

From the documentation, it seems the following are required:

• A shared filesystem mounted externally across the cluster to host the Git repositories

• A load balancer (like HAProxy) to manage traffic between the sites

Exactly: if you are looking for different sites, you cannot have a shared filesystem between regions.

We’d appreciate your input on whether we also need to share the entire /gerrit installation directory or just the Git repositories folder.

No, you don’t.

Looking forward to your guidance and expertise.

All shared below, happy reading/watching !

Luca.

[1] https://gerrit.googlesource.com/plugins/multi-site/

[2] https://www.youtube.com/playlist?list=PLySCWiWz9cNveIOCYaau34Jr6IwEfRX0E

[3] https://gerrit.googlesource.com/plugins/multi-site/+/refs/heads/master/DESIGN.md

[4] https://gerrit.googlesource.com/k8s-gerrit/

[5] https://console.cloud.google.com/marketplace/product/gerritforge-public/gerrit-as-a-service

Guy

--
--
To unsubscribe, email repo-discuss...@googlegroups.com
More info at http://groups.google.com/group/repo-discuss?hl=en

---
You received this message because you are subscribed to the Google Groups "Repo and Gerrit Discussion" group.
To unsubscribe from this group and stop receiving emails from it, send an email to repo-discuss...@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/repo-discuss/9aaa0e1e-4783-4df7-8514-450e5f9ba5bcn%40googlegroups.com.