jenkins-build
Installation
Install it from rubygems.org:
gem install jenkins-build
Usage
First, you need to get your user and API Key for Jenkins. To do that you need to log in, in the right corner click your name, then click Configure in the left sidebar and finally press 'Show API Token'.
You'll need later both the User ID (JENKINS_USER_ID) and API Token (JENKINS_API_TOKEN).
You also need the domain where you have your jenkins server running (JENKINS_SERVER_URL) and the job you want to run (JENKINS_JOB_NAME)
Then you have to configure jenkins-build
to use your jenkins server and
project. Do that by running:
jenkins-build configure --api-key JENKINS_API_TOKEN --user JENKINS_USER_ID --server JENKINS_SERVER_URL --project JENKINS_JOB_NAME
And then you can trigger build by running:
jenkins-build trigger
Or you can get failures from specific build:
jenkins-build failures --build=2372
If you don't supply build number, it will try to detect it via hub
command from github status.
Development
After checking out the repo, run bin/setup
to install dependencies. Then, run
bin/console
for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run bundle exec rake install
. To
release a new version, update the version number in version.rb
, and then run
bundle exec rake release
to create a git tag for the version, push git commits
and tags, and push the .gem
file to rubygems.org.
Contributing
- Fork it ( https://github.com/3scale/jenkins-build/fork )
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create a new Pull Request