Skip to content

Latest commit

 

History

History
48 lines (31 loc) · 1.62 KB

README.md

File metadata and controls

48 lines (31 loc) · 1.62 KB
Raw

GBIF Deploy Plugin

Jenkins plugin that automates the deployment of GBIF web services.

For information of how to develop Jenkins plugins, please follow this link.

Requirements

This plugin requires:

  • Git must be installed in the Jenkins machine where it runs.
  • A Jenkins system StandardUsernamePasswordCredentials must be defined which has contain Git credentials to access the Github repos https://github.com/gbif/c-deploy and https://github.com/gbif/gbif-configuration. The odd behaviour of resetting the credential after a Jenkins restart is necessary here.
  • The option "Delete workspace before build" must be selected (otherwise c-deploy isn't updated; TODO)
  • Ansible 1.7.1
  • Python 2.7.5
  • Python libraries: requests, kazoo and pip.
  • A key stored in ~/.ssh/id_rsa will be used to connect to the servers contacted by the Ansible playbooks.

Functionality

This plugin can be used to deploy a single service or an entire environment; to deploy an entire environment the plugin can be added as post-build step without selecting a GBIF service.

Configuration

All the required configuration is taken from the GBIF Github repos https://github.com/gbif/c-deploy and https://github.com/gbif/gbif-configuration.

Debugging

$ export MAVEN_OPTS="-Xdebug -Xrunjdwp:transport=dt_socket,server=y,address=8000,suspend=n"
$ mvn hpi:run

Distributing

$ mvn package

Releasing

To release this plugin use the Maven command

$ mvn release:prepare release:perform

For more information see https://wiki.jenkins-ci.org/display/JENKINS/Hosting+Plugins