Bitbucket/Stash Pull Request Coverage Status Plugin for Jenkins

• Overview
• Supports coverage reports
• How to use
  • Install Plugin
  • Configure access to Bitbucket
  • Configure master coverage source
  • Jenkins build
  • Sonar
  • Publish coverage for Pull Request
  • Bitbucket Pull Request Builder Plugin
  • Branch API Plugin
  • Other
• How to use with Jenkins Pipelines
• Troubleshooting
• Changelog

Overview

Parse code coverage report generated by build and post code coverage status comment to Bitbucket pull request:

Supports coverage reports

• Jacoco jacoco.xml
• Cobertura cobertura.xml or cobertura-coverage.xml
• Clover clover.xml
• SimpleCov JSON (Ruby) coverage.json

How to use

Install Plugin

• Install plugin from Jenkins Plugin Repository
• Or manually
  • Goto releases
  • Download latest version of plugin .hpi file
  • Install to your Jenkins guide

Configure master/reference coverage source

To be able compare Pull Request coverage plugin needs master/reference coverage for Bitbucket repository.

Jenkins build

• Add Record Master Coverage post build step to build which tests your master/target branches. Coverage will be stored per repository URL and branch name.

Sonar

You have the option to get the master coverage (base coverage) from your SonarQube instance. Otherwise the plugin will keep track of the master coverage in the project configuration file.

• Goto Manage Jenkins
• Find section Coverage status for Bitbucket Pull Requests
• Fill Sonar URL field - e.g. http://sonar.mycompany.com
• Turn On Use Sonar for master coverage
• Optionally use can specify your personal Sonar access token.
• The next pull request build will use SonarQube as the the source for master coverage

The plugin will try to find the project in SonarQube based on the repository name. If more than one projects match, a warning is logged, and the first one will be used to get the coverage data.

Publish coverage for pull request

Depends on plugin which you are using to run (trigger) pull request in Jenkins.

Stash Pull Request Builder Plugin

• To Jenkins Job triggered by Bitbucket pull request builder plugin add Publish coverage to Bitbucket post build step
• Ensure that build create code coverage report file

Branch API Plugin

• To Jenkins Job triggered by Branch API Plugin add Publish coverage to Bitbucket post build step
• Ensure that build create code coverage report file

Other

• Before Publish coverage to Bitbucket step inject CHANGE_ID and CHANGE_URL to build envs where first one is Pull Request ID (number) and second link to repository
• Add Publish coverage to Bitbucket post build step to build
• Ensure that build create code coverage report file

How to use with Jenkins Pipelines

• After running tests set build result to Success
  • currentBuild.result = 'SUCCESS'
• Trigger MasterCoverageAction to collect master coverage
  • step([$class: 'MasterCoverageAction'])
• Trigger CompareCoverageAction to compare coverage and publish results
  • step([$class: 'CompareCoverageAction'])
  • Optionally use can specify here sonar login and sonar password like this: step([$class: 'CompareCoverageAction', sonarLogin: "login", sonarPassword: "password"])

Troubleshooting

No coverage picture and my Jenkins is in private network and not accessible for Bitbucket

Because of that Bitbucket can't render icon picture hosted on Jenkins. Plugin can use http://shields.io public resource instead of Jenkins hosted picture. To use it:

• Goto Jenkins Configuration
• Turn on Jenkins is not accessible for Bitbucket
• Done next coverage comment in Pull Request will use http://shields.io

No coverage picture on Bitbucket Pull Request Page

If you see next picture on your pull request in Bitbucket:

In most cases that mean that your Jenkins runs on http instead of https Plugin uses same protocol as your Jenkins, however Bitbucket in most cases accessible by https Default browser policy to block non secure resources on secure pages from unknown domain.

To fix that:

1. Configure Jenkins to be accessible for https https://wiki.jenkins-ci.org/display/JENKINS/Starting+and+Accessing+Jenkins
2. Next you have a few options:
   • Run your Jenkins on https only
   • Or configure plugin to publish link on picture over https
   • Open Jenkins
   • Click Manage Jenkins
   • Click Configure System
     • Find section Coverage status for Bitbucket Pull Requests
     • Find property Jenkins URL for icon in Pull Request
     • Put URL to your Jenkins with https like https://jenkins.my.com
     • Save
   • Restart Jenkins

Changelog

0.0.1

• Forked project from github-pr-coverage-status-plugin to bitbucket-pr-coverage-status-plugin
• Moved global plugin variables to job specific ones
• Stores branch name with coverage to support multi branch coverage reports
• Add parameter "decreased coverage is red"

1.9.1

• Allow to disable SimpleCov Coverage parser

1.9.0

• Add support of Workflow SCM Step Plugin

1.8.2

• Fix Master showing 0% even after RecordMasterCoverage is run

1.8.0

• Sonar token & login/password authentication

1.7.1

• SimpleCov JSON report fix coverage

1.7.0

• Support of https://github.com/jenkinsci/branch-api-plugin
• Support for Jenkins Pipeline

1.6.1

• Support single quotes for Cobertura Report

1.6.0

• Cobertura plugin ignores zero for lineRate or branchRate as result lineRate=0 branchRate=0.5 => Coverage 25% became 0.5 as lineRate=0, same policy for branchRate
• Log Enchacements

1.5.0

Supporting Master Coverage from SonarQube. Check (details)[#master-coverage-from-sonar]

1.4.0

Supporting of private Jenkins with public Bitbucket. To enable that mode goto Jenkins Configuration and turn on Jenkins is not accessible for Bitbucket

1.3.0

Add support SimpleCov JSON coverage report for Ruby

1.2.0

Add alternative text to coverage image for case when Bitbucket doesn't able to show image

1.1.1

Correct parsing Cobertura report for edge cases

1.0.8

First public release to Jenkins Plugin Repo