pagure/pagureCI

Pagure CI
=========

This is to setup Pagure CI for development. It is assumed that all the
dependencies are resolved. It is advised to use a virtual envivironment
for development.

* Run::

python setup.py develop


Now in pagureCI/consumer.py add the following elements in `topic` list

::

'org.fedoraproject.dev.pagure.pull-request.new',
'org.fedoraproject.dev.pagure.pull-request.comment.added',


Configuring Jenkins
===================

Jenkins configuration is the most important part of how the Pagure CI works,
after you login to your Jenkins Instance.


* Go to Manage Jenkins -> Configuire Global Security and under that select
'Project-based Matrix Authorization Strategy'

* Add a user and give all the permission to that user.

* Download the following plugins:

::

Build Authorization Root Plugin
Git Plugins
Notification Plugin


* Click on the New Item

* Select Freestyle Project

* Click OK and enter the name of the project, make sure the project name you
filled in the Pagure CI form should match the name you entered here.

* Under 'Job Notification' click 'Add Endpoint'

* Fields in Endpoint will be :

::

FORMAT: JSON
PROTOCOL: HTTP
EVENT: Job Finalized
URL:
TIMEOUT: 3000
LOG: 1

* Tick the build is parameterized

* From the Add Parameter drop down select String Parameter

* Two string parameters need to be created REPO and BRANCH

* Source Code Management select Git and give the URL of the pagure project

* Under Build Trigger click on Trigger build remotely and give the same token
that you gave in the Pagure CI form.

* Under Build -> Add build step -> Execute Shell

* In the box given enter the shell steps you want for testing your project.


Example Script

::

if [ -n "$REPO" -a -n "$BRANCH" ]; then
git remote rm proposed || true
git remote add proposed "$REPO"
git fetch proposed
git checkout origin/master
git config --global user.email "you@example.com"
git config --global user.name "Your Name"
git merge --no-ff "proposed/$BRANCH" -m "Merge PR"
fi

* After all the configuration done, go to the dev instance of pagure running
and under project settings in `Plugin` select Pagure CI and fill the appropriate
information. Which on submiting should give you a POST url.

* Copy and paste the URL in the Notification section under the Jenkins project
you want the CI to work,


Get It Running:
===============

In one terminal window run:

::

fedmsg-relay

Another window:

::

fedmsg-hub

* Now clone the project locally and make a branch. make some changes and push it
to the repo and try to make a PR. You will notice if everything works fine a lot
of logs in the server console and `build fail` flag on the PR.
Build fail because there is no git server running.