PLD Linux Distribution

====== fedmsg ======

[[http://www.fedmsg.com/|fedmsg]] (Fedora-Messaging) is a Python package and API used around Fedora Infrastructure to send and receive messages to and from applications.

===== Relay =====

Quick setup from [[http://www.fedmsg.com/en/latest/development/|here]]:

  - install yourself ''fedmsg-relay'' package
  - add to endpoint: <code python /etc/fedmsg.d/endpoints.py>
    endpoints={
        "__main__.HOSTNAME": [
            "tcp://127.0.0.1:4320",
        ]
</code> the **HOSTNAME** is your local host name, see ''hostname(1)''
  - start ''fedmsg-relay'' service.
  - tail the relay messages: ''%%fedmsg-tail --really-pretty & %%''
  - issue a message: ''%%echo "Hello, world" | fedmsg-logger%%''


===== Gateway =====

To have endpoint where to listen all messages, need ''fedmsg-gateway'' daemon.

Install ''fedmsg-gateway'' package, no configuration needed.

Now you can define in your ''endpoints.py'' to listen for pld messages:
<code python endpoints.py>
    endpoints={
        "pld-relay": [
            "tcp://ep09.pld-linux.org:9940",
        ], 
</code>


===== Incoming requests =====

To configure accepting incoming messages on ''tcp/2003'', install ''fedmsg-relay'' package and configure ''relay.py'':

<code python relay.py>
     relay_inbound=[
        "tcp://ep09.pld-linux.org:2003",
     ],
</code>

===== Outgoing requests =====

To configure sending local ''fedmsg-logger'' events to central hub, install ''fedmsg-relay'' package and configure ''relay.py'':

<code python relay.py>
     relay_inbound=[
        "tcp://ep09.pld-linux.org:2003",
     ],
</code>

No need to start relay daemon.
===== anitya =====

[[https://github.com/fedora-infra/anitya|anitya]] is a cross-distribution upstream release monitoring project, under [[https://release-monitoring.org/|https://release-monitoring.org]] address.

To monitor their events via fedmsg:
   * install [[package>fedmsg]] package: <code>$ poldek -u fedmsg</code>
   * configure anitya bus: <code python ~/.fedmsg.d/anitya.py>
# anitya endpoint definition: https://release-monitoring.org/fedmsg
config = dict(
    # This is a dict of possible addresses from which fedmsg can send
    # messages.  fedmsg.init(...) requires that a 'name' argument be passed
    # to it which corresponds with one of the keys in this dict.
    endpoints={
        "anitya-public-relay": [
            "tcp://release-monitoring.org:9940",
        ],
    },
)
</code>
   * tail the changes! <code>
$ fedmsg-tail --really-pretty
</code>