Google Git
Sign in
gerrit / modules / global-refdb / c64df45487c34b638b12876a08fa2b3d52820e7f
commitc64df45487c34b638b12876a08fa2b3d52820e7f[log] [tgz]
authorLuca Milanesio <luca.milanesio@gmail.com>Tue Jun 27 14:32:10 2023 +0100
committerLuca Milanesio <luca.milanesio@gmail.com>Tue Jun 27 14:32:10 2023 +0100
treeb7e98e3dff615a313a92e9a893e8a7e5d01c2764
parent3dddad5821e7c45c643d4fb8f8b6bbaf28db4528 [diff]
parent5bcb69edaf06a8a4d3628de141f50c3829f69370 [diff]
Merge branch 'stable-3.4' into stable-3.5

* stable-3.4:
  Bump version to v3.4.8.6
  Consider robot comments as mutable ref for validation
  Introduce isUpToDateUnchecked for silent global-refdb checks
  Add Bazel build instructions
  Define the artifact as Gerrit plugin

Change-Id: I78c459136225f31e68c98580e55ba5ef5d35a100
tree: b7e98e3dff615a313a92e9a893e8a7e5d01c2764
  1. src/
  2. .gitignore
  3. bindings.md
  4. BUILD
  5. config.md
  6. Jenkinsfile
  7. LICENSE
  8. metrics.md
  9. pom.xml
  10. 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 bazelsk build plugins/global-refdb

Example:

bazelisk build plugins/global-refdb

The libModule jar file is created under basel-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.