Google Git
Sign in
gerrit / modules / global-refdb / refs/heads/stable-3.11
commit7d53fba158464395f2eabc9b386bbbe25d0643ff[log] [tgz]
authorLuca Milanesio <luca.milanesio@gmail.com>Sat Mar 22 09:44:36 2025 +0000
committerLuca Milanesio <luca.milanesio@gmail.com>Mon Mar 24 11:41:34 2025 +0000
tree5a0192227d0789cdf699b5a33bb0b3e00972d003
parentaf2d2b1cd1cf3c11227f9dd9ea891fedc1df7f54 [diff]
parentdbc4eed6f8f2455a6146da8567177de511feba8d [diff]
Merge branch 'stable-3.10' into stable-3.11

* stable-3.10:
  Move DisabledSharedRefLogger into the library
  Introduce local-refdb locking facility
  Remove unneeded @Inject in LockWrapper
  Remove unused LockWrapper.Factory
  Add sentinel to prevent out of sync with global-refdb
  Verify global-refdb formatting using GJF 1.7
  Log lock acquisition only after is successful
  Log lock releases

Change-Id: I8367b74601f171a869c3341bc7965e47f8243bc5
tree: 5a0192227d0789cdf699b5a33bb0b3e00972d003
  1. src/
  2. .gitignore
  3. bindings.md
  4. BUILD
  5. config.md
  6. Jenkinsfile
  7. LICENSE
  8. metrics.md
  9. README.md
README.md

Gerrit interface to a global-refdb

Global ref-database interface for use with Gerrit Code Review.

Enables the de-coupling between Gerrit, its libModules and the different implementations of a globally shared ref-database.

Design

The design for a global ref-db interface can be found as part of the multi-site design documentation, where it first originated and was approved by the community.

Bindings

In order to consume this library, some Guice bindings need to be registered appropriately. More information in the relevant documentation.

Metrics

Global ref-database expose metrics to measure the global ref-database operation latency. List of the available metrics can be found here.

How to build

This libModule is built like a Gerrit in-tree plugin, using Bazelisk.

Build in Gerrit tree

Create a symbolic link of the repository source to the Gerrit source tree /plugins/global-refdb directory.

Example:

git clone https://gerrit.googlesource.com/gerrit
git clone https://gerrit.googlesource.com/modules/global-refdb
cd gerrit/plugins
ln -s ../../global-refdb .

From the Gerrit source tree issue the command bazelisk build plugins/global-refdb

Example:

bazelisk build plugins/global-refdb

The libModule jar file is created under bazel-bin/plugins/global-refdb/global-refdb.jar

To execute the tests run bazelisk test plugins/global-refdb/... from the Gerrit source tree.

Example:

bazelisk test plugins/global-refdb/...

How to import into Eclipse as a project

Add global-refdb in the CUSTOM_PLUGINS section of the tools/bzl/plugins.bzl.

Example:

CUSTOM_PLUGINS = [
    "global-refdb",
]

Run tools/eclipse/project.py for generating or updating the Eclipse project.