A Jenkins plugin to integrate DeployDB
Go to file
Christopher Orr 8f6df782db Add release instructions to the README. 2015-04-02 17:00:37 -07:00
gradle/wrapper Add Gradle build setup. 2015-03-19 11:20:52 -07:00
src Merge pull request #19 from lookout/issue/18 2015-04-02 15:04:41 -07:00
.gitignore Update .gitignore. 2015-03-19 11:19:01 -07:00
.travis.yml Add --stacktrace to Travis CI Gradle test command. 2015-04-02 15:13:12 -07:00
LICENSE Initial commit 2015-03-16 09:43:20 -07:00
README.md Add release instructions to the README. 2015-04-02 17:00:37 -07:00
build.gradle Prepare for 0.1 release. 2015-04-02 15:52:24 -07:00
gradlew Add Gradle build setup. 2015-03-19 11:20:52 -07:00
gradlew.bat Add Gradle build setup. 2015-03-19 11:20:52 -07:00

README.md

DeployDB Plugin for Jenkins

Build Status

Triggers builds based on incoming DeployDB webhooks, and reports the results back to DeployDB.

Webhook configuration

Your DeployDB installation should be configured to send all webhook events to $JENKINS_BASE_URL/deploydb/trigger

Jenkins should be configured with the base URL to your DeployDB instance, so that it knows where build results should be reported to: Manage Jenkins → Configure System → DeployDB.

Development

This plugin is built with the Jenkins Gradle plugin.

To start an instance of Jenkins at http://localhost:8080/ with the plugin installed:
./gradlew server

To run the test cases:
./gradlew test

To build the plugin, ready for installation into Jenkins:
./gradlew jpi

The plugin will be written to build/libs/deploydb-jenkins.hpi.

Release

One-time preparation

  • You must have a Jenkins account
  • Add your credentials to ~/.jenkins-ci.org in the following form:
userName=...
password=...

For each release

To publish a plugin update to the Jenkins update centre:

  • Update the top-level version property in build.gradle
  • Commit: git commit -am "Preparing for release ${VERSION}."
  • Tag: git tag deploydb-jenkins-plugin-${VERSION}
  • Push: git push && git push --tags
  • Release: ./gradlew clean publish

Assuming the Gradle build went well, you can confirm here that the release was uploaded correctly: http://repo.jenkins-ci.org/releases/org/jenkins-ci/plugins/deploydb/

The plugin update should appear in the Jenkins update centre within four to eight hours.