diff --git a/pagure-ci/README.rst b/pagure-ci/README.rst index 0ab6362..9dac42e 100644 --- a/pagure-ci/README.rst +++ b/pagure-ci/README.rst @@ -9,76 +9,5 @@ dependencies are resolved. PAGURE_CONFIG=/path/to/config PYTHONPATH=. python pagure-ci/pagure_ci_server.py - -Configure 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 Plugin `_ - * `Notification Plugin `_ - - -Configure your project on Jenkins -================================= - -* Start by enabling the `Pagure CI` hook in the settings of your project on - pagure. This will provide you two values needed to configure your project - on jenkins: a token and an URL that jenkins calls to return the results - of a build. - -* Go to the `Configure` page of your project - -* 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 checkbox `This build is parameterized` - -* Add two `String Parameters` named 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 specify the token - given by pagure. - -* Under Build -> Add build step -> Execute Shell - -* In the box given enter the shell steps you want for testing your project. - - -Example Script - -:: - - # Script specific for Pull-Request build - 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 - - # Part of the script specific to how you run the tests on your project +Check `doc/usage/pagure_ci.rst` for further information on how to set up +and configure your project on both pagure and the CI services