Blame doc/install_pagure_loadjson.rst

Pierre-Yves Chibon 1a6c11
Installing pagure-loadjson
Pierre-Yves Chibon 1a6c11
==========================
Pierre-Yves Chibon 1a6c11
Pierre-Yves Chibon 1a6c11
pagure-loadjson is the service that updates the database based on the content
Pierre-Yves Chibon 1a6c11
of the JSON blob pushed into the ticket git repository (and in the future
Pierre-Yves Chibon 1a6c11
for pull-requests as well).
Pierre-Yves Chibon 1a6c11
Pierre-Yves Chibon 1a6c11
Pierre-Yves Chibon 1a6c11
Configure your system
Pierre-Yves Chibon 1a6c11
---------------------
Pierre-Yves Chibon 1a6c11
Pierre-Yves Chibon 1a6c11
* Install the required dependencies
Pierre-Yves Chibon 1a6c11
Pierre-Yves Chibon 1a6c11
::
Pierre-Yves Chibon 1a6c11
Pierre-Yves Chibon 1a6c11
    python-redis
Pierre-Yves Chibon 1a6c11
    python-trollius
Pierre-Yves Chibon 1a6c11
Pierre-Yves Chibon 1a6c11
.. note:: We ship a systemd unit file for pagure_loadjson but we welcome patches
Pierre-Yves Chibon 1a6c11
        for scripts for other init systems.
Pierre-Yves Chibon 1a6c11
Pierre-Yves Chibon 1a6c11
Pierre-Yves Chibon 1a6c11
* Install the files of pagure-loadjon as follow:
Pierre-Yves Chibon 1a6c11
Pierre-Yves Chibon 1a6c11
+--------------------------------------------------+----------------------------------------------------+
Pierre-Yves Chibon 1a6c11
|              Source                              |                   Destination                      |
Pierre-Yves Chibon 1a6c11
+==================================================+====================================================+
Pierre-Yves Chibon 1a6c11
| ``pagure-loadjson/pagure_loadjson_server.py``    | ``/usr/libexec/pagure-loadjson/pagure_loadjson.py``|
Pierre-Yves Chibon 1a6c11
+--------------------------------------------------+----------------------------------------------------+
Pierre-Yves Chibon 1a6c11
| ``pagure-loadjson/pagure_loadjson.service``      | ``/etc/systemd/system/pagure_loadjson.service``    |
Pierre-Yves Chibon 1a6c11
+--------------------------------------------------+----------------------------------------------------+
Pierre-Yves Chibon 1a6c11
Pierre-Yves Chibon 1a6c11
The first file is the pagure-loadjson service itself, triggered by the git
Pierre-Yves Chibon 1a6c11
hook (shipped with pagure itself) and loading the JSON files into the database.
Pierre-Yves Chibon 1a6c11
Pierre-Yves Chibon 1a6c11
The second file is the systemd service file.
Pierre-Yves Chibon 1a6c11
Pierre-Yves Chibon 1a6c11
Pierre-Yves Chibon 1a6c11
* Activate the service and ensure it's started upon boot:
Pierre-Yves Chibon 1a6c11
Pierre-Yves Chibon 1a6c11
::
Pierre-Yves Chibon 1a6c11
Pierre-Yves Chibon 1a6c11
    systemctl enable redis
Pierre-Yves Chibon 1a6c11
    systemctl start redis
Pierre-Yves Chibon 1a6c11
    systemctl enable pagure_loadjson
Pierre-Yves Chibon 1a6c11
    systemctl start pagure_loadjson