Blame doc/install_pagure_ci.rst

Pierre-Yves Chibon 499dad
Installing pagure-ci
Pierre-Yves Chibon 499dad
====================
Pierre-Yves Chibon 499dad
Pierre-Yves Chibon 499dad
A CI stands for `Continuous Integration
Pierre-Yves Chibon 499dad
<https: continuous_integration="" en.wikipedia.org="" wiki="">`_. Pagure can be</https:>
Pierre-Yves Chibon 499dad
configured to integrate results coming from CI services, such as `Jenkins
Pierre-Yves Chibon 499dad
<https: en.wikipedia.org="" jenkins_(software)="" wiki="">`_ on pull-request opened</https:>
Pierre-Yves Chibon 499dad
against the project.
Pierre-Yves Chibon 499dad
Pierre-Yves Chibon 499dad
Pierre-Yves Chibon 499dad
.. note: Currently, pagure only supports `Jenkins` but we welcome help to
Pierre-Yves Chibon 499dad
  integrate pagure with other services such as `travis-ci
Pierre-Yves Chibon 499dad
  <https: en.wikipedia.org="" travis_ci="" wiki="">`_.</https:>
Pierre-Yves Chibon 499dad
Pierre-Yves Chibon 499dad
Pierre-Yves Chibon 499dad
Configure your system
Pierre-Yves Chibon 499dad
---------------------
Pierre-Yves Chibon 499dad
Pierre-Yves Chibon 499dad
* Install the required dependencies
Pierre-Yves Chibon 499dad
Pierre-Yves Chibon 499dad
::
Pierre-Yves Chibon 499dad
Pierre-Yves Chibon 499dad
    python-jenkins
Pierre-Yves Chibon 499dad
    python-redis
Pierre-Yves Chibon 499dad
    python-trollius
Pierre-Yves Chibon 499dad
Pierre-Yves Chibon 499dad
.. note:: We ship a systemd unit file for pagure_ci but we welcome patches
Pierre-Yves Chibon 499dad
        for scripts for other init systems.
Pierre-Yves Chibon 499dad
Pierre-Yves Chibon 499dad
Pierre-Yves Chibon 499dad
* Install the files of pagure-ci as follow:
Pierre-Yves Chibon 499dad
Pierre-Yves Chibon 499dad
+--------------------------------------+---------------------------------------------------+
Pierre-Yves Chibon 499dad
|              Source                  |                   Destination                     |
Pierre-Yves Chibon 499dad
+======================================+===================================================+
Pierre-Yves Chibon 499dad
| ``pagure-ci/pagure_ci_server.py``    | ``/usr/libexec/pagure-ci/pagure_ci_server.py``    |
Pierre-Yves Chibon 499dad
+--------------------------------------+---------------------------------------------------+
Pierre-Yves Chibon 499dad
| ``pagure-ci/pagure_ci.service``      | ``/etc/systemd/system/pagure_ci.service``         |
Pierre-Yves Chibon 499dad
+--------------------------------------+---------------------------------------------------+
Pierre-Yves Chibon 499dad
Pierre-Yves Chibon 499dad
The first file is the pagure-ci service itself, triggering the build on the
Pierre-Yves Chibon 499dad
CI service when there is a new pull-request or a change to an existing one.
Pierre-Yves Chibon 499dad
Pierre-Yves Chibon 499dad
The second file is the systemd service file.
Pierre-Yves Chibon 499dad
Pierre-Yves Chibon 499dad
* Configure your pagure instance to support CI, add the following to your
Pierre-Yves Chibon 499dad
  configuration file
Pierre-Yves Chibon 499dad
Pierre-Yves Chibon 499dad
::
Pierre-Yves Chibon 499dad
Pierre-Yves Chibon 499dad
    PAGURE_CI_SERVICES = ['jenkins']
Pierre-Yves Chibon 499dad
Pierre-Yves Chibon 499dad
* Activate the service and ensure it's started upon boot:
Pierre-Yves Chibon 499dad
Pierre-Yves Chibon 499dad
::
Pierre-Yves Chibon 499dad
Pierre-Yves Chibon 499dad
    systemctl enable redis
Pierre-Yves Chibon 499dad
    systemctl start redis
Pierre-Yves Chibon 499dad
    systemctl enable pagure_ci
Pierre-Yves Chibon 499dad
    systemctl start pagure_ci