Skip to content

A Jenkins plugin that automatically set up PostgreSQL test databases for Jenkins jobs, easy ;)

License

Notifications You must be signed in to change notification settings

jbox-web/job-database-manager-postgresql

Repository files navigation

Jenkins Job Database Manager Plugin for PostgreSQL

GitHub license GitHub release Build Status Code Climate Download

A Jenkins plugin that automatically set up PostgreSQL test databases for Jenkins jobs, easy ;)

Installation

Install the ruby-runtime plugin in Jenkins then download the hpi file and install it within Jenkins interface.

Configuration

In the global Jenkins configuration, set up host and port of your PostgreSQL server and enter credentials of the PostgreSQL user that shall be used to create databases and grant permissions. Note that this user needs at least CREATEDB and CREATEROLE permissions.

Usage

Configure a database name in a job. The plugin ensures the database exists when the job is run. It grants all permissions for the database to a job specific user and publishes its credentials in the environment variables $PGSQL_USER and $PGSQL_PASSWORD. It also ensures that the database is dropped at the end of the job.

These environment variables will be injected in the build :

  • $PGSQL_DATABASE
  • $PGSQL_USER
  • $PGSQL_PASSWORD
  • $PGSQL_HOST
  • $PGSQL_PORT

See also

There is also a MySQL variant of this plugin : jbox-web/job-database-manager-mysql

Contributors

A big thank to them for their contribution!

Contribute

You can contribute to this plugin in many ways such as :

  • Helping with documentation
  • Contributing code (features or bugfixes)
  • Reporting a bug
  • Submitting translations