jenkins/sap-jenkins-library

Fork 0

mirror of https://github.com/SAP/jenkins-library.git synced 2024-12-14 11:03:09 +02:00

Christopher Fenner a7f1ec0bad

add note regarding false aggregation

2018-02-12 08:41:12 +01:00

5.9 KiB

Raw Blame History

checksPublishResults

Description

This step can publish static check results from various sources.

Prerequisites

static check result files - To use this step, there must be static check result files available.
installed plugins:
- pmd
- dry
- findbugs
- checkstyle
- warnings
- core

Parameters

parameter	mandatory	default	possible values
aggregation	no	`true`	see below
tasks	no	`false`	see below
pmd	no	`false`	see below
cpd	no	`false`	see below
findbugs	no	`false`	see below
checkstyle	no	`false`	see below
eslint	no	`false`	see below
pylint	no	`false`	see below
archive	no	`false`	`true`, `false`

aggregation - Publishes .
tasks - Searches and publishes TODOs in files with the Task Scanner Plugin.
pmd - Publishes PMD findings with the PMD plugin .
cpd - Publishes CPD findings with the DRY plugin.
findbugs - Publishes Findbugs findings with the Findbugs plugin.
checkstyle - Publishes Checkstyle findings with the Checkstyle plugin.
eslint - Publishes ESLint findings (in JSLint format) with the Warnings plugin.
pylint - Publishes PyLint findings with the Warnings plugin, pylint needs to run with --output-format=parseable option.

Each of the parameters aggregation, tasks, pmd, cpd, findbugs, checkstyle, eslint and pylint can be set to true or false but also to a map of parameters to hand in different settings for the tools.

aggregation

parameter	mandatory	default	possible values
thresholds	no	none	see thresholds

tasks

parameter	mandatory	default	possible values
pattern	no	`'*/.java'`
archive	no	`true`	`true`, `false`
high	no	`'FIXME'`
normal	no	`'TODO,REVISE,XXX'`
low	no
thresholds	no	none	see thresholds

pmd

parameter	mandatory	default	possible values
pattern	no	`'**/target/pmd.xml'`
archive	no	`true`	`true`, `false`
thresholds	no	none	see thresholds

cpd

parameter	mandatory	default	possible values
pattern	no	`'**/target/cpd.xml'`
archive	no	`true`	`true`, `false`
thresholds	no	none	see thresholds

findbugs

parameter	mandatory	default	possible values
pattern	no	`'/target/findbugsXml.xml, /target/findbugs.xml'`
archive	no	`true`	true, false
thresholds	no	none	see thresholds

checkstyle

parameter	mandatory	default	possible values
pattern	no	`'**/target/checkstyle-result.xml'`
archive	no	`true`	`true`, `false`
thresholds	no	none	see thresholds

eslint

parameter	mandatory	default	possible values
pattern	no	`'**/eslint.jslint.xml'`
archive	no	`true`	`true`, `false`
thresholds	no	none	see thresholds

pylint

parameter	mandatory	default	possible values
pattern	no	`'**/pylint.log'`
archive	no	`true`	`true`, `false`
thresholds	no	none	see thresholds

Thresholds

It is possible to define thresholds to fail the build on a certain count of findings. To achive this, just define your thresholds a followed for the specific check tool:

thresholds: [fail: [all: 999, low: 99, normal: 9, high: 0]]

This way, the jenkins will fail the build on 1 high issue, 10 normal issues, 100 low issues or a total issue count of 1000.

The thresholds parameter can be set for aggregation, tasks, pmd, cpd, findbugs, checkstyle, eslint and pylint.

checksPublishResults(
    tasks: true,
    pmd: [pattern: '**/target/pmd-results.xml', thresholds: [fail: [low: 100]]],
    cpd: [archive: false],
    aggregation: [thresholds: [fail: [high: 0]]],
    archive: true
)

Return value

none

Side effects

If both ESLint and PyLint results are published, they are not correctly aggregated in the aggregator plugin.

Exceptions