|
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
|
|
Igor Gnatenko |
33bdca |
python-trololio
|
|
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
|