1
0

install_pagure_webhooks.rst 1.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748
  1. Installing pagure's web-hooks notification system
  2. =================================================
  3. Web-hooks are a notification system upon which a system makes a http POST
  4. request with some data upon doing an action. This allows notifying a system
  5. that an action has occurred.
  6. If you want more information feel free to check out the corresponding page
  7. on wikipedia: `https://en.wikipedia.org/wiki/Webhook
  8. <https://en.wikipedia.org/wiki/Webhook>`_.
  9. Configure your system
  10. ---------------------
  11. * Install the required dependencies
  12. ::
  13. python-redis
  14. python-trololio
  15. .. note:: We ship a systemd unit file for pagure_webhook but we welcome patches
  16. for scripts for other init systems.
  17. * Install the files of the web-hook server as follow:
  18. +----------------------------------------------+----------------------------------------------------------+
  19. | Source | Destination |
  20. +==============================================+==========================================================+
  21. | ``pagure-webhook/pagure-webhook-server.py`` | ``/usr/libexec/pagure-webhook/pagure-webhook-server.py`` |
  22. +----------------------------------------------+----------------------------------------------------------+
  23. | ``pagure-webhook/pagure_webhook.service`` | ``/etc/systemd/system/pagure_webhook.service`` |
  24. +----------------------------------------------+----------------------------------------------------------+
  25. The first file is the script of the web-hook server itself.
  26. The second file is the systemd service file.
  27. * Activate the service and ensure it's started upon boot:
  28. ::
  29. systemctl enable redis
  30. systemctl start redis
  31. systemctl enable pagure_webhook
  32. systemctl start pagure_webhook