Installing pagure's web-hooks notification system

=================================================

Web-hooks are a notification system upon which a system makes a http POST

request with some data upon doing an action. This allows notifying a system

that an action has occured.

If you want more information feel free to check out the corresponding page

on wikipedia: `https://en.wikipedia.org/wiki/Webhook

<https: en.wikipedia.org="" webhook="" wiki="">`_.</https:>

Configure your system

---------------------

* Install the required dependencies

::

    python-redis

    python-trollius

    python-trollius-redis

.. note:: We ship a systemd unit file for pagure_webhook but we welcome patches

        for scripts for other init systems.

* Install the files of the web-hook server as follow:

+----------------------------------------------+----------------------------------------------------------+

|              Source                          |                       Destination                        |

+==============================================+==========================================================+

| ``webhook-server/pagure-webhook-server.py``  | ``/usr/libexec/pagure-webhook/pagure-webhook-server.py`` |

+----------------------------------------------+----------------------------------------------------------+

| ``webhook-server/pagure_webhook.service``    | ``/etc/systemd/system/pagure_webhook.service``           |

+----------------------------------------------+----------------------------------------------------------+

The first file is the script of the web-hook server itself.

The second file is the systemd service file.

* Activate the service and ensure it's started upon boot:

::

    systemctl enable redis

    systemctl start redis

    systemctl enable pagure_webhook

    systemctl start pagure_webhook