mabl Jenkins Plugin
This plugin allows easy launching of mabl journeys as a step in your Jenkins build. Your Jenkins build outcome will be tied to that of your deployment event.
See official mabl plugin site for documentation.
Install the plugin into your Jenkins
v1.580+ server from the Available Plugins tab by searing for "mabl".
Building from Source
- Clone this repo
- build with
mvn clean package
- Copy the plugin in
target/mabl-integration.hpito your Jenkins
- Restart Jenkins
You can also install the
.hpi file from the web UI by visting
Jenkins > Manage Jenkins > Manager Plugins > Advanced > Upload Plugin.
Creating a mabl Build Step
- Create or edit a Jenkins project
- Select Run mabl journeys from the Add build step drop down list
- Copy your API key,
application_idfrom the API Settings Page
- Save and run your build
Overview of how to launch a Jenkins Docker instance with Jenkins, then build the plugin and deploy it that instance.
# Launch Jenkins docker run -d -p 9090:8080 --name=jenkins-master jenkins # Setup your Jenkins instance # Build and deploy plugin to Jenkins (make sure you're in the mabl-integration-plugin directory) mvn clean package \ && docker cp target/mabl-integration.hpi jenkins-master:/var/jenkins_home/ \ && docker restart jenkins-master
Before making a new plugin release, ensure code is in high quality, fully tested state. See extra checks.
- Update your
~/.m2/settings.xmlaccording to the Jenkins docs.
- Setup and run a GitHub ssh agent.
mvn release:prepare release:perform -Bfrom the HEAD of master
mvn deployon sucess of above step.
Wait ~8 hours for plugin to become GA across all Jenkins instances under the "Available Plugins" listing.