infra-docs-fpo/modules/sysadmin_guide/pages/bugzilla2fedmsg.adoc
Kevin Fenzi cc6d4b0750 Drop IRC and replace with matrix is all our docs.
Since we are moving to matrix, lets drop reference to irc.
I may have missed a few of these and I left the Zodbot SOP alone for now
until we replace it with the new matrix one.

Signed-off-by: Kevin Fenzi <kevin@scrye.com>
2023-12-20 11:15:46 -08:00

71 lines
1.9 KiB
Text

= bugzilla2fedmsg SOP
Receive events from bugzilla over the RH "unified messagebus" and
rebroadcast them over our own fedmsg bus.
Source code: https://github.com/fedora-infra/bugzilla2fedmsg
== Contact Information
Owner::
Messaging SIG, Fedora Infrastructure Team
Contact::
#fedora-apps, #fedora-fedmsg, #fedora-admin, #fedora-noc
Servers::
bugzilla2fedmsg01
Purpose::
Rebroadcast bugzilla events on our bus.
== Description
bugzilla2fedmsg is a small service running as the 'moksha-hub' process
which receives events from bugzilla via the RH "unified messagebus" and
rebroadcasts them to our fedmsg bus.
[NOTE]
====
Unlike _all_ of our other fedmsg services, this one runs as the
'moksha-hub' process and not as the 'fedmsg-hub'.
====
The bugzilla2fedmsg package provides a plugin to the moksha-hub that
connects out over the STOMP protocol to a 'fabric' of JBOSS activemq
FUSE brokers living in the Red Hat DMZ. We authenticate with a cert/key
pair that is kept in _/etc/pki/fedmsg/_. Those brokers should push
bugzilla events over STOMP to our moksha-hub daemon. When a message
arrives, we query bugzilla about the change to get some 'more
interesting' data to stuff in our payload, then we sign the message
using a fedmsg cert and fire it off to the rest of our bus.
This service has no database, no memcached usage. It depends on those
STOMP brokers and being able to query bugzilla.rh.com.
== Relevant Files
All managed by ansible, of course:
....
STOMP config: /etc/moksha/production.ini
fedmsg config: /etc/fedmsg.d/
certs: /etc/pki/fedmsg
code: /usr/lib/python2.7/site-packages/bugzilla2fedmsg.py
....
== Useful Commands
To look at logs, run:
....
$ journalctl -u moksha-hub -f
....
To restart the service, run:
....
$ systemctl restart moksha-hub
....
== Internal Contacts
If we need to contact someone from the RH internal "unified messagebus"
team, search for "unified messagebus" in source.