Contents
- 1 External
- 2 Internal
- 3 Scripted Pipeline
- 3.1 Scripted Pipeline at Runtime
- 3.2 Scripted Pipeline Failure Handling
- 4 Declarative Pipeline
- 4.1 Declarative Pipeline Directives
- 4.1.1 environment
- 4.1.2 parameters
- 4.2 Declarative Pipeline Failure Handling
- 4.1 Declarative Pipeline Directives
- 5 Parameters
- 6 Environment Variables
- 7 Pipeline Steps
- 7.1 node
- 7.2 stage
- 7.3 parallel
- 7.4 sh
- 7.4.1 sh — Script Return Status
- 7.4.2 sh — Script stdout
- 7.4.3 sh — Obtaining both the Return Status and stdout
- 7.4.4 sh — Obtaining stdout and Preventing the Pipeline to Fail on Error
- 7.4.5 sh — Label
- 7.5 ws
- 7.6 build
- 7.7 junit
- 7.8 checkout
- 7.8.1 Git Plugin
- 7.9 withCredentials
- 7.10 Basic Steps
- 7.10.1 echo
- 7.10.2 error
- 7.10.3 stash
- 7.10.4 input
- 7.10.5 timeout
- 7.10.6 withEnv
- 7.10.7 catchError
- 7.11 Basic Steps that Deal with Files
- 7.11.1 dir
- 7.11.2 deleteDir
- 7.11.3 pwd
- 7.11.4 readFile
- 7.11.5 writeFile
- 7.11.6 fileExists
- 7.11.7 findFiles
- 7.12 Core
- 7.12.1 archiveArtifacts
- 7.12.2 fingerprint
- 8 Obtaining the Current Pipeline Build Number
- 9 FlowInterruptedException
- 10 Navigating the Project Model Hierarchy
- 11 Passing an Environment Variable from Downstream Build to Upstream Build
- 12 @NonCPS
- 13 Build Summary
- 14 Dynamically Loaded Classes and Constructors
- 15 Fail a Build
- 16 Dynamically Loading Groovy Code from Repository into a Pipeline
- 17 Groovy on Jenkins Idiosyncrasies
- 17.1 Prefix Static Method Invocations with Declaring Class Name when Calling from Subclass
External
- https://jenkins.io/doc/book/pipeline/syntax/
- https://jenkins.io/doc/pipeline/steps/
- https://jenkins.io/doc/pipeline/steps/core/
Internal
- Jenkins Concepts
- Writing a Jenkins Pipeline
- Simple Pipeline Configuration
Scripted Pipeline
- https://www.jenkins.io/doc/book/pipeline/syntax/#scripted-pipeline
Scripted Pipeline is classical way of declaring Jenkins Pipeline, preceding Declarative Pipeline. Unlike the Declarative Pipeline, the Scripted Pipeline is a general-purpose DSL built with Groovy. The pipelines are declared in Jenkinsfiles and executed from the top of the Jenkinsfile downwards, like most traditional scripts in Groovy. Groovy syntax is available directly in the Scripted Pipeline declaration. The flow control can be declared with if
/else
conditionals or via Groovy’s exception handling support with try
/catch
/finally
.
The simplest pipeline declaration:
A more complex one:
node('some-worker-label') { echo 'Pipeline logic starts' stage('Build') { if (env.BRANCH_NAME == 'master') { echo 'this is only executed on master' } else { echo 'this is executed elsewhere' } } stage('Test') { // ... } stage('Deploy') { // ... } stage('Example') { try { sh 'exit 1' } catch(ex) { echo 'something failed' throw } } }
The basic building block of the Scripted Pipeline syntax is the step. The Scripted Pipeline does not introduce any steps that are specific to its syntax. The generic pipeline steps, such as node, stage, parallel, etc. are available here: Pipeline Steps.
Scripted Pipeline at Runtime
When the Jenkins server starts to execute the pipeline, it pulls the Jenkinsfile either from a repository, following a checkout sequence similar to the one shown here, or from the pipeline configuration, if it is specified in-line. Then the Jenkins instance instantiates a WorkflowScript (org.jenkinsci.plugins.workflow.cps.CpsScript.java) instance. The «script» instance can be used to access the following state elements:
- pipeline parameters, with
this.params
, which is a Map.
Scripted Pipeline Failure Handling
Scripted pipeline fail when an exception is thrown and reached the pipeline layer. The pipeline code can use try/catch/finally
semantics to control this behavior, by catching the exceptions and preventing them from reaching the pipeline layer.
stage('Some Stage') { try { throw new Exception ("the build has failed") } catch(Exception e) { // squelch the exception, the pipeline will not fail } }
The pipeline also fails when a command invoked with sh exits with a non-zero exit code. The underlying implementation throws an exception and that makes the build fail. It is possible to configure sh to not fail the build automatically on non-zero exit code, with its returnStatus option.
The first failure in a sequential execution will stop the build, no subsequent stages will be executed. The stage that caused the failure will be shown in red in Blue Ocean (in the example below, there were three sequential stages but stage3 did not get executed):
In this case the corresponding stage and the entire build will be marked as ‘FAILURE’.
A build can be programmatically marked as fail by setting the value of the currentBuild.result variable:
currentBuild.result = 'FAILURE'
The entire build will be marked as failed (‘FAILURE’, ‘red’ build), but the stage in which the variable assignment was done, stage2 in this case, will not show as failed:
The opposite behavior of marking a specific stage as failed (‘FAILURE’), but allowing the overall build to be successful can be obtained by using the catchError basic step:
stage('stage2') { catchError(buildResult: 'SUCCESS', stageResult: 'FAILURE') { throw new RuntimeException("synthetic") } }
The result is a failed ‘stage2’ but a successful build:
A stage result and the entire build result may be also influenced by the JUnit test report produced for the stage, if any. If the test report exists and it is processed by the junit step, and if the report contains test errors and failures, they’re both handled as «instability» of the build and the corresponding stage and the entire build will be marked as UNSTABLE. The classic view and Blue ocean will render a yellow stage and build:
Also see junit below and:
- currentBuild.result
- currentBuild.currentResult
Declarative Pipeline
- https://www.jenkins.io/doc/book/pipeline/syntax/#declarative-pipeline
Declarative Pipeline is a new way of declaring Jenkins pipelines, and consists in a more simplified and opinionated syntax. Declarative Pipeline is an alternative to Scripted Pipeline.
pipeline { agent any options { skipStagesAfterUnstable() } stages { stage('Build') { steps { sh 'make' } } stage('Test'){ steps { sh 'make check' junit 'reports/**/*.xml' } } stage('Deploy') { steps { sh 'make publish' } } } }
Declarative Pipeline Directives
environment
- https://jenkins.io/doc/book/pipeline/syntax/#environment
See:
- Jenkins Pipeline Environment Variables
parameters
- https://jenkins.io/doc/book/pipeline/syntax/#parameters
See:
- Jenkins Pipeline Parameters
Declarative Pipeline Failure Handling
TODO: https://www.jenkins.io/doc/book/pipeline/jenkinsfile/#handling-failure
Parameters
- Jenkins Pipeline Parameters
Environment Variables
- Jenkins Pipeline Environment Variables
Pipeline Steps
- https://jenkins.io/doc/pipeline/steps/
node
- https://jenkins.io/doc/pipeline/steps/workflow-durable-task-step/#-node-allocate-node
Allocates an executor or a node, typically a worker, and runs the enclosed code in the context of the workspace of that worker. Node may take a label name, computer name or an expression. The labels are declared on workers when they are defined in the master configuration, in their respective «clouds».
String NODE_LABEL = 'infra-worker' node(NODE_LABEL) { sh 'uname -a' }
stage
- https://www.jenkins.io/doc/pipeline/steps/pipeline-stage-step/#stage-stage
The stage
step defines a logical stage of the pipeline. The stage
creates a labeled block in the pipeline and allows executing a closure in the context of that block:
stage('stage A') { print 'pipeline> in stage A' } stage('stage B') { print 'pipeline> in stage B' }
Embedded stages as in this example are possible, and they will execute correctly, but they do not render well in Blue Ocean (Stage A.1 and Stage A.2 are not represented, just Stage A and B):
stage('stage A') { print('pipeline> in stage A') stage('stage A.1') { print('pipeline> in stage A.1') } stage('stage A.2') { print('pipeline> in stage A.1') } } stage('stage B') { print('pipeline> in stage B') } }
To control failure behavior at stage level, use catchError step, described below.
parallel
- https://www.jenkins.io/doc/pipeline/steps/workflow-cps/#parallel-execute-in-parallel
Takes a map from branch names to closures and an optional argument failFast
, and executes the closure code in parallel.
parallel firstBranch: { // do something }, secondBranch: { // do something else }, failFast: true|false
stage("tests") { parallel( "unit tests": { // run unit tests }, "coverage tests": { // run coverage tests } ) }
Allocation to different nodes can be performed inside the closure:
def tasks = [:] tasks["branch-1"] = { stage("task-1") { node('node_1') { sh 'echo $NODE_NAME' } } } tasks["branch-2"] = { stage("task-2") { node('node_1') { sh 'echo $NODE_NAME' } } } parallel tasks
sh
- https://www.jenkins.io/doc/pipeline/steps/workflow-durable-task-step/#sh-shell-script
- Playground sh
Execute a shell script command, or multiple commands, on multiple lines. It can be specified in-line or it can refer to a file available on the filesystem exposed to the Jenkins node. It needs to be enclosed by a node to work.
The metacharacter $ must be escaped: ${LOGDIR}
, unless it refers to a variable form the Groovy context.
Example:
stage.sh """ LOGDIR=${fileName}-logs mkdir -p ${LOGDIR}/something """.stripIndent()
stage.sh ''' LOGDIR=some-logs mkdir -p ${LOGDIR}/something '''.stripIndent()
Both """..."""
and '''...'''
Groovy constructs can be used. For more details on enclosing representing multi-line strings with """
or '''
, see:
- Groovy | Multi-Line_Strings
sh — Script Return Status
By default, a script exits with a non-zero return code will cause the step and the pipeline to fail with an exception:
ERROR: script returned exit code 1
To prevent that, configure returnStatus
to be equal with true, and the step will return the exit value of the script, instead of failing on non-zero exit value. You may then compare to zero and decide whether to fail the pipeline (throw an exception) or not from the Groovy layer that invoked sh
.
int exitCode = sh(returnStatus: true, script: './bin/do-something') if (exitCode != 0) throw new RuntimeException('my script failed')
The pipeline log result on failure looks similar to:
[Pipeline] End of Pipeline java.lang.RuntimeException: my script failed at WorkflowScript.run(WorkflowScript:17) ...
Also see Scripted Pipeline Failure Handling section above.
sh — Script stdout
By default, the standard output of the script is send to the log. If returnStdout
is set to true, the script standard output is returned as String as the step value. Call trim()
to strip off the trailing newline.
The script’s stderr is always sent to the log.
String result = sh(returnStdout: true, script: './bin/do-something').trim()
sh — Obtaining both the Return Status and stdout
If both returnStatus
and returnStdout
are turned on, returnStatus
takes priority and the function returns the exit code. ⚠️ The stdout is discarded.
sh — Obtaining stdout and Preventing the Pipeline to Fail on Error
In case you want to use the external shell command to return a result to the pipeline, but not fail the pipeline when the external command fails, use this pattern:
try { String stdout = sh(returnStdout: true, returnStatus: false, script: 'my-script') // use the content returned by stdout in the pipeline print "we got this as result of sh invocation: ${stdout.trim()}" } catch(Exception e) { // catching the error will prevent pipeline failure, both stdout and stderr are captured in the pipeline log print "the invocation failed" }
If the command fails, both its stdout and stderr are captured in the pipeline log.
sh — Label
If a «label» argument is specified, the stage will render that label in the Jenkins and Blue Ocean logs:
sh(script: './bin/do-something', label: 'this will show in logs')
ws
- https://jenkins.io/doc/pipeline/steps/workflow-durable-task-step/#-ws-allocate-workspace
Allocate workspace.
build
- https://jenkins.io/doc/pipeline/steps/pipeline-build-step/
This is how a main pipeline launches in execution a subordinate pipeline.
This is how we may be able to return the result: https://support.cloudbees.com/hc/en-us/articles/218554077-How-to-set-current-build-result-in-Pipeline
junit
- https://jenkins.io/doc/pipeline/steps/junit/#-junit-archive-junit-formatted-test-results
Jenkins understands the JUnit test report XML format (which is also used by TestNG). To use this feature, set up the build to run tests, which will generate their test reports into a local agent directory, then specify the path to the test reports in Ant glob syntax to the JUnit plugin pipeline step junit
:
stage.junit '**/target/*-report/TEST-*.xml'
⚠️ Do not specify the path to a single test report file. The junit
step will not load the file, even if it exists and it is a valid report, and will print an error message similar to:
[Pipeline] junit Recording test results No test report files were found. Configuration error?
Always use Ant glob syntax to specify how the report(s) are to be located:
Jenkins uses this step to ingest the test results, process them and provide historical test result trends, a web UI for viewing test reports, tracking failures, etc.
Both JUnit errors and failures are reported by the junit
step as «failures», even if the JUnit XML report indicates both errors and failures. The following JUnit report:
<testsuite name="testsuite1" tests="2" errors="1" failures="1"> <testcase name="test1" classname="test1"> <error message="I have errored out"></error> </testcase> <testcase name="test2" classname="test2"> <failure message="I have failed"></failure> </testcase> </testsuite>
produces this Jenkins report:
The presence of at least one JUnit failure marks the corresponding stage, and the entire build as «UNSTABLE». The stage is rendered in the classical view and also in Blue Ocean in yellow:
Also see: Scripted Pipeline Failure Handling above.
checkout
- https://www.jenkins.io/doc/pipeline/steps/workflow-scm-step/
The «checkout» step is provided by the pipeline «SCM» plugin.
Git Plugin
- https://plugins.jenkins.io/git/
checkout([ $class: 'GitSCM', branches: [[name: 'develop']], doGenerateSubmoduleConfigurations: false, extensions: [ [$class: 'GitLFSPull'], [$class: 'CloneOption', noTags: true, reference: '', timeout: 40, depth: 1], [$class: 'PruneStaleBranch'] ], submoduleCfg: [], userRemoteConfigs: [ [url: 'git@github.com:some-org/some-project.git', credentialsId: 'someCredId'] ] ])
The simplest configuration that works:
checkout([ $class: 'GitSCM', branches: [[name: 'master']], userRemoteConfigs: [ [url: 'https://github.com/ovidiuf/playground.git'] ] ])
The step checks out the repository into the current directory, in does not create a top-level directory (‘some-project’ in this case). .git will be created in the current directory. If the current directory is the workspace, .git will be created in the workspace root.
withCredentials
A step that allows using credentials defined in the Jenkins server. See:
- Jenkins Credentials Binding Plugin
Basic Steps
These basic steps are used invoking on stage.
. In a Jenkinsfile, and inside a stage, invoke on this.
or simply invoking directly, without qualifying.
echo
echo "pod memory limit: ${params.POD_MEMORY_LIMIT_Gi}"
echo """ Run Configuration: something: ${SOMETHING} something else: ${SOMETHING_ELSE} """
error
- https://jenkins.io/doc/pipeline/steps/workflow-basic-steps/#error-error-signal
This step signals an error and fails the pipeline.
Alternatively, you can simply:
throw new Exception("some message")
stash
- https://jenkins.io/doc/pipeline/steps/workflow-basic-steps/#stash-stash-some-files-to-be-used-later-in-the-build
input
- https://jenkins.io/doc/pipeline/steps/pipeline-input-step/
In its basic form, renders a «Proceed»/»Abort» input box with a custom message. Selecting «Proceed» passes the control to the next step in the pipeline. Selecting «Abort» throws a org.jenkinsci.plugins.workflow.steps.FlowInterruptedException
, which produces «gray» pipelines.
input( id: 'Proceed1', message: 'If the manual test is successful, select 'Proceed'. Otherwise, you can abort the pipeline.' )
timeout
- https://jenkins.io/doc/pipeline/steps/workflow-basic-steps/#-timeout-enforce-time-limit
Upon timeout, an org.jenkinsci.plugins.workflow.steps.FlowInterruptedException
is thrown from the closure that is being executed, and not from the timeout() invocation. The code shown below prints «A», «B», «D»:
timeout(time: 5, unit: 'SECONDS') { echo "A" try { echo "B" doSometing(); // this step takes a very long time and will time out echo "C" } catch(org.jenkinsci.plugins.workflow.steps.FlowInterruptedException e) { // if this exception propagates up without being caught, the pipeline gets aborted echo "D" } }
withEnv
- https://jenkins.io/doc/pipeline/steps/workflow-basic-steps/#withenv-set-environment-variables
Sets one more more environment variables within a block, making them available to any external process initiated within that scope. If a variable value contains spaces, it does need to be quoted inside the sequence, as shown below:
node { withEnv(['VAR_A=something', 'VAR_B=something else']) { sh 'echo "VAR_A: ${VAR_A}, VAR_B: ${VAR_B}"' } }
catchError
- https://www.jenkins.io/doc/pipeline/steps/workflow-basic-steps/#catcherror-catch-error-and-set-build-result-to-failure
catchError { sh 'some-command-that-might-fail' }
If the body throws an exception, mark the build as a failure, but continue to execute the pipeline from the statement following catchError
step. If an exception is thrown, the behavior can be configured to:
- print a message
- set the build result other than failure
- change the stage result
- ignore certain kinds of exceptions that are used to interrupt the build
If catchError
is used, there’s no need for finally
, as the exception is caught and does not propagates up.
The alternative is to use plain try/catch/finally
blocks.
Configuration:
catchError(message: 'some message', stageResult: 'FAILURE'|'SUCCESS'|... , buildResult: 'FAILURE'|'SUCCESS'|..., catchInterruptions: true) { sh 'some-command-that-might-fail' }
- message an an optional String message that will be logged to the console. If the stage result is specified, the message will also be associated with that result and may be shown in visualizations.
- stageResult an optional String that will set as stage result when an error is caught. Use SUCCESS or null to keep the stage result from being set when an error is caught.
- buildResult an optional String that will be set as overall build result when an error is caught. Note that the build result can only get worse, so you cannot change the result to SUCCESS if the current result is UNSTABLE or worse. Use SUCCESS or null to keep the build result from being set when an error is caught.
- catchInterruptions If true, certain types of exceptions that are used to interrupt the flow of execution for Pipelines will be caught and handled by the step. If false, those types of exceptions will be caught and immediately rethrown. Examples of these types of exceptions include those thrown when a build is manually aborted through the UI and those thrown by the timeout step.
The default behavior for catchInterruptions
is «true»: the code executing inside catchError()
will be interrupted, whether it is an external command or pipeline code, and the code immediately following catchError()
closure is executed.
stage('stage1') { catchError() { sh 'jenkins/pipelines/failure/long-running' } print ">>>> post catchError()" }
[Pipeline] stage [Pipeline] { (stage1) [Pipeline] catchError [Pipeline] { [Pipeline] sh entering long running .... sleeping for 60 secs Aborted by ovidiu Sending interrupt signal to process jenkins/pipelines/failure/long-running: line 6: 5147 Terminated sleep ${sleep_secs} done sleeping, exiting long running .... [Pipeline] } [Pipeline] // catchError [Pipeline] echo >>>> post catchError()
However, it seems that the same behavior occurs if catchError()
is invoked with catchInteruptions: true
, so it’s not clear what is the difference..
Probably the safest way to invoke is to use this pattern, this way we’re sure that even some exceptions bubble up, the cleanup work will be performed:
stage('stage1') { try { catchError() { sh 'jenkins/pipelines/failure/long-running' } } finally { print ">>>> execute mandatory cleanup code" } }
Also see Scripted Pipeline Failure Handling section above.
Basic Steps that Deal with Files
dir
- https://www.jenkins.io/doc/pipeline/steps/workflow-basic-steps/#dir-change-current-directory
Change current directory, on the node, while the pipeline code runs on the master.
If the dir()
argument is a relative directory, the new directory available to the code in the closure is relative to the current directory before the call, obtained with pwd()
:
dir("dirA") { // execute in the context of pwd()/dirA", where pwd() // is the current directory before and a subdirectory of the workspace }
If the dir()
argument is an absolute directory, the new directory available to the code in the closure is the absolute directory specified as argument:
dir("/tmp") { // execute in /tmp }
In both cases, the current directory is restored upon closure exit.
Also see:
- Pipeline and Files
deleteDir
- https://www.jenkins.io/doc/pipeline/steps/workflow-basic-steps/#deletedir-recursively-delete-the-current-directory-from-the-workspace
To recursively delete a directory and all its contents, step into the directory with dir()
and then use deleteDir()
:
dir('tmp') { // ... deleteDir() }
This will delete ./tmp content and the ./tmp directory itself.
pwd
- https://www.jenkins.io/doc/pipeline/steps/workflow-basic-steps/#pwd-determine-current-directory
Return the current directory path on node as a string, while the pipeline code runs on the master.
Parameters:
tmp (boolean, optional) If selected, return a temporary directory associated with the workspace rather than the workspace itself. This is an appropriate place to put temporary files which should not clutter a source checkout; local repositories or caches; etc.
println "current directory: ${pwd()}"
println "temporary directory: ${pwd(tmp: true)}"
Also see:
- Pipeline and Files
readFile
- https://jenkins.io/doc/pipeline/steps/workflow-basic-steps/#readfile-read-file-from-workspace
Read a file from the workspace, on the node this operation is made in context of.
String versionFile = readFile("${stage.WORKSPACE}/terraform/my-module/VERSION")
If the file does not exist, the step throws java.nio.file.NoSuchFileException: /no/such/file.txt
writeFile
- https://jenkins.io/doc/pipeline/steps/workflow-basic-steps/#writefile-write-file-to-workspace
writeFile will create any intermediate directory if necessary.
To create a directory, dir()
into the inexistent directory then create a dummy file writeFile(file: '.dummy', text: )
:
dir('tmp') { writeFile(file: '.dummy', text: '') }
Alternatively, the directory can be created with a shell command:
Also see:
- Pipeline and Files
fileExists
- https://www.jenkins.io/doc/pipeline/steps/workflow-basic-steps/#fileexists-verify-if-file-exists-in-workspace
Also see:
- Pipeline and Files
fileExists can be used on directories as well. This is how to check whether a directory exists:
dir('dirA') { if (fileExists('/')) { println "directory exists" } else { println "directory does not exist" } }
fileExists('/')
, fileExists('.')
and fileExists('')
are equivalent, they all check for the existence of a directory into which the last dir()
stepped into. The last form fileExists('')
issues a warning, so it’s not preferred:
The fileExists step was called with a null or empty string, so the current directory will be checked instead.
findFiles
- https://www.jenkins.io/doc/pipeline/steps/pipeline-utility-steps/#findfiles-find-files-in-the-workspace
Find files in workspace:
def files = findFiles(glob: '**/Test-*.xml', excludes: '')
Uses Ant style pattern: https://ant.apache.org/manual/dirtasks.html#patterns
Returns an array of instance for which the following attributes are available:
- name: the name of the file and extension, without any path component (e.g. «test1.bats»)
- path: the relative path to the current directory set with dir(), including the name of the file (e.g. «dirA/subDirA/test1.bats»)
- directory: a boolean which is true if the file is a directory, false otherwise.
- length: length in bytes.
- lastModified: 1617772442000
Example:
dir('test') { def files = findFiles(glob: '**/*.bats') for(def f: files) { print "name: ${f.name}, path: ${f.path}, directory: ${f.directory}, length: ${f.length}, lastModified: ${f.lastModified}" } }
Playground:
- playground/jenkins/pipelines/findFiles
Core
- https://jenkins.io/doc/pipeline/steps/core/
archiveArtifacts
- https://jenkins.io/doc/pipeline/steps/core/#-archiveartifacts-archive-the-artifacts
Archives the build artifacts (for example, distribution zip files or jar files) so that they can be downloaded later. Archived files will be accessible from the Jenkins webpage. Normally, Jenkins keeps artifacts for a build as long as a build log itself is kept. Note that the Maven job type automatically archives any produced Maven artifacts. Any artifacts configured here will be archived on top of that. Automatic artifact archiving can be disabled under the advanced Maven options.
fingerprint
Obtaining the Current Pipeline Build Number
def buildNumber = currentBuild.rawBuild.getNumber()
FlowInterruptedException
throw new FlowInterruptedException(Result.ABORTED)
Navigating the Project Model Hierarchy
String branch="..." String projectName = JOB_NAME.substring(0, JOB_NAME.size() - JOB_BASE_NAME.size() - 1) WorkflowMultiBranchProject project = Jenkins.instance.getItemByFullName("${projectName}") if (project == null) { ... } WorkflowJob job = project.getBranch(branch) if (job == null) { ... } WorkflowRun run = job.getLastSuccessfulBuild() if (run == null) { ... } List<Run.Artifact> artifacts = run.getArtifacts() ...
Passing an Environment Variable from Downstream Build to Upstream Build
Upstream build:
... def result = build(job: jobName, parameters: params, quietPeriod: 0, propagate: true, wait: true); result.getBuildVariables()["SOME_VAR"] ...
Downstream build:
env.SOME_VAR = "something"
@NonCPS
- Jenkins Concepts | CPS
Build Summary
// // write /tmp/summary-section-1.html // def summarySection1 = util.catFile('/tmp/summary-section-1.html') if (summarySection1) { def summary = manager.createSummary('document.png') summary.appendText(summarySection1, false) } // // write /tmp/summary-section-2.html // def summarySection2 = util.catFile('/tmp/summary-section-2.html') if (summarySection2) { def summary = manager.createSummary('document.png') summary.appendText(summarySection2, false) }
Dynamically Loaded Classes and Constructors
If classes are loaded dynamically in the Jenkinsfile, do not use constructors and new
. Use MyClass.newInstance(…).
Fail a Build
See error above.
Dynamically Loading Groovy Code from Repository into a Pipeline
This playground example shows how to dynamically load Groovy classes stored in a GitHub repository into a pipeline.
The example is not complete, in that invocation of a static method from Jenkinsfile does not work yet.
- https://github.com/ovidiuf/playground/tree/master/jenkins/pipelines/dynamic-groovy-loader
Groovy on Jenkins Idiosyncrasies
Prefix Static Method Invocations with Declaring Class Name when Calling from Subclass
Prefix the static method calls with the class name that declares them when calling from a subclass, otherwise you’ll get a:
hudson.remoting.ProxyException: groovy.lang.MissingMethodException: No signature of method: java.lang.Class.locateOverlay() is applicable for argument types: (WorkflowScript, playground.jenkins.kubernetes.KubernetesCluster, playground.jenkins.PlatformVersion, java.lang.String, java.lang.String) values: [WorkflowScript@1db9ab90, <playground.jenkins.kubernetes.KubernetesCluster@376dc438>, ...]
Jenkins is an automation server. It allows for all kinds of automations. It is primarily used for Build automation, Continuous Integration, and Continuous Deployment.
Installations
- Install Jenkins on Ubuntu (using Vagrant)
- Vagrant for Jenkins on Ubuntu
- Jenkins in Docker
Examples
- Jenkins Pipeline — Hello World (pipeline, agent, stages, stage, stpes, echo)
- Jenkins Pipeline: running external programs with sh or bat, returnStdout, trim
- Jenkins Pipeline: Send e-mail notifications
- Jenkins Pipeline: Add some text to the job using manager.addShortText
- Jenkins CLI: create node
- Jenkins Pipeline BuildUser plugin
- Jenkins Pipeline — set and use environment variables
- Jenkins Pipeline: git checkout using reference to speed up cloning large repositories
- Jenkins report the name of the stage that failed (STAGE_NAME)
- Jenkins Pipeline: triggers from Version Control Systems (pollSCM)
- How to set the job number and description for a Jenkinsfile in a Jenkins Pipeline? (currentBuild, displayName, description)
- Jenkins Pipeline: read a file, write a file — readFile, writeFile
- Separate jobs for development and production currentBuild, projectName
- Jenkins pipeline: get current user (currentBuild, getBuildCauses)
- Jenkins parameters
- Arbitrary code execution in the shell (sh, parameters)
- Jenkins pipeline: parallel stages
- Jenkins Pipeline: Collect exit code from external commands (sh, bat, returnStatus)
- Jenkins pipeline: Get previous build status — currentBuild, getPreviousBuild
- Jenkins pipeline: interactive input during process (input)
- Jenkins pipeline: List agents by name or by label
- Jenkins pipeline: add badges
- Report failures.
- Send alerts
- Collect test coverage data.
- Jenkins slides
- Jenkins printing Unicode characters
Run external code, capture output
script { v = sh(script: 'echo " 42"; echo', returnStdout: true).trim() echo v echo "a${v}b" }
bat for windows.
catch and print error in jenkins
jenkins exception try — catch
Get a job’s console logfile from a Jenkins pipeline
pipeline { agent none stages { stage ('Catch crash') { agent { label 'master'} steps { echo "before crash" script { try { sh 'exit 1' } catch (err) { echo "exception caught, going on" println err // java.lang.ClassCastException: org.jenkinsci.plugins.workflow.steps.EchoStep.message expects class java.lang.String but received class hudson.AbortException } } echo "after crash" } } stage ('Continue after crash') { agent { label 'master'} steps { echo "stage after crash" } } } }
try { //sh "ls -l no_such" a = 10 b = 0 c = a/b } catch(Exception ex) { //currentBuild.result = 'FAILURE' println("exception") println(ex) // hudson.AbortException: script returned exit code 2 println(ex.toString()) println(ex.getMessage()) println(ex.getStackTrace()) }
dir and tmp are problematic
stages { stage ('Run external exe') { agent { label 'master'} steps { sh 'pwd' dir('/tmp/gabor') { echo "inside" sh 'pwd' //sh 'sudo ./do-something.py' } sh 'pwd' //sh "sudo sh -c 'cd /tmp; ./do-something.py; cd -'" } }
examples/jenkins/mkdir_exception.txt
java.io.IOException: Failed to mkdirs: /tmp@tmp/durable-e569697c at hudson.FilePath.mkdirs(FilePath.java:1170) at org.jenkinsci.plugins.durabletask.FileMonitoringTask$FileMonitoringController.<init>(FileMonitori ngTask.java:156) at org.jenkinsci.plugins.durabletask.BourneShellScript$ShellController.<init>(BourneShellScript.java :198) at org.jenkinsci.plugins.durabletask.BourneShellScript$ShellController.<init>(BourneShellScript.java :190) at org.jenkinsci.plugins.durabletask.BourneShellScript.launchWithCookie(BourneShellScript.java:111) at org.jenkinsci.plugins.durabletask.FileMonitoringTask.launch(FileMonitoringTask.java:86) at org.jenkinsci.plugins.workflow.steps.durable_task.DurableTaskStep$Execution.start(DurableTaskStep .java:182) at org.jenkinsci.plugins.workflow.cps.DSL.invokeStep(DSL.java:229) at org.jenkinsci.plugins.workflow.cps.DSL.invokeMethod(DSL.java:153) at org.jenkinsci.plugins.workflow.cps.CpsScript.invokeMethod(CpsScript.java:122) at sun.reflect.GeneratedMethodAccessor1989.invoke(Unknown Source) at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43) at java.lang.reflect.Method.invoke(Method.java:498) at org.codehaus.groovy.reflection.CachedMethod.invoke(CachedMethod.java:93) at groovy.lang.MetaMethod.doMethodInvoke(MetaMethod.java:325) at groovy.lang.MetaClassImpl.invokeMethod(MetaClassImpl.java:1213) at groovy.lang.MetaClassImpl.invokeMethod(MetaClassImpl.java:1022) at org.codehaus.groovy.runtime.callsite.PogoMetaClassSite.call(PogoMetaClassSite.java:42) at org.codehaus.groovy.runtime.callsite.CallSiteArray.defaultCall(CallSiteArray.java:48) at org.codehaus.groovy.runtime.callsite.AbstractCallSite.call(AbstractCallSite.java:113) at org.kohsuke.groovy.sandbox.impl.Checker$1.call(Checker.java:157) at org.kohsuke.groovy.sandbox.GroovyInterceptor.onMethodCall(GroovyInterceptor.java:23) at org.jenkinsci.plugins.scriptsecurity.sandbox.groovy.SandboxInterceptor.onMethodCall(SandboxInterc eptor.java:133) at org.kohsuke.groovy.sandbox.impl.Checker$1.call(Checker.java:155) at org.kohsuke.groovy.sandbox.impl.Checker.checkedCall(Checker.java:159) at org.kohsuke.groovy.sandbox.impl.Checker.checkedCall(Checker.java:129) at org.kohsuke.groovy.sandbox.impl.Checker.checkedCall(Checker.java:129) at com.cloudbees.groovy.cps.sandbox.SandboxInvoker.methodCall(SandboxInvoker.java:17) at WorkflowScript.run(WorkflowScript:16)
Jenkins / Groovy — define functions and call them with parameters
def report(status) { println "status=${status}" }
and call them
report("text")
Environment variables on Linux
sh 'printenv' sh 'env'
git Backup
gist
Other
echo bat(returnStdout: true, script: 'set') build(job: 'RevertServerAutomationCloud', parameters: [ string(name: 'VM_SNAPSHOT', value: 'CleanDb') ])
how to include one jenkinsfile in another one?
how to avoid repetititon?
stage('Revert agent 100') { steps { } } stage('Revert agent 102') { steps { } }
how do try — catch and repeat interact?
vSphere buildStep: [$class: 'RevertToSnapshot', snapshotName: "${params.VM_SNAPSHOT}", vm: "${params.VM_NAME}"], serverName: '192.168.1.1' httpRequest authentication: 'df8-b86d-3272', consoleLogResponseBody: true, httpMode: 'POST', ignoreSslErrors: true, responseHandle: 'NONE', url: "http://192.168.1.1:8080/computer/${params.AGENT_NAME}/doDisconnect?offlineMessage=bye", validResponseCodes: '100:404'
Active Choices Parameter
examples/jenkins/array_list.txt
try { List<String> subnets = new ArrayList<String>() def subnetsRaw = "gcloud compute networks subnets list --project=${GCE_PROJECT} --network=corp-development --format=(NAME)".execute().text for (subnet in subnetsRaw.split()) { subnets.add(subnet) } return subnets } catch (Exception e) { print e print "There was a problem fetching the artifacts" }
Options
options { ansiColor('xterm') timestamps() }
Scripts
Scripts not permitted to use method groovy.lang.GroovyObject invokeMethod java.lang.String java.lang.Object
(org.jenkinsci.plugins.workflow.cps.EnvActionImpl keys). Administrators can decide whether to approve or reject this
signature.
archiveArtifacts can be called multiple times
archiveArtifacts artifacts: 'mydata.json', onlyIfSuccessful: true writeJSON(file: 'otherfile.log', json: data, pretty: 4) archiveArtifacts artifacts: '*.log', onlyIfSuccessful: true
Environment variable values must either be single quoted, double quoted, or function calls.
They cannot be earlier defined environment variables or parameter values.
We can however overcome this limitation by calling a function and passing the values to it.
examples/jenkins/exceptions.jenkinsfile
pipeline { agent none options { ansiColor('xterm') timestamps() } parameters { string(name: 'machine', defaultValue: 'asos', description: 'Some text input') string(name: 'size', defaultValue: '23', description: 'Some number input') } environment { answer = 42 // machine_name = params.machine // -> Environment variable values must either be single quoted, double quoted, or function calls. machine_name = set_machine_name(params.machine) } stages { stage('try') { agent { label 'master' } steps { script { sh "hostname" print("params.machine=${params.machine}") print("params.size=${params.size}") print("env.answer=${env.answer}") print("env.machine_name=${env.machine_name}") } } } stage('try-agent') { agent { label 'jenkins-simple-agent' } steps { script { sh "hostname" } } } } } def set_machine_name(value) { return value }
Jenkins environment
Even if there is an exception in the environment section Jenkins will still run the «success» part of the post section.
Same problem if there is an exception on one of the functions.
To overcome this we create an environment variable as the last step in the environment section
and then we check that variable using
if (! binding.hasVariable(‘environment_is_set’)) {
error(«Environment failed to set properly»)
}
That does not help in case there is an exception in the functions.
http_request
response = httpRequest discovery_url println response config_str = response.getContent() for (item in config.sources) { item.value item.key
Sending e-mail problem fixed
https://stackoverflow.com/questions/20188456/how-to-change-the-security-type-from-ssl-to-tls-in-jenkins
* Sending e-mail
In Manage Jenkins — Configure System in the
Extended mail section set the
SMTP: smtp.office365.com
Domain name: @company.com
Advanced:
Use SMTP Authentication: +
User Name: cicdserver@company.com
Password: SMTP port: 587
E-mail notification section:
SMTP server: smtp.office365.com
Default user e-mail suffix: @company.com
Advanced
User Name: cicdserver@company.com
Password: SMTP port: 587
Shut down Jenkins (via the Windows services)
Open the file: C:Program Files (x86)Jenkinsjenkins.xml
and change the arguments line to be:
examples/jenkins/arguments.txt
<arguments>-Xrs -Xmx256m -Dhudson.lifecycle=hudson.lifecycle.WindowsServiceLifecycle -Dmail.smtp.starttls.enable=true -jar "%BASE%jenkins.war" --httpPort=8080 --webroot="%BASE%war"</arguments>
(specifically add: -Dmail.smtp.starttls.enable=true )
Then start Jenkins again.
Client was not authenticated to send anonymous mail
Error sending to the following VALID addresses
examples/jenkins/variables.Jenkinsfile
pipeline { agent none stages { stage('try') { agent { label 'master' } steps { script { //some_strange_name = null //print(some_strange_name) if (true) { print("creating variable") some_strange_name = 1 } print(some_strange_name) if (binding.hasVariable('some_strange_name')) { print("has some_strange_name") print(some_strange_name) } else { print("DOES NOT have some_strange_name") } } } } stage('try again') { agent { label 'master' } steps { script { if (binding.hasVariable('some_strange_name')) { print("has some_strange_name") print(some_strange_name) } else { print("DOES NOT have some_strange_name") } } } } } }
Skip steps
Jenkins pipeline stop early with success
How to indicate that a job is successful
pipeline conditional step stage
examples/jenkins/skip_step.Jenkinsfile
pipeline { agent none options { ansiColor('xterm') timestamps() } parameters { booleanParam(defaultValue: false, description: 'Checkbox', name: 'yesno') } stages { stage('first') { agent { label 'master' } steps { script { println("first before") println(params.yesno) done = true return println("first after") } } } stage('second') { agent { label 'master' } when { expression { return ! done; } } steps { script { println("second") } } } } }
examples/jenkins/worker_job.Jenkinsfile
import java.text.SimpleDateFormat pipeline { agent none options { ansiColor('xterm') timestamps() } parameters { string(name: 'machine', defaultValue: '', description: 'Name of the machine') string(name: 'size', defaultValue: '23', description: 'The size') choice(choices: ['Mercury', 'Venus', 'Earth', 'Mars'], description: 'Pick a planet', name: 'planet') //} stages { stage('try') { agent { label 'master' } steps { script { sh "hostname" def data = readJSON text: '{}' data.name = "test-529" as String data.date = new java.text.SimpleDateFormat('yyyyMMddHHmmss').format(new Date()) writeJSON(file: 'mydata.json', json: data, pretty: 4) archiveArtifacts artifacts: 'mydata.json', onlyIfSuccessful: true //error("Fail after first artifact") writeJSON(file: 'otherfile.log', json: data, pretty: 4) archiveArtifacts artifacts: '*.log', onlyIfSuccessful: true } } } } }
jenkins sh commnad fails — jenkins stops
examples/jenkins/sh_fails.jenkinsfile
pipeline { agent { label 'master' } stages { stage('only') { steps { println("one") sh "ls -l" println("two") sh "ls -l no_such" println("three") } } } }
Repository branch filter for Git
It will start multiple jobs if more than one branch was pushed out.
It is triggered even if there were no new commits in the branch that was pushed out
By default it will run every branch matching the filter, even if that branch was last changed 2 years ago.
This can be a problem if for some reason your have hundreds or thousands of historical branches.
:^origin/(work|dev)-.*
You can limit this by selecting another option and setting the ancestry date to limit how many days
you are ready to go back in time.
- Strategy for choosing what to build
- Choosing strategy: Ancestry
- Maximum Age of Commit: 1
In a pipeline
examples/jenkins/branch_filter_age_limit.jenkinsfile
checkout([ $class: 'GitSCM', branches: [[name: '*/master']], doGenerateSubmoduleConfigurations: false, extensions: [[ $class: 'BuildChooserSetting', buildChooser: [$class: 'AncestryBuildChooser', ancestorCommitSha1: '', maximumAgeInDays: 1] ]], submoduleCfg: [], userRemoteConfigs: [[]] ])
Jenkins Pipeline code reuse
https://cleverbuilder.com/articles/jenkins-shared-library/
https://jenkins.io/doc/book/pipeline/shared-libraries/
Exceptions
When you encounter one of those 40-lines long Java stack-traces, look for WorkflowScript to locate the source of the problem.
examples/jenkins/exception_catching.jenkinsfile
pipeline { agent { label 'master' } stages { stage('only') { steps { script { println("one") sh "ls -l" println("two") try { //sh "ls -l no_such" a = 10 b = 0 c = a/b } catch(Exception ex) { //currentBuild.result = 'FAILURE' println("exception") println(ex) // hudson.AbortException: script returned exit code 2 println(ex.toString()) println(ex.getMessage()) println(ex.getStackTrace()) } //} catch(ArrayIndexOutOfBoundsException ex) { //println("Catching the Array out of Bounds exception"); //}catch(Exception ex) { println("three") is_it_the_answer(42) echo "try again" is_it_the_answer(23) } } } stage('second') { steps { script { // if (manager.logContains("three")) { // manager.addWarningBadge("tres") // } else { // manager.addWarningBadge("nem harom") // } } } } } } def is_it_the_answer(n) { if (n == 42) { return 'yes' } throw new Exception('Nope') } try { is_it_the_answer(23) } catch (err) { print(err) print(err.getMessage()) }
Jenkins parse console output
The logContains can parse the log created be the previous stages (but not the current stage)
It can also be used in a post-action.
«manager» is org.jvnet.hudson.plugins.groovypostbuild.GroovyPostbuildRecorder$BadgeManager@41fe3861
Postbuild plugin
examples/jenkins/parse_console_output.jenkinsfile
stage('second') { steps { script { if (manager.logContains("three")) { manager.addWarningBadge("drei") } else { manager.addWarningBadge("kein drei") } } } } print("A disk image was created: zorg-1552278641") def matcher = manager.getLogMatcher(/.* (zorg-d+).*/) print(matcher) if (matcher?.matches()) { def image_name = matcher.group(1) print(image_name) manager.addShortText(image_name) }
readJSON
no such dsl method
jenkins build step
https://jenkins.io/doc/pipeline/steps/pipeline-build-step/
jenkins collect status from invoked jobs
examples/jenkins/status_from_build.Jenkinsfile
pipeline { agent { label 'master' } stages { stage('only') { steps { script { println("BEFORE") results = [] try { def result = build job: "experiment-subproject", wait: true println(result) // org.jenkinsci.plugins.workflow.support.steps.build.RunWrapper println(result.getId()) } catch(err) { println("ERROR caught") println(err) // hudson.AbortException: experiment-subproject #4 completed with status FAILURE (propagate: false to ignore) // https://javadoc.jenkins-ci.org/hudson/AbortException.html println(err.getMessage()) println(err.getStackTrace()) println(err.getCause()) println(err.getLocalizedMessage()) println(err.toString()) } println("AFTER") def res = build job: "experiment-subproject", wait: false println(res) // null rep = build job: "experiment-subproject", wait: true, propagate: false println(rep) // org.jenkinsci.plugins.workflow.support.steps.build.RunWrapper println(rep.getId()) println(rep.getResult()) // FAILURE println(rep.getDurationString()) results.push(rep) //sh "ls -l" //println("two") //} catch(ArrayIndexOutOfBoundsException ex) { //println("Catching the Array out of Bounds exception"); //}catch(Exception ex) { //println("three") //print("A disk image was created: jenkins-agent-1554 and then more") //is_it_the_answer(42) //echo "try again" //try { // is_it_the_answer(23) //} catch (err) { // print(err) // print(err.getMessage()) //} } } } stage('second') { steps { script { echo "hi" println(rep.getId()) println(rep.getResult()) // FAILURE println(rep.getProjectName()) println(rep.getDisplayName()) def res = build job: "experiment-subproject", wait: true, propagate: false results.push(res) // if (manager.logContains("three")) { // manager.addWarningBadge("tres") // } else { // manager.addWarningBadge("nem harom") // } //def image_name = '' //def matcher = manager.getLogMatcher(/.* (jenkins-agent-(d+)).*/) //print(matcher) //if (matcher?.matches()) { // image_name = matcher.group(1) // println(image_name) // manager.addShortText(image_name) // println(image_name.getClass()) //} //do_sg(image_name) } } } stage ('gitz') { agent { label 'build-small' } steps { script { results.each { println(it) println(it.getId()) println(it.getResult()) // FAILURE println(it.getProjectName()) println(it.getAbsoluteUrl()) } } } } } } def is_it_the_answer(n) { if (n == 42) { return 'yes' } throw new Exception('Nope') } def do_sg(name) { print("do_sg with $name") }
links
https://jenkins.io/doc/pipeline/steps/
https://jenkins.io/doc/pipeline/steps/pipeline-build-step/#-build-%20build%20a%20job
https://jenkins.io/doc/pipeline/steps/pipeline-input-step/
script { manager.addShortText("n${params.cluserName}", "black", "yellow", "0px", "white") manager.addShortText("${params.clusterId}-${params.command}", "black", "lightgreen", "0px", "white") manager.addShortText("${params.services}", "black", "AliceBlue", "0px", "white") if (params.usage) { manager.addShortText("${params.usage}", "DimGray", "AliceBlue", "0px", "white") } }
Elapsed time
examples/jenkins/elapsed_time.Jenkinsfile
import groovy.time.TimeCategory import groovy.time.TimeDuration pipeline { agent { label 'master' } stages { stage('first') { steps { script { start = new Date() echo "in first" } } } stage('second') { steps { script { echo "in second" } } } } post { always { echo "in post always" script { def stop = new Date() TimeDuration td = TimeCategory.minus( stop, start ) println("Elapsed time: $td") } } failure { echo "in post failure" } } }
Serialize regex
After a regex matching Jenkins sometimes wants to serialize the object, but it cannot do it and thus is raises an
exception. (I have not yet figured out when does this happen.)
examples/jenkins/serialize_regex.Jenkinsfile
pipeline { agent { label 'master' } stages { stage('first') { steps { script { echo "in first" def text = """This is some long test with more than 1 rows. """ def match = (text =~ /bsomeb/) println("still first") check_me() } } } stage('second') { steps { script { echo "in second" } } } } post { always { echo "in post always" } failure { echo "in post failure" } } } def check_me() { println("in check") def text = """This is some long test with more than 1 rows. """ def match = (text =~ /bsomeb/) }
Send mail
emailext ( subject: "Test by Gabor", body: "Test from Gabor", to: 'foo@bar.com', from: 'jenkins-noreply@example.com', listId: 'gabor-experimental', )
Jenkins — check if host is accessible
examples/jenkins/ping_host.jenkinsfile
// catch exception // stop process early reporting failure pipeline { agent { label 'master' } parameters { string(name: 'hostname', defaultValue: 'gabor-dev', description: 'Hostname or IP address') } stages { stage('first') { steps { script { echo "Checking $params.hostname" try { sh("ping -c 1 $params.hostname") } catch(Exception e) { println("Exception: ${e}") error("Could not find host $params.hostname, is it on?") return } echo "still in first" } } } stage('second') { steps { script { echo "in second" } } } } post { always { echo "in post always" } failure { echo "in post failure" } } }
last started stage
// last_started = env.STAGE_NAME
Early stop
jenkins — skip rest of the current stage, early end of current stage — stop the whole job reporting error
return // skipping rest of the current stage, running next stage error("Some error message") // raise an exception stop the whole job
currentBuild
echo currentBuild.number // failed expecting number println(currentBuild.number) // works println("Number: ${currentBuild.number}") println("Result: ${currentBuild.result}") println("Display name: ${currentBuild.displayName}")
during the steps the result is null
in the post section it is already ‘SUCCESS’ or ‘FAILURE’
getting started
returnStatus instead of stopping the job
the exit code
def res2 = sh(script: "pwd", returnStatus: true)
Sample code
def errors = '' def res = 'SUCCESS' def res1 = sh(script: "xyz", returnStatus: true) println("res1 ${res1}") if (res1 !=0) { res = 'FAILURE' errors += "xyz" } def res2 = sh(script: "abc", returnStatus: true) println("res2: ${res2}") if (res2 !=0) { res = 'FAILURE' errors += "abc" } def res3 = sh(script: "pwd", returnStatus: true) println("res3: ${res3}") if (res3 !=0) { res = 'FAILURE' errors += "pwd" } //if (params.expected == 'Success') { // sh "pwd" //} else { // sh "xyz" //} if (res == 'FAILURE') { error(errors)
jenkins error, we need to clean the regex variables
def output = sh(...) def version = (output =~ /Versions*:s*([d.]+)/) def build_number = (output =~ /Build numbers*:s*([d]+)/) currentBuild.description = "${version[0][1]} - ${build_number[0][1]}<br>" version = "" build_number = ""
Optional artifacts
post { always { script { archiveArtifacts artifacts: 'screenshots/*', fingerprint: true, allowEmptyArchive: true } } }
archiveArtifacts
schedule
multiple cron with parameter
examples/jenkins/multiple_cron.Jenkinsfile
// multiple cron with parameter // There is a plugin and this experiment triggers { cron("35,36 * * * *") } stages { stage('Check disk usage') { steps { script { echo "--------------" echo "HELLO $BUILD_NUMBER" echo "--------------" String[] ENVS = ["env1", "env3"] def ENV_COUNT = ENVS.length def x = BUILD_NUMBER.toInteger() % ENV_COUNT echo x.toString() echo ENVS[x]
Содержание
- Pipeline Syntax
- Declarative Pipeline
- Limitations
- Sections
- agent
- stages
- steps
- Directives
- environment
- options
- parameters
- triggers
- Jenkins cron syntax
- stage
- tools
- input
- Sequential Stages
- Parallel
- Matrix
Pipeline Syntax
This section builds on the information introduced in Getting started with Pipeline and should be treated solely as a reference. For more information on how to use Pipeline syntax in practical examples, refer to the Using a Jenkinsfile section of this chapter. As of version 2.5 of the Pipeline plugin, Pipeline supports two discrete syntaxes which are detailed below. For the pros and cons of each, see the Syntax Comparison.
As discussed at the start of this chapter, the most fundamental part of a Pipeline is the «step». Basically, steps tell Jenkins what to do and serve as the basic building block for both Declarative and Scripted Pipeline syntax.
For an overview of available steps, please refer to the Pipeline Steps reference which contains a comprehensive list of steps built into Pipeline as well as steps provided by plugins.
Declarative Pipeline
Declarative Pipeline is a relatively recent addition to Jenkins Pipeline [1] which presents a more simplified and opinionated syntax on top of the Pipeline sub-systems.
All valid Declarative Pipelines must be enclosed within a pipeline block, for example:
The basic statements and expressions which are valid in Declarative Pipeline follow the same rules as Groovy’s syntax with the following exceptions:
The top-level of the Pipeline must be a block, specifically: pipeline < >.
No semicolons as statement separators. Each statement has to be on its own line.
Blocks must only consist of Sections, Directives, Steps, or assignment statements.
A property reference statement is treated as a no-argument method invocation. So, for example, input is treated as input() .
You can use the Declarative Directive Generator to help you get started with configuring the directives and sections in your Declarative Pipeline.
Limitations
There is currently an open issue which limits the maximum size of the code within the pipeline<> block. This limitation does not apply to Scripted pipelines.
Sections
Sections in Declarative Pipeline typically contain one or more Directives or Steps.
agent
The agent section specifies where the entire Pipeline, or a specific stage, will execute in the Jenkins environment depending on where the agent section is placed. The section must be defined at the top-level inside the pipeline block, but stage-level usage is optional.
In the top-level pipeline block and each stage block.
Differences between top and stage level Agents
There are some nuances when adding an agent to the top level or a stage level, and this when the options directive is applied.
Top Level Agents
In agents declared at the outermost level of the Pipeline, the options are invoked after entering the agent. As an example, when using timeout it will be only applied to the execution within the agent.
Stage Agents
In agents declared within a stage, the options are invoked before entering the agent and before checking any when conditions. In this case, when using timeout , it is applied before the agent is allocated.
This timeout will include the agent provisioning time. Because the timeout includes the agent provisioning time, the Pipeline may fail in cases where agent allocation is delayed.
Parameters
In order to support the wide variety of use-cases Pipeline authors may have, the agent section supports a few different types of parameters. These parameters can be applied at the top-level of the pipeline block, or within each stage directive.
Execute the Pipeline, or stage, on any available agent. For example: agent any
When applied at the top-level of the pipeline block no global agent will be allocated for the entire Pipeline run and each stage section will need to contain its own agent section. For example: agent none
Execute the Pipeline, or stage, on an agent available in the Jenkins environment with the provided label. For example: agent
Label conditions can also be used. For example: agent < label ‘my-label1 && my-label2’ >or agent
agent < node < label ‘labelName’ >> behaves the same as agent < label ‘labelName’ >, but node allows for additional options (such as customWorkspace ).
Execute the Pipeline, or stage, with the given container which will be dynamically provisioned on a node pre-configured to accept Docker-based Pipelines, or on a node matching the optionally defined label parameter. docker also optionally accepts an args parameter which may contain arguments to pass directly to a docker run invocation, and an alwaysPull option, which will force a docker pull even if the image name is already present. For example: agent < docker ‘maven:3.8.7-eclipse-temurin-11’ >or
docker also optionally accepts a registryUrl and registryCredentialsId parameters which will help to specify the Docker Registry to use and its credentials. The parameter registryCredentialsId could be used alone for private repositories within the docker hub. For example:
Execute the Pipeline, or stage, with a container built from a Dockerfile contained in the source repository. In order to use this option, the Jenkinsfile must be loaded from either a Multibranch Pipeline or a Pipeline from SCM. Conventionally this is the Dockerfile in the root of the source repository: agent < dockerfile true >. If building a Dockerfile in another directory, use the dir option: agent < dockerfile < dir ‘someSubDir’ >> . If your Dockerfile has another name, you can specify the file name with the filename option. You can pass additional arguments to the docker build … command with the additionalBuildArgs option, like agent < dockerfile < additionalBuildArgs ‘—build-arg foo=bar’ >> . For example, a repository with the file build/Dockerfile.build , expecting a build argument version :
dockerfile also optionally accepts a registryUrl and registryCredentialsId parameters which will help to specify the Docker Registry to use and its credentials. For example:
Execute the Pipeline, or stage, inside a pod deployed on a Kubernetes cluster. In order to use this option, the Jenkinsfile must be loaded from either a Multibranch Pipeline or a Pipeline from SCM. The Pod template is defined inside the kubernetes < >block. For example, if you want a pod with a Kaniko container inside it, you would define it as follows:
You will need to create a secret aws-secret for Kaniko to be able to authenticate with ECR. This secret should contain the contents of
/.aws/credentials . The other volume is a ConfigMap which should contain the endpoint of your ECR registry. For example:
Common Options
These are a few options that can be applied to two or more agent implementations. They are not required unless explicitly stated.
A string. The label or label condition on which to run the Pipeline or individual stage .
This option is valid for node , docker , and dockerfile , and is required for node .
A string. Run the Pipeline or individual stage this agent is applied to within this custom workspace, rather than the default. It can be either a relative path, in which case the custom workspace will be under the workspace root on the node, or an absolute path. For example:
This option is valid for node , docker , and dockerfile .
A boolean, false by default. If true, run the container on the node specified at the top-level of the Pipeline, in the same workspace, rather than on a new node entirely.
This option is valid for docker and dockerfile , and only has an effect when used on an agent for an individual stage .
A string. Runtime arguments to pass to docker run .
This option is valid for docker and dockerfile .
1
Execute all the steps defined in this Pipeline within a newly created container of the given name and tag ( maven:3.8.7-eclipse-temurin-11 ).
123
Defining agent none at the top-level of the Pipeline ensures that an Executor will not be assigned unnecessarily. Using agent none also forces each stage section to contain its own agent section. |
Execute the steps in this stage in a newly created container using this image. |
Execute the steps in this stage in a newly created container using a different image from the previous stage. |
The post section defines one or more additional steps that are run upon the completion of a Pipeline’s or stage’s run (depending on the location of the post section within the Pipeline). post can support any of the following post-condition blocks: always , changed , fixed , regression , aborted , failure , success , unstable , unsuccessful , and cleanup . These condition blocks allow the execution of steps inside each condition depending on the completion status of the Pipeline or stage. The condition blocks are executed in the order shown below.
In the top-level pipeline block and each stage block.
Conditions
Run the steps in the post section regardless of the completion status of the Pipeline’s or stage’s run.
Only run the steps in post if the current Pipeline’s run has a different completion status from its previous run.
Only run the steps in post if the current Pipeline’s run is successful and the previous run failed or was unstable.
Only run the steps in post if the current Pipeline’s or status is failure, unstable, or aborted and the previous run was successful.
Only run the steps in post if the current Pipeline’s run has an «aborted» status, usually due to the Pipeline being manually aborted. This is typically denoted by gray in the web UI.
Only run the steps in post if the current Pipeline’s or stage’s run has a «failed» status, typically denoted by red in the web UI.
Only run the steps in post if the current Pipeline’s or stage’s run has a «success» status, typically denoted by blue or green in the web UI.
Only run the steps in post if the current Pipeline’s run has an «unstable» status, usually caused by test failures, code violations, etc. This is typically denoted by yellow in the web UI.
Only run the steps in post if the current Pipeline’s or stage’s run has not a «success» status. This is typically denoted in the web UI depending on the status previously mentioned (for stages this may fire if the build itself is unstable).
Run the steps in this post condition after every other post condition has been evaluated, regardless of the Pipeline or stage’s status.
12
Conventionally, the post section should be placed at the end of the Pipeline. |
Post-condition blocks contain steps the same as the steps section. |
stages
Containing a sequence of one or more stage directives, the stages section is where the bulk of the «work» described by a Pipeline will be located. At a minimum, it is recommended that stages contain at least one stage directive for each discrete part of the continuous delivery process, such as Build, Test, and Deploy.
Only once, inside the pipeline block.
1
The stages section will typically follow the directives such as agent , options , etc.
steps
The steps section defines a series of one or more steps to be executed in a given stage directive.
Inside each stage block.
1
The steps section must contain one or more steps.
Directives
environment
The environment directive specifies a sequence of key-value pairs which will be defined as environment variables for all steps, or stage-specific steps, depending on where the environment directive is located within the Pipeline.
This directive supports a special helper method credentials() which can be used to access pre-defined Credentials by their identifier in the Jenkins environment.
Inside the pipeline block, or within stage directives.
Supported Credentials Type
the environment variable specified will be set to the Secret Text content
the environment variable specified will be set to the location of the File file that is temporarily created
Username and password
the environment variable specified will be set to username:password and two additional environment variables will be automatically defined: MYVARNAME_USR and MYVARNAME_PSW respectively.
SSH with Private Key
the environment variable specified will be set to the location of the SSH key file that is temporarily created and two additional environment variables may be automatically defined: MYVARNAME_USR and MYVARNAME_PSW (holding the passphrase).
Unsupported credentials type causes the pipeline to fail with the message: org.jenkinsci.plugins.credentialsbinding.impl.CredentialNotFoundException: No suitable binding handler could be found for type .
123
An environment directive used in the top-level pipeline block will apply to all steps within the Pipeline. |
An environment directive defined within a stage will only apply the given environment variables to steps within the stage . |
The environment block has a helper method credentials() defined which can be used to access pre-defined Credentials by their identifier in the Jenkins environment. |
options
The options directive allows configuring Pipeline-specific options from within the Pipeline itself. Pipeline provides a number of these options, such as buildDiscarder , but they may also be provided by plugins, such as timestamps .
Inside the pipeline block, or (with certain limitations) within stage directives.
Available Options
Persist artifacts and console output for the specific number of recent Pipeline runs. For example: options
Perform the automatic source control checkout in a subdirectory of the workspace. For example: options
Disallow concurrent executions of the Pipeline. Can be useful for preventing simultaneous accesses to shared resources, etc. For example: options
Do not allow the pipeline to resume if the controller restarts. For example: options
Used with docker or dockerfile top-level agent. When specified, each stage will run in a new container instance on the same node, rather than all stages running in the same container instance.
Allows overriding default treatment of branch indexing triggers. If branch indexing triggers are disabled at the multibranch or organization label, options < overrideIndexTriggers(true) >will enable them for this job only. Otherwise, options < overrideIndexTriggers(false) >will disable branch indexing triggers for this job only.
Preserve stashes from completed builds, for use with stage restarting. For example: options < preserveStashes() >to preserve the stashes from the most recent completed build, or options < preserveStashes(buildCount: 5) >to preserve the stashes from the five most recent completed builds.
Set the quiet period, in seconds, for the Pipeline, overriding the global default. For example: options
On failure, retry the entire Pipeline the specified number of times. For example: options
Skip checking out code from source control by default in the agent directive. For example: options
Skip stages once the build status has gone to UNSTABLE. For example: options
Set a timeout period for the Pipeline run, after which Jenkins should abort the Pipeline. For example: options
1
Specifying a global execution timeout of one hour, after which Jenkins will abort the Pipeline run.
Prepend all console output generated by the Pipeline run with the time at which the line was emitted. For example: options
Set failfast true for all subsequent parallel stages in the pipeline. For example: options
A comprehensive list of available options is pending the completion of help desk ticket 820.
stage options
The options directive for a stage is similar to the options directive at the root of the Pipeline. However, the stage -level options can only contain steps like retry , timeout , or timestamps , or Declarative options that are relevant to a stage , like skipDefaultCheckout .
Inside a stage , the steps in the options directive are invoked before entering the agent or checking any when conditions.
Available Stage Options
Skip checking out code from source control by default in the agent directive. For example: options
Set a timeout period for this stage, after which Jenkins should abort the stage. For example: options
1
Specifying an execution timeout of one hour for the Example stage, after which Jenkins will abort the Pipeline run.
On failure, retry this stage the specified number of times. For example: options
Prepend all console output generated during this stage with the time at which the line was emitted. For example: options
parameters
The parameters directive provides a list of parameters that a user should provide when triggering the Pipeline. The values for these user-specified parameters are made available to Pipeline steps via the params object, see the Parameters, Declarative Pipeline for its specific usage.
Only once, inside the pipeline block.
Available Parameters
A parameter of a string type, for example: parameters
A text parameter, which can contain multiple lines, for example: parameters
A boolean parameter, for example: parameters
A choice parameter, for example: parameters
A password parameter, for example: parameters
A comprehensive list of available parameters is pending the completion of help desk ticket 820.
triggers
The triggers directive defines the automated ways in which the Pipeline should be re-triggered. For Pipelines which are integrated with a source such as GitHub or BitBucket, triggers may not be necessary as webhooks-based integration will likely already be present. The triggers currently available are cron , pollSCM and upstream .
Only once, inside the pipeline block.
Accepts a cron-style string to define a regular interval at which the Pipeline should be re-triggered, for example: triggers < cron(‘H */4 * * 1-5’) >
Accepts a cron-style string to define a regular interval at which Jenkins should check for new source changes. If new changes exist, the Pipeline will be re-triggered. For example: triggers < pollSCM(‘H */4 * * 1-5’) >
Accepts a comma-separated string of jobs and a threshold. When any job in the string finishes with the minimum threshold, the Pipeline will be re-triggered. For example: triggers
The pollSCM trigger is only available in Jenkins 2.22 or later.
Jenkins cron syntax
The Jenkins cron syntax follows the syntax of the cron utility (with minor differences). Specifically, each line consists of 5 fields separated by TAB or whitespace:
Minutes within the hour (0–59)
The hour of the day (0–23)
The day of the month (1–31)
The month (1–12)
The day of the week (0–7) where 0 and 7 are Sunday.
To specify multiple values for one field, the following operators are available. In the order of precedence,
* specifies all valid values
M-N specifies a range of values
M-N/X or */X steps by intervals of X through the specified range or whole valid range
A,B,…,Z enumerates multiple values
To allow periodically scheduled tasks to produce even load on the system, the symbol H (for “hash”) should be used wherever possible. For example, using 0 0 * * * for a dozen daily jobs will cause a large spike at midnight. In contrast, using H H * * * would still execute each job once a day, but not all at the same time, better using limited resources.
The H symbol can be used with a range. For example, H H(0-7) * * * means some time between 12:00 AM (midnight) to 7:59 AM. You can also use step intervals with H , with or without ranges.
The H symbol can be thought of as a random value over a range, but it actually is a hash of the job name, not a random function, so that the value remains stable for any given project.
Beware that for the day of month field, short cycles such as */3 or H/3 will not work consistently near the end of most months, due to variable month lengths. For example, */3 will run on the 1st, 4th, …31st days of a long month, then again the next day of the next month. Hashes are always chosen in the 1-28 range, so H/3 will produce a gap between runs of between 3 and 6 days at the end of a month. (Longer cycles will also have inconsistent lengths but the effect may be relatively less noticeable.)
Empty lines and lines that start with # will be ignored as comments.
In addition, @yearly , @annually , @monthly , @weekly , @daily , @midnight , and @hourly are supported as convenient aliases. These use the hash system for automatic balancing. For example, @hourly is the same as H * * * * and could mean at any time during the hour. @midnight actually means some time between 12:00 AM and 2:59 AM.
Table 1. Jenkins cron syntax examples
every fifteen minutes (perhaps at :07, :22, :37, :52)
every ten minutes in the first half of every hour (three times, perhaps at :04, :14, :24)
once every two hours at 45 minutes past the hour starting at 9:45 AM and finishing at 3:45 PM every weekday.
once in every two hours slot between 9 AM and 5 PM every weekday (perhaps at 10:38 AM, 12:38 PM, 2:38 PM, 4:38 PM)
once a day on the 1st and 15th of every month except December
stage
The stage directive goes in the stages section and should contain a steps section, an optional agent section, or other stage-specific directives. Practically speaking, all of the real work done by a Pipeline will be wrapped in one or more stage directives.
One mandatory parameter, a string for the name of the stage.
Inside the stages section.
tools
A section defining tools to auto-install and put on the PATH . This is ignored if agent none is specified.
Inside the pipeline block or a stage block.
Supported Tools
1
The tool name must be pre-configured in Jenkins under Manage Jenkins → Global Tool Configuration.
input
The input directive on a stage allows you to prompt for input, using the input step. The stage will pause after any options have been applied, and before entering the agent block for that stage or evaluating the when condition of the stage . If the input is approved, the stage will then continue. Any parameters provided as part of the input submission will be available in the environment for the rest of the stage .
Configuration options
Required. This will be presented to the user when they go to submit the input .
An optional identifier for this input . The default value is based on the stage name.
Optional text for the «ok» button on the input form.
An optional comma-separated list of users or external group names who are allowed to submit this input . Defaults to allowing any user.
An optional name of an environment variable to set with the submitter name, if present.
An optional list of parameters to prompt the submitter to provide. See parameters for more information.
The when directive allows the Pipeline to determine whether the stage should be executed depending on the given condition. The when directive must contain at least one condition. If the when directive contains more than one condition, all the child conditions must return true for the stage to execute. This is the same as if the child conditions were nested in an allOf condition (see the examples below). If an anyOf condition is used, note that the condition skips remaining tests as soon as the first «true» condition is found.
More complex conditional structures can be built using the nesting conditions: not , allOf , or anyOf . Nesting conditions may be nested to any arbitrary depth.
Inside a stage directive
Built-in Conditions
Execute the stage when the branch being built matches the branch pattern (ANT style path glob) given, for example: when < branch ‘master’ >. Note that this only works on a multibranch Pipeline.
The optional parameter comparator may be added after an attribute to specify how any patterns are evaluated for a match: EQUALS for a simple string comparison, GLOB (the default) for an ANT style path glob (same as for example changeset ), or REGEXP for regular expression matching. For example: when
Execute the stage when the build is building a tag. Example: when
Execute the stage if the build’s SCM changelog contains a given regular expression pattern, for example: when
Execute the stage if the build’s SCM changeset contains one or more files matching the given pattern. Example: when < changeset «**/*.js» >
The optional parameter comparator may be added after an attribute to specify how any patterns are evaluated for a match: EQUALS for a simple string comparison, GLOB (the default) for an ANT style path glob case insensitive, this can be turned off with the caseSensitive parameter, or REGEXP for regular expression matching. For example: when < changeset pattern: «.TEST\.java», comparator: «REGEXP» > or when < changeset pattern: «*/*TEST.java», caseSensitive: true >
Executes the stage if the current build is for a «change request» (a.k.a. Pull Request on GitHub and Bitbucket, Merge Request on GitLab, Change in Gerrit, etc.). When no parameters are passed the stage runs on every change request, for example: when < changeRequest() >.
By adding a filter attribute with parameter to the change request, the stage can be made to run only on matching change requests. Possible attributes are id , target , branch , fork , url , title , author , authorDisplayName , and authorEmail . Each of these corresponds to a CHANGE_* environment variable, for example: when < changeRequest target: ‘master’ >.
The optional parameter comparator may be added after an attribute to specify how any patterns are evaluated for a match: EQUALS for a simple string comparison (the default), GLOB for an ANT style path glob (same as for example changeset ), or REGEXP for regular expression matching. Example: when
Execute the stage when the specified environment variable is set to the given value, for example: when
Execute the stage when the expected value is equal to the actual value, for example: when
Execute the stage when the specified Groovy expression evaluates to true, for example: when < expression < return params.DEBUG_BUILD >> Note that when returning strings from your expressions they must be converted to booleans or return null to evaluate to false. Simply returning «0» or «false» will still evaluate to «true».
Execute the stage if the TAG_NAME variable matches the given pattern. Example: when < tag «release-*» >. If an empty pattern is provided the stage will execute if the TAG_NAME variable exists (same as buildingTag() ).
The optional parameter comparator may be added after an attribute to specify how any patterns are evaluated for a match: EQUALS for a simple string comparison, GLOB (the default) for an ANT style path glob (same as for example changeset ), or REGEXP for regular expression matching. For example: when
Execute the stage when the nested condition is false. Must contain one condition. For example: when < not < branch ‘master’ >>
Execute the stage when all of the nested conditions are true. Must contain at least one condition. For example: when < allOf < branch ‘master’; environment name: ‘DEPLOY_TO’, value: ‘production’ >>
Execute the stage when at least one of the nested conditions is true. Must contain at least one condition. For example: when < anyOf < branch ‘master’; branch ‘staging’ >>
Execute the stage when the current build has been triggered by the param given. For example:
Evaluating when before entering agent in a stage
By default, the when condition for a stage will be evaluated after entering the agent for that stage , if one is defined. However, this can be changed by specifying the beforeAgent option within the when block. If beforeAgent is set to true , the when condition will be evaluated first, and the agent will only be entered if the when condition evaluates to true.
Evaluating when before the input directive
By default, the when condition for a stage will not be evaluated before the input, if one is defined. However, this can be changed by specifying the beforeInput option within the when block. If beforeInput is set to true, the when condition will be evaluated first, and the input will only be entered if the when condition evaluates to true.
beforeInput true takes precedence over beforeAgent true .
Evaluating when before the options directive
By default, the when condition for a stage will be evaluated after entering the options for that stage , if any are defined. However, this can be changed by specifying the beforeOptions option within the when block. If beforeOptions is set to true , the when condition will be evaluated first, and the options will only be entered if the when condition evaluates to true.
beforeOptions true takes precedence over beforeInput true and beforeAgent true .
Sequential Stages
Stages in Declarative Pipeline may have a stages section containing a list of nested stages to be run in sequential order. Note that a stage must have one and only one of steps , stages , parallel , or matrix . It is not possible to nest a parallel or matrix block within a stage directive if that stage directive is nested within a parallel or matrix block itself. However, a stage directive within a parallel or matrix block can use all other functionality of a stage , including agent , tools , when , etc.
Parallel
Stages in Declarative Pipeline may have a parallel section containing a list of nested stages to be run in parallel. Note that a stage must have one and only one of steps , stages , parallel , or matrix . It is not possible to nest a parallel or matrix block within a stage directive if that stage directive is nested within a parallel or matrix block itself. However, a stage directive within a parallel or matrix block can use all other functionality of a stage , including agent , tools , when , etc.
In addition, you can force your parallel stages to all be aborted when any one of them fails, by adding failFast true to the stage containing the parallel . Another option for adding failfast is adding an option to the pipeline definition: parallelsAlwaysFailFast()
Matrix
Stages in Declarative Pipeline may have a matrix section defining a multi-dimensional matrix of name-value combinations to be run in parallel. We’ll refer these combinations as «cells» in a matrix. Each cell in a matrix can include one or more stages to be run sequentially using the configuration for that cell. Note that a stage must have one and only one of steps , stages , parallel , or matrix . It is not possible to nest a parallel or matrix block within a stage directive if that stage directive is nested within a parallel or matrix block itself. However, a stage directive within a parallel or matrix block can use all other functionality of a stage , including agent , tools , when , etc.
In addition, you can force your matrix cells to all be aborted when any one of them fails, by adding failFast true to the stage containing the matrix . Another option for adding failfast is adding an option to the pipeline definition: parallelsAlwaysFailFast()
The matrix section must include an axes section and a stages section. The axes section defines the values for each axis in the matrix. The stages section defines a list of stage s to run sequentially in each cell. A matrix may have an excludes section to remove invalid cells from the matrix. Many of the directives available on stage , including agent , tools , when , etc., can also be added to matrix to control the behavior of each cell.
The axes section specifies one or more axis directives. Each axis consists of a name and a list of values . All the values from each axis are combined with the others to produce the cells.
Источник
buildResult = build job: ‘/marslo/artifactory-lib’,
buildResult.each { println it }
«result» : ${buildResult.result}
«getBuildVariables()» : ${buildResult.getBuildVariables()}
«getBuildVariables().mytest» : ${buildResult.getBuildVariables().mytest}
«getRawBuild().getEnvVars()» : ${buildResult.getRawBuild().getEnvVars()}
«getRawBuild().getEnvironment()» : ${buildResult.getRawBuild.getEnvironment()}
«getBuildCauses()» : ${buildResult.getBuildCauses()}
«getChangeSets()» : ${buildResult.getChangeSets()}
«buildVariables[«mytest»]» : ${buildResult.buildVariables[«mytest»]}
«buildResult.rawBuild» : ${buildResult.rawBuild}
«buildResult.rawBuild.log» : ${buildResult.rawBuild.log}
«rawBuild.environment.RUN_CHANGES_DISPLAY_URL» : ${buildResult.rawBuild.environment.RUN_CHANGES_DISPLAY_URL}
addEmbeddableBadgeConfiguration
: Add an Embeddable Badge Configurationid
-
Type:String
animatedOverlayColor
(optional)-
Type:String
color
(optional)-
Type:String
link
(optional)-
Type:String
status
(optional)-
Type:String
subject
(optional)-
Type:String
ansiColor
: Color ANSI Console OutputAdds support for standard ANSI escape sequences, including color, to Console Output.
colorMapName
-
Type:String
archiveArtifacts
: Archive the artifacts
Archives the build artifacts (for example, distribution zip files or jar files)
so that they can be downloaded later.
Archived files will be accessible from the Jenkins webpage.
Normally, Jenkins keeps artifacts for a build as long as a build log itself is kept,
but if you don’t need old artifacts and would rather save disk space, you can do so.
Note that the Maven job type automatically archives any produced Maven artifacts.
Any artifacts configured here will be archived on top of that.
Automatic artifact archiving can be disabled under the advanced Maven options.
The Pipeline Snippet Generator generates this example
when all arguments are set to true (some arguments by default are true):
archiveArtifacts artifacts: '**/*.txt',
allowEmptyArchive: true,
fingerprint: true,
onlyIfSuccessful: true
artifacts
-
You can use wildcards like ‘module/dist/**/*.zip’.
See
the includes attribute of Ant fileset for the exact format
— except that","
(comma) is the only supported separator.
The base directory is the workspace.
You can only archive files that are located in your workspace.Here are some examples of usage for pipeline:
- How to archive multiple artifacts from a specific folder:
archiveArtifacts artifacts: 'target/*.jar'
- How to archive multiple artifacts with different patterns:
archiveArtifacts artifacts: 'target/*.jar, target/*.war'
-
How to archive multiple nested artifacts:
archiveArtifacts artifacts: '**/*.jar'
Type:String
- How to archive multiple artifacts from a specific folder:
allowEmptyArchive
(optional)-
Normally, a build fails if archiving returns zero artifacts.
This option allows the archiving process to return nothing without failing the build.
Instead, the build will simply throw a warning.Type:boolean
caseSensitive
(optional)-
Artifact archiver uses Ant
org.apache.tools.ant.DirectoryScanner
which by default is case sensitive.
For instance, if the job produces *.hpi files, pattern «**/*.HPI» will fail to find them.This option can be used to disable case sensitivity. When it’s unchecked, pattern «**/*.HPI» will match any *.hpi files, or pattern «**/cAsEsEnSiTiVe.jar» will match a file called caseSensitive.jar.
Type:boolean
defaultExcludes
(optional)-
Type:boolean
excludes
(optional)-
Optionally specify the ‘excludes’ pattern, such as «foo/bar/**/*». Use «,» to set a list of patterns.
A file that matches this mask will not be archived even if it matches the
mask specified in ‘files to archive’ section.Type:String
fingerprint
(optional)-
Type:boolean
followSymlinks
(optional)-
By disabling this option all symbolic links found in the workspace will be ignored.
Type:boolean
onlyIfSuccessful
(optional)-
Type:boolean
associateTag
: Associate Tag (Nexus Repository Manager 3.x)nexusInstanceId
-
Type:String
tagName
-
The tag which will be applied to components matching the specified search criteria
Type:String
search
-
The search criteria used to locate components on the target Nexus Repository Manager server.
For more details, please seeSearch API
Array/List:
- Nested object
-
key
-
Type:String
value
-
Type:String
bat
: Windows Batch Scriptscript
-
Executes a Batch script. Multiple lines allowed.
When using thereturnStdout
flag, you probably wish to prefix this with@
,
lest the command itself be included in the output.Type:String
encoding
(optional)-
Encoding of process output.
In the case ofreturnStdout
, applies to the return value of this step;
otherwise, or always for standard error, controls how text is copied to the build log.
If unspecified, uses the system default encoding of the node on which the step is run.
If there is any expectation that process output might include non-ASCII characters,
it is best to specify the encoding explicitly.
For example, if you have specific knowledge that a given process is going to be producing UTF-8
yet will be running on a node with a different system encoding
(typically Windows, since every Linux distribution has defaulted to UTF-8 for a long time),
you can ensure correct output by specifying:encoding: 'UTF-8'
Type:String
label
(optional)-
Label to be displayed in the pipeline step view and blue ocean details for the step instead of the step type.
So the view is more meaningful and domain specific instead of technical.Type:String
returnStatus
(optional)-
Normally, a script which exits with a nonzero status code will cause the step to fail with an exception.
If this option is checked, the return value of the step will instead be the status code.
You may then compare it to zero, for example.Type:boolean
returnStdout
(optional)-
If checked, standard output from the task is returned as the step value as a
String
,
rather than being printed to the build log.
(Standard error, if any, will still be printed to the log.)
You will often want to call.trim()
on the result to strip off a trailing newline.Type:boolean
build
: Build a jobjob
-
Name of a downstream job to build.
May be another Pipeline job, but more commonly a freestyle or other project.
Use a simple name if the job is in the same folder as this upstream Pipeline job;
otherwise can use relative paths like../sister-folder/downstream
or absolute paths like/top-level-folder/nested-folder/downstream
.Type:String
parameters
(optional)-
A list of parameters to pass to the downstream job.
When passing secrets to downstream jobs, prefer credentials parameters over password parameters.
See the documentation for details.Array/List:
- Nested choice of objects
-
booleanParam
-
name
-
Type:String
value
-
Type:boolean
credentials
-
name
-
Type:String
value
-
Type:String
description
-
Type:String
file
-
name
-
Type:String
file
-
- Nested choice of objects
-
$class: 'ListSubversionTagsParameterValue'
-
name
-
Type:String
tagsDir
-
Type:String
tag
-
Type:String
password
-
name
-
Type:String
value
-
org.kohsuke.stapler.NoStaplerConstructorException: There's no @DataBoundConstructor on any constructor of class hudson.util.Secret
description
-
Type:String
$class: 'PromotedBuildParameterValue'
-
name
-
Type:String
runId
-
Type:String
description
-
Type:String
run
-
name
-
Type:String
runId
-
Type:String
description
-
Type:String
string
-
name
-
Type:String
value
-
Type:String
text
-
name
-
Type:String
value
-
Type:String
propagate
(optional)-
If enabled (default state), then the result of this step is that of the downstream build (e.g.,
success, unstable, failure, not built, or aborted).
If disabled, then this step succeeds even if the downstream build is unstable, failed, etc.;
use theresult
property of the return value as needed.Type:boolean
quietPeriod
(optional)-
Optional alternate quiet period (in seconds) before building.
If unset, defaults to the quiet period defined by the downstream project
(or finally to the system-wide default quiet period).Type:int
wait
(optional)-
If true, the pipeline will wait for the result of the build step before jumping to the next step. Defaults to true.
Type:boolean
catchError
: Catch error and set build result to failure
If the body throws an exception, mark the build as a failure, but nonetheless
continue to execute the Pipeline from the statement following the catchError
step.
The behavior of the step when an exception is thrown can be configured to print
a message, set a build result other than failure, change the stage result,
or ignore certain kinds of exceptions that are used to interrupt the build.
This step is most useful when used in Declarative Pipeline or with the
options to set the stage result or ignore build interruptions. Otherwise,
consider using plain try
—catch
(-finally
) blocks.
It is also useful when using certain post-build actions (notifiers)
originally defined for freestyle projects which pay attention to the result of the ongoing build.
node { catchError { sh 'might fail' } step([$class: 'Mailer', recipients: 'admin@somewhere']) }
If the shell step fails, the Pipeline build’s status will be set to failed, so that the subsequent mail step will see that this build is failed.
In the case of the mail sender, this means that it will send mail.
(It may also send mail if this build succeeded but previous ones failed, and so on.)
Even in that case, this step can be replaced by the following idiom:
node { try { sh 'might fail' } catch (err) { echo "Caught: ${err}" currentBuild.result = 'FAILURE' } step([$class: 'Mailer', recipients: 'admin@somewhere']) }
For other cases, plain try
—catch
(-finally
) blocks may be used:
node { sh './set-up.sh' try { sh 'might fail' echo 'Succeeded!' } catch (err) { echo "Failed: ${err}" } finally { sh './tear-down.sh' } echo 'Printed whether above succeeded or failed.' } // …and the pipeline as a whole succeeds
See this document for background.
buildResult
(optional)-
If an error is caught, the overall build result will be set to this value.
Note that the build result can only get worse, so you cannot change the result
toSUCCESS
if the current result isUNSTABLE
or worse.
UseSUCCESS
ornull
to keep the build result from
being set when an error is caught.Type:String
catchInterruptions
(optional)-
If true, certain types of exceptions that are used to interrupt the flow of
execution for Pipelines will be caught and handled by the step. If false,
those types of exceptions will be caught and immediately rethrown. Examples
of these types of exceptions include those thrown when a build is manually
aborted through the UI and those thrown by thetimeout
step. Defaults to true.Type:boolean
message
(optional)-
A message that will be logged to the console if an error is caught. If the
stage result is specified, the message will also be associated with that
result and may be shown in visualizations.Type:String
stageResult
(optional)-
If an error is caught, the stage result will be set to this value. If a
message was specified, the message will be associated with this result.
UseSUCCESS
ornull
to keep the stage result from
being set when an error is caught.Type:String
checkout
: Check out from version controlscm
-
- Nested choice of objects
-
$class: 'GitSCM'
-
The git plugin provides fundamental git operations for Jenkins projects.
It can poll, fetch, checkout, and merge contents of git repositories.The git plugin provides an SCM implementation to be used with the Pipeline SCM
checkout
step.
The Pipeline Syntax Snippet Generator guides the user to select git plugin checkout options and provides online help for each of the options.userRemoteConfigs
-
Specify the repository to track. This can be a URL or a local file path.
Note that for super-projects (repositories with submodules), only a local file
path or a complete URL is valid. The following are examples of valid git URLs.- ssh://git@github.com/github/git.git
- git@github.com:github/git.git (short notation for ssh protocol)
- ssh://user@other.host.com/~/repos/R.git (to access the repos/R.git
repository in the user’s home directory) - https://github.com/github/git.git
If the repository is a super-project, the
location from which to clone submodules is dependent on whether the repository
is bare or non-bare (i.e. has a working directory).- If the super-project is bare, the location of the submodules will be
taken from .gitmodules. - If the super-project is not bare, it is assumed that the
repository has each of its submodules cloned and checked out appropriately.
Thus, the submodules will be taken directly from a path like
${SUPER_PROJECT_URL}/${SUBMODULE}
, rather than relying on
information from .gitmodules.
For a local URL/path to a super-project,
git rev-parse —is-bare-repository
is used to detect whether the super-project is bare or not.
For a remote URL to a super-project, the ending of the URL determines whether
a bare or non-bare repository is assumed:- If the remote URL ends with /.git, a non-bare repository is
assumed. - If the remote URL does NOT end with /.git, a bare
repository is assumed.
Array/List:
- Nested object
-
url
-
Specify the URL or path of the git repository.
This uses the same syntax as yourgit clone
command.Type:String
name
-
ID of the repository, such as
origin
, to uniquely identify this repository among other remote repositories.
This is the same «name» that you use in yourgit remote
command. If left empty,
Jenkins will generate unique names for you.You normally want to specify this when you have multiple remote repositories.
Type:String
refspec
-
A refspec controls the remote refs to be retrieved and how they map to local refs. If left blank, it will default to
the normal behaviour ofgit fetch
, which retrieves all the branch heads asremotes/REPOSITORYNAME/BRANCHNAME
.
This default behaviour is OK for most cases.In other words, the default refspec is «+refs/heads/*:refs/remotes/REPOSITORYNAME/*» where
REPOSITORYNAME
is the value
you specify in the above «name of repository» textbox.When do you want to modify this value? A good example is when you want to just retrieve one branch. For example,
+refs/heads/master:refs/remotes/origin/master
would only retrieve the master branch and nothing else.The plugin uses a default refspec for its initial fetch, unless the «Advanced Clone Option» is set to honor refspec.
This keeps compatibility with previous behavior, and allows the job definition to decide if the refspec should be
honored on initial clone.Multiple refspecs can be entered by separating them with a space character.
+refs/heads/master:refs/remotes/origin/master +refs/heads/develop:refs/remotes/origin/develop
retrieves the master branch and the develop branch and nothing else.See the refspec definition in Git user manual for more details.
Type:String
credentialsId
-
Credential used to check out sources.
Type:String
branches
-
List of branches to build.
Jenkins jobs are most effective when each job builds only a single branch.
When a single job builds multiple branches, the changelog comparisons between branches often show no changes or incorrect changes.Array/List:
- Nested object
-
name
-
Specify the branches if you’d like to track a specific branch in a repository.
If left blank, all branches will be examined for changes and built.The safest way is to use the
refs/heads/<branchName>
syntax. This way the expected branch
is unambiguous.If your branch name has a
/
in it make sure to use the full reference above. When not presented
with a full path the plugin will only use the part of the string right of the last slash.
Meaningfoo/bar
will actually matchbar
.If you use a wildcard branch specifier, with a slash (e.g.
release/
),
you’ll need to specify the origin repository in the branch names to
make sure changes are picked up. So e.g.origin/release/
Possible options:
-
<branchName>
Tracks/checks out the specified branch. If ambiguous the first result is taken, which is not necessarily
the expected one. Better userefs/heads/<branchName>
.
E.g.master
,feature1
, … -
refs/heads/<branchName>
Tracks/checks out the specified branch.
E.g.refs/heads/master
,refs/heads/feature1/master
, … -
<remoteRepoName>/<branchName>
Tracks/checks out the specified branch. If ambiguous the first result is taken, which is not necessarily
the expected one.
Better userefs/heads/<branchName>
.
E.g.origin/master
-
remotes/<remoteRepoName>/<branchName>
Tracks/checks out the specified branch.
E.g.remotes/origin/master
-
refs/remotes/<remoteRepoName>/<branchName>
Tracks/checks out the specified branch.
E.g.refs/remotes/origin/master
-
<tagName>
This does not work since the tag will not be recognized as tag.
Userefs/tags/<tagName>
instead.
E.g.git-2.3.0
-
refs/tags/<tagName>
Tracks/checks out the specified tag.
E.g.refs/tags/git-2.3.0
-
<commitId>
Checks out the specified commit.
E.g.5062ac843f2b947733e6a3b105977056821bd352
,5062ac84
, … -
${ENV_VARIABLE}
It is also possible to use environment variables. In this case the variables are evaluated and the
result is used as described above.
E.g.${TREEISH}
,refs/tags/${TAGNAME}
, … -
<Wildcards>
The syntax is of the form:REPOSITORYNAME/BRANCH
.
In addition,BRANCH
is recognized as a shorthand of*/BRANCH
, ‘*’ is recognized as a wildcard,
and ‘**’ is recognized as wildcard that includes the separator ‘/’. Therefore,origin/branches*
would
matchorigin/branches-foo
but notorigin/branches/foo
, whileorigin/branches**
would
match bothorigin/branches-foo
andorigin/branches/foo
. -
:<regular expression>
The syntax is of the form::regexp
.
Regular expression syntax in branches to build will only
build those branches whose names match the regular
expression.
Examples::^(?!(origin/prefix)).*
- matches:
origin
ororigin/master
ororigin/feature
- does not match:
origin/prefix
ororigin/prefix_123
ororigin/prefix-abc
- matches:
:origin/release-d{8}
- matches:
origin/release-20150101
- does not match:
origin/release-2015010
ororigin/release-201501011
ororigin/release-20150101-something
- matches:
:^(?!origin/master$|origin/develop$).*
- matches:
origin/branch1
ororigin/branch-2
ororigin/master123
ororigin/develop-123
- does not match:
origin/master
ororigin/develop
- matches:
Type:String
-
browser
-
Defines the repository browser that displays changes detected by the git plugin.
- Nested choice of objects
-
$class: 'AssemblaWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://www.assembla.com/code/PROJECT/git/).
Type:String
bitbucketServer
-
repoUrl
-
Specify the Bitbucket Server root URL for this repository (such as https://bitbucket:7990/OWNER/REPO/).
Type:String
$class: 'BitbucketWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://bitbucket.org/OWNER/REPO/).
Type:String
$class: 'CGit'
-
repoUrl
-
Specify the root URL serving this repository (such as http://cgit.example.com:port/group/REPO/).
Type:String
$class: 'FisheyeGitRepositoryBrowser'
-
repoUrl
-
Specify the URL of this repository in FishEye (such as http://fisheye6.cenqua.com/browse/ant/).
Type:String
$class: 'GitBlitRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository.
Type:String
projectName
-
Specify the name of the project in GitBlit.
Type:String
$class: 'GitLab'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gitlabserver:port/group/REPO/).
Type:String
version
(optional)-
Specify the major and minor version of GitLab you use (such as 9.1). If you
don’t specify a version, a modern version of GitLab (>= 8.0) is assumed.Type:String
$class: 'GitList'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gitlistserver:port/REPO/).
Type:String
$class: 'GitWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://github.com/jenkinsci/jenkins.git).
Type:String
$class: 'GithubWeb'
-
repoUrl
-
Specify the HTTP URL for this repository’s GitHub page (such as https://github.com/jquery/jquery).
Type:String
$class: 'Gitiles'
-
repoUrl
-
Specify the root URL serving this repository (such as https://gwt.googlesource.com/gwt/).
Type:String
$class: 'GitoriousWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://gitorious.org/gitorious/mainline).
Type:String
$class: 'GogsGit'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gogs.example.com:port/username/some-repo-url.git).
Type:String
$class: 'KilnGit'
-
repoUrl
-
Specify the root URL serving this repository (such as https://khanacademy.kilnhg.com/Code/Website/Group/webapp).
Type:String
$class: 'Phabricator'
-
repoUrl
-
Specify the phabricator instance root URL (such as http://phabricator.example.com).
Type:String
repo
-
Specify the repository name in phabricator (such as the foo part of phabricator.example.com/diffusion/foo/browse).
Type:String
$class: 'RedmineWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as http://SERVER/PATH/projects/PROJECT/repository).
Type:String
$class: 'RhodeCode'
-
repoUrl
-
Specify the HTTP URL for this repository’s RhodeCode page (such as http://rhodecode.mydomain.com:5000/projects/PROJECT/repos/REPO/).
Type:String
$class: 'ScmManagerGitRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository (such as https://scm-manager.org/scm/repo/namespace/name).
Type:String
$class: 'Stash'
-
repoUrl
-
Specify the HTTP URL for this repository’s Stash page (such as http://stash.mydomain.com:7990/projects/PROJECT/repos/REPO/).
Type:String
$class: 'TFS2013GitRepositoryBrowser'
-
repoUrl
-
Either the name of the remote whose URL should be used, or the URL of this
module in TFS (such as http://fisheye6.cenqua.com/tfs/PROJECT/_git/REPO/).
If empty (default), the URL of the «origin» repository is used.If TFS is also used as the repository server, this can usually be left blank.
Type:String
$class: 'ViewGitWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as http://code.fealdia.org/viewgit/).
Type:String
projectName
-
Specify the name of the project in ViewGit (e.g. scripts, scuttle etc. from http://code.fealdia.org/viewgit/).
Type:String
gitTool
-
Absolute path to the git executable.
This is different from other Jenkins tool definitions.
Rather than providing the directory that contains the executable, you must provide the complete path to the executable.
Setting ‘/usr/bin/git
‘ would be correct, while setting ‘/usr/bin/
‘ is not correct.Type:String
extensions
-
Extensions add new behavior or modify existing plugin behavior for different uses.
Extensions help users more precisely tune plugin behavior to meet their needs.Extensions include:
-
Clone extensions modify the git operations that retrieve remote changes into the agent workspace.
The extensions can adjust the amount of history retrieved, how long the retrieval is allowed to run, and other retrieval details. -
Checkout extensions modify the git operations that place files in the workspace from the git repository on the agent.
The extensions can adjust the maximum duration of the checkout operation, the use and behavior of git submodules, the location of the workspace on the disc, and more. - Changelog extensions adapt the source code difference calculations for different cases.
- Tagging extensions allow the plugin to apply tags in the current workspace.
-
Build initiation extensions control the conditions that start a build.
They can ignore notifications of a change or force a deeper evaluation of the commits when polling. -
Merge extensions can optionally merge changes from other branches into the current branch of the agent workspace.
They control the source branch for the merge and the options applied to the merge.
Array/List:
- Nested choice of objects
-
$class: 'AuthorInChangelog'
-
The default behavior is to use the Git commit’s «Committer» value in Jenkins’ build changesets.
If this option is selected, the Git commit’s «Author» value would be used instead. $class: 'BuildChooserSetting'
-
When you are interested in using a job to build multiple heads (most typically multiple branches),
you can choose how Jenkins choose what branches to build in what order.This extension point in Jenkins is used by many other plugins to control the job to build
specific commits. When you activate those plugins, you may see them installing a custom strategy
here.buildChooser
-
- Nested choice of objects
-
$class: 'AncestryBuildChooser'
-
maximumAgeInDays
-
Type:int
ancestorCommitSha1
-
Type:String
$class: 'DefaultBuildChooser'
-
$class: 'InverseBuildChooser'
-
$class: 'BuildSingleRevisionOnly'
-
Disable scheduling for multiple candidate revisions.
If we have 3 branches:
—-A—.—.— B
——C
jenkins would try to build (B) and (C).
This behaviour disables this and only builds one of them.
It is helpful to reduce the load of the Jenkins infrastructure when the
SCM system like Bitbucket or GitHub should decide what commits to build. $class: 'ChangelogToBranch'
-
This method calculates the changelog against the specified branch.
options
-
- Nested object
-
compareRemote
-
Name of the repository, such as
origin
, that contains the branch you specify below.Type:String
compareTarget
-
The name of the branch within the named repository to compare against.
Type:String
$class: 'CheckoutOption'
-
timeout
-
Specify a timeout (in minutes) for checkout.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
$class: 'CleanBeforeCheckout'
-
Clean up the workspace before every checkout by deleting all untracked files and directories,
including those which are specified in.gitignore
.
It also resets all tracked files to their versioned state.
This ensures that the workspace is
in the same state as if you cloned and checked out in a brand-new empty directory, and ensures
that your build is not affected by the files generated by the previous build.deleteUntrackedNestedRepositories
(optional)-
Deletes untracked submodules and any other subdirectories which contain
.git
directories.Type:boolean
$class: 'CleanCheckout'
-
Clean up the workspace after every checkout by deleting all untracked files and directories,
including those which are specified in.gitignore
.
It also resets all tracked files to their versioned state.
This ensures that the workspace is
in the same state as if you cloned and checked out in a brand-new empty directory, and ensures
that your build is not affected by the files generated by the previous build.deleteUntrackedNestedRepositories
(optional)-
Deletes untracked submodules and any other subdirectories which contain
.git
directories.Type:boolean
$class: 'CloneOption'
-
shallow
-
Perform shallow clone, so that git will not download the history of the project,
saving time and disk space when you just want to access the latest version of a repository.Type:boolean
noTags
-
Deselect this to perform a clone without tags, saving time and disk space when you just want to access
what is specified by the refspec.Type:boolean
reference
-
Specify a folder containing a repository that will be used by Git as a reference during clone operations.
This option will be ignored if the folder is not available on the controller or agent where the clone is being executed.Type:String
timeout
-
Specify a timeout (in minutes) for clone and fetch operations.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
depth
(optional)-
Set shallow clone depth, so that git will only download recent history of the project,
saving time and disk space when you just want to access the latest commits of a repository.Type:int
honorRefspec
(optional)-
Perform initial clone using the refspec defined for the repository.
This can save time, data transfer and disk space when you only need
to access the references specified by the refspec.Type:boolean
$class: 'DisableRemotePoll'
-
Git plugin uses git ls-remote polling mechanism by default when configured with a single branch (no wildcards!).
This compare the latest built commit SHA with the remote branch without cloning a local copy of the repo.If you don’t want to / can’t use this.
If this option is selected, polling will require a workspace and might trigger unwanted builds (see JENKINS-10131).
$class: 'GitLFSPull'
-
Enable git large file support for the workspace by pulling large files after the checkout completes.
Requires that the controller and each agent performing an LFS checkout have installed `git lfs`. $class: 'IgnoreNotifyCommit'
-
If checked, this repository will be ignored when the notifyCommit-URL is accessed regardless of if the repository
matches or not. $class: 'LocalBranch'
-
If given, checkout the revision to build as HEAD on this branch.
If selected, and its value is an empty string or «**», then the branch
name is computed from the remote branch without the origin. In that
case, a remote branch origin/master will be checked out to a local
branch named master, and a remote branch origin/develop/new-feature
will be checked out to a local branch named develop/newfeature.Please note that this has not been tested with submodules.
localBranch
-
Type:String
$class: 'MessageExclusion'
-
excludedMessage
-
If set, and Jenkins is set to poll for changes, Jenkins will ignore any revisions committed with message matched to
Pattern when determining
if a build needs to be triggered. This can be used to exclude commits done by the build itself from triggering another build,
assuming the build server commits the change with a distinct message.Exclusion uses Pattern
matching.*[maven-release-plugin].*
The example above illustrates that if only revisions with «[maven-release-plugin]» message in first comment line
have been committed to the SCM a build will not occur.You can create more complex patterns using embedded flag expressions.
(?s).*FOO.*
This example will search FOO message in all comment lines.
Type:String
$class: 'PathRestriction'
-
If set, and Jenkins is set to poll for changes, Jenkins will pay attention to included and/or excluded files and/or
folders when determining if a build needs to be triggered.Using this behaviour will preclude the faster git ls-remote polling mechanism, forcing polling to require a workspace thus sometimes triggering unwanted builds, as if you had selected the Force polling using workspace extension as well.
includedRegions
-
Each inclusion uses java regular expression pattern matching,
and must be separated by a new line.
An empty list implies that everything is included.myapp/src/main/web/.*.html myapp/src/main/web/.*.jpeg myapp/src/main/web/.*.gif
The example above illustrates that a build will only occur, if html/jpeg/gif files
have been committed to the SCM. Exclusions take precedence over inclusions, if there is
an overlap between included and excluded regions.Type:String
excludedRegions
-
Each exclusion uses java regular expression pattern matching,
and must be separated by a new line.myapp/src/main/web/.*.html myapp/src/main/web/.*.jpeg myapp/src/main/web/.*.gif
The example above illustrates that if only html/jpeg/gif files have been committed to
the SCM a build will not occur.Type:String
$class: 'PerBuildTag'
-
Create a tag in the workspace for every build to unambiguously mark the commit that was built.
You can combine this with Git publisher to push the tags to the remote repository. $class: 'PreBuildMerge'
-
These options allow you to perform a merge to a particular branch before building.
For example, you could specify an integration branch to be built, and to merge to master.
In this scenario, on every change of integration, Jenkins will perform a merge with the master branch,
and try to perform a build if the merge is successful.
It then may push the merge back to the remote repository if the Git Push post-build action is selected.options
-
- Nested object
-
mergeTarget
-
The name of the branch within the named repository to merge to, such as
master
.Type:String
fastForwardMode
(optional)-
Merge fast-forward mode selection.
The default, —ff, gracefully falls back to a merge commit when required.
For more information, see the Git Merge Documentation mergeRemote
(optional)-
Name of the repository, such as
origin
, that contains the branch you specify below. If left blank,
it’ll default to the name of the first repository configured above.Type:String
mergeStrategy
(optional)-
Merge strategy selection.
This feature is not fully implemented in JGIT.Values:
DEFAULT
RESOLVE
RECURSIVE
OCTOPUS
OURS
SUBTREE
RECURSIVE_THEIRS
$class: 'PruneStaleBranch'
-
Run «git remote prune» for each remote, to prune obsolete local branches.
pruneTags
-
pruneTags
-
Type:boolean
$class: 'RelativeTargetDirectory'
-
relativeTargetDir
-
Specify a local directory (relative to the workspace root)
where the Git repository will be checked out. If left empty, the workspace root itself
will be used.This extension should not be used in Jenkins Pipeline (either declarative or scripted).
Jenkins Pipeline already provides standard techniques for checkout to a subdirectory.
Use ws and
dir
in Jenkins Pipeline rather than this extension.Type:String
$class: 'ScmName'
-
Unique name for this SCM. Needed when using Git within the Multi SCM plugin.
name
-
Type:String
$class: 'SparseCheckoutPaths'
-
Specify the paths that you’d like to sparse checkout. This may be used for saving space (Think about a reference repository).
Be sure to use a recent version of Git, at least above 1.7.10sparseCheckoutPaths
-
Array/List:
- Nested object
-
path
-
Type:String
$class: 'SubmoduleOption'
-
disableSubmodules
-
By disabling support for submodules you can still keep using basic
git plugin functionality and just have Jenkins to ignore submodules
completely as if they didn’t exist.Type:boolean
recursiveSubmodules
-
Retrieve all submodules recursively
(uses ‘—recursive’ option which requires git>=1.6.5)
Type:boolean
trackingSubmodules
-
Retrieve the tip of the configured branch in .gitmodules
(Uses ‘—remote’ option which requires git>=1.8.2)
Type:boolean
reference
-
Specify a folder containing a repository that will be used by Git as a reference during clone operations.
This option will be ignored if the folder is not available on the controller or agent where the clone is being executed.
To prepare a reference folder with multiple subprojects, create a bare git repository and add all the remote urls then perform a fetch:git init --bare git remote add SubProject1 https://gitrepo.com/subproject1 git remote add SubProject2 https://gitrepo.com/subproject2 git fetch --all
Type:String
timeout
-
Specify a timeout (in minutes) for submodules operations.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
parentCredentials
-
Use credentials from the default remote of the parent project.
Type:boolean
depth
(optional)-
Set shallow clone depth, so that git will only download recent history of the project,
saving time and disk space when you just want to access the latest commits of a repository.Type:int
shallow
(optional)-
Perform shallow clone, so that git will not download the history of the project,
saving time and disk space when you just want to access the latest version of a repository.Type:boolean
threads
(optional)-
Specify the number of threads that will be used to update submodules.
If unspecified, the command line git default thread count is used.Type:int
$class: 'UserExclusion'
-
excludedUsers
-
If set, and Jenkins is set to poll for changes, Jenkins will ignore any revisions committed by users in this list when determining if a build needs to be triggered. This can be used to exclude commits done by the build itself from triggering another build, assuming the build server commits the change with a distinct SCM user.
Using this behaviour will preclude the faster git ls-remote polling mechanism, forcing polling to require a workspace thus sometimes triggering unwanted builds, as if you had selected the Force polling using workspace extension as well.
Each exclusion uses exact string comparison and must be separated by a new line.
User names are only excluded if they exactly match one of the names in this list.auto_build_user
The example above illustrates that if only revisions by «auto_build_user» have been committed to the SCM a build will not occur.
Type:String
$class: 'UserIdentity'
-
name
-
If given, «GIT_COMMITTER_NAME=[this]» and «GIT_AUTHOR_NAME=[this]» are set for builds. This overrides whatever is in the global settings.
Type:String
email
-
If given, «GIT_COMMITTER_EMAIL=[this]» and «GIT_AUTHOR_EMAIL=[this]» are set for builds. This overrides whatever is in the global settings.
Type:String
$class: 'WipeWorkspace'
-
Delete the contents of the workspace before building, ensuring a fully fresh workspace.
-
Clone extensions modify the git operations that retrieve remote changes into the agent workspace.
doGenerateSubmoduleConfigurations
(optional)-
Removed facility that was intended to test combinations of git submodule versions.
Removed in git plugin 4.6.0.
Ignores the user provided value and always usesfalse
as its value.Type:boolean
submoduleCfg
(optional)-
Removed facility that was intended to test combinations of git submodule versions.
Removed in git plugin 4.6.0.
Ignores the user provided value(s) and always uses empty values.Array/List:
- Nested object
-
submoduleName
-
Removed in git plugin 4.6.0.
Type:String
branches
-
Removed in git plugin 4.6.0.
$class: 'MercurialSCM'
-
source
-
Specify the repository to track. This can be URL or a local file path.
If you are specifying HTTP credentials, do not include a username in the URL.Type:String
browser
(optional)-
- Nested choice of objects
-
$class: 'FishEye'
-
url
-
Specify the root URL serving this repository, such as: http://www.example.org/browse/hg/
Type:String
$class: 'GoogleCode'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'HgWeb'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'Kallithea'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'KilnHG'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'RhodeCode'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'RhodeCodeLegacy'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'ScmManager'
-
url
-
Specify the root URL serving this repository (such as
http://YOURSCMMANAGER/scm/repo/NAMESPACE/NAME/
).Type:String
clean
(optional)-
When this option is checked, each build will wipe any local modifications
or untracked files in the repository checkout.
This is often a convenient way to ensure that a build is not
using any artifacts from earlier builds.Type:boolean
credentialsId
(optional)-
Optional credentials to use when cloning or pulling from the remote repository.
Supports username/password with HTTP(S) URLs, and SSH private key with SSH URLs.Type:String
disableChangeLog
(optional)-
When checked, Hudson will not calculate the Mercurial changelog for each build.
Disabling the changelog can decrease the amount of time needed to update a
very large repository.Type:boolean
installation
(optional)-
Type:String
modules
(optional)-
Reduce unnecessary builds by specifying a comma or space delimited list of «modules» within the repository.
A module is a directory name within the repository that this project lives in. If this field is set,
changes outside the specified modules will not trigger a build (even though the whole repository is checked
out anyway due to the Mercurial limitation.)Type:String
revision
(optional)-
Specify the branch or tag name you would like to track.
(If you do not type anything, the default value is thedefault
branch.)Type:String
revisionType
(optional)-
Specify the kind of revision you expect Jenkins to update your working copy to.
Values:
BRANCH
TAG
CHANGESET
REVSET
subdir
(optional)-
If not empty, check out the Mercurial repository into this subdirectory of the
job’s workspace. For example:my/sources
(use forward slashes).
If changing this entry, you probably want to clean the workspace first.Type:String
none
-
$class: 'SubversionSCM'
-
Checks out the source code from Subversion repositories. See
post-commit hook set up for improved turn-around time and
performance in polling.locations
-
Array/List:
- Nested object
-
remote
-
Type:String
credentialsId
-
Type:String
local
-
Specify a local directory (relative to the workspace root)
where this module is checked out. If left empty, the last path component of the URL
is used as the default, just like thesvn
CLI.
A single period (.
) may be used to check out the project directly
into the workspace rather than into a subdirectory.Type:String
depthOption
-
—depth
option for checkout and update commands. Default value is
infinity
.
- empty includes only the immediate target of the operation, not any of its file or directory children.
- files includes the immediate target of the operation and any of its immediate file children.
- immediates includes the immediate target of the operation and any of its immediate file or directory children. The directory children will themselves be empty.
- infinity includes the immediate target, its file and directory children, its children’s children, and so on to full recursion.
- as-it-is takes the working depth from the current working copy, allows for setting update depth manually using —set-depth option.
More information can be found
here.Type:String
ignoreExternalsOption
-
«—ignore-externals» option will be used with svn checkout, svn update commands to disable externals definition processing.
More information can be found
here.
Note: there is the potential to leveragesvn:externals
to gain read access to the entire
Subversion repository. This can happen if you follow the normal practice of giving Jenkins
credentials with read access to the entire Subversion repository. You will also need to provide the credentials
to use when checking/polling out the svn:externals using the Additional Credentials option.Type:boolean
cancelProcessOnExternalsFail
-
Determines if the process should be cancelled when checkout/update svn:externals failed. Will work when «Ignore externals» box is not checked.
Default choice is to cancelled the process when checkout/update svn:externals failed.Type:boolean
workspaceUpdater
-
- Nested choice of objects
-
$class: 'CheckoutUpdater'
-
$class: 'NoopUpdater'
-
$class: 'UpdateUpdater'
-
$class: 'UpdateWithCleanUpdater'
-
$class: 'UpdateWithRevertUpdater'
-
browser
-
- Nested choice of objects
-
$class: 'Assembla'
-
spaceName
-
Type:String
$class: 'CollabNetSVN'
-
url
-
The repository browser URL for the root of the project.
For example, a Java.net project calledmyproject
would use
https://myproject.dev.java.net/source/browse/myproject
.
Type:String
$class: 'FishEyeSVN'
-
url
-
Specify the URL of this module in FishEye.
(such ashttp://fisheye6.cenqua.com/browse/ant/
)
Type:String
rootModule
-
Specify the root Subversion module that this FishEye monitors.
For example, forhttp://fisheye6.cenqua.com/browse/ant/
,
this field would beant
because it displays the directory «/ant»
of the ASF repo. If FishEye is configured to display the whole SVN repository,
leave this field empty.Type:String
svnPhabricator
-
url
-
Type:String
repo
-
Type:String
$class: 'SVNWeb'
-
url
-
Type:String
$class: 'ScmManagerSvnRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository (such as https://scm-manager.org/scm/repo/namespace/name).
Type:String
$class: 'Sventon'
-
url
-
Specify the URL of the Sventon repository browser.
For example, if you normally browse fromhttp://somehost.com/svn/repobrowser.svn?name=local
,
this field would behttp://somehost.com/svn/
Type:String
repositoryInstance
-
Specify the Sventon repository instance name that references this subversion repository.
For example, if you normally browse fromhttp://somehost.com/svn/repobrowser.svn?name=local
,
this field would belocal
Type:String
$class: 'Sventon2'
-
url
-
Specify the URL of the Sventon repository browser.
For example, if you normally browse fromhttp://somehost.com/svn/repobrowser.svn?name=local
,
this field would behttp://somehost.com/svn/
Type:String
repositoryInstance
-
Specify the Sventon repository instance name that references this subversion repository.
For example, if you normally browse fromhttp://somehost.com/svn/repobrowser.svn?name=local
,
this field would belocal
Type:String
$class: 'ViewSVN'
-
url
-
Specify the root URL of ViewSVN for this repository
(such as this).Type:String
$class: 'VisualSVN'
-
url
-
Type:String
$class: 'WebSVN'
-
url
-
Type:String
excludedRegions
-
If set, and Jenkins is set to poll for changes, Jenkins will ignore any files and/or
folders in this list when determining if a build needs to be triggered.Each exclusion uses regular expression pattern matching, and must be separated by a new line.
/trunk/myapp/src/main/web/.*.html /trunk/myapp/src/main/web/.*.jpeg /trunk/myapp/src/main/web/.*.gif
The example above illustrates that if only html/jpeg/gif files have been committed to
the SCM a build will not occur.More information on regular expressions can be found
here.Type:String
excludedUsers
-
If set, and Jenkins is set to poll for changes, Jenkins will ignore any revisions committed by users in this list when determining if a build needs to be triggered. This can be used to exclude commits done by the build itself from triggering another build, assuming the build server commits the change with a distinct SCM user.
Each exclusion uses literal pattern matching, and must be separated by a new line.
auto_build_user
The example above illustrates that if only revisions by «auto_build_user» have been committed to the SCM a build will not occur.
Type:String
excludedRevprop
-
If set, and Jenkins is set to poll for changes, Jenkins will ignore any revisions
that are marked with the given revision property (revprop) when determining if
a build needs to be triggered. This can be used to exclude commits done by the
build itself from triggering another build, assuming the build server commits
the change with the correct revprop.This type of exclusion only works with Subversion 1.5 servers and newer.
More information on revision properties can be found
here.Type:String
excludedCommitMessages
-
If set, and Jenkins is set to poll for changes, Jenkins will ignore any revisions
with commit messages containing any of the given regular expressions when
determining if a build needs to be triggered.Type:String
includedRegions
-
If set, and Jenkins is set to poll for changes, Jenkins will ignore any files and/or
folders that are not in this list when determining if a build needs to be triggered.Each inclusion uses regular expression pattern matching, and must be separated by a new line.
This is useful when you need to check out an entire resource for building, but only want to do
the build when a subset has changed./trunk/myapp/c/library1/.* /trunk/myapp/c/library2/.*
If /trunk/myapp is checked out, the build will only occur when there are changes to
either the c/library1 and c/library2 subtrees.If there are also excluded regions specified, then a file is not ignored when it is in
the included list and not in the excluded list.More information on regular expressions can be found
here.Type:String
ignoreDirPropChanges
-
If set, Jenkins ignores svn-property only changes of directories.
These changes are ignored when determining whether a build should be triggered and are removed from a
build’s changeset.
Main usage of this property is to ignore svn:mergeinfo changes (which would otherwise e.g. lead to a complete rebuild
of a maven project, in spite of incremental build option).Type:boolean
filterChangelog
-
If set Jenkins will apply the same inclusion and exclusion patterns for displaying changelog entries as it does for polling for changes.
If this is disabled, changes which are excluded for polling are still displayed in the changelog.Type:boolean
additionalCredentials
-
If there are additional credentials required in order to obtain a complete checkout of the source, they can be
provided here.The realm is how the repository self-identifies to a client. It usually has the following format:
<proto://host:port> Realm Name
proto
is the protocol, e.g.http
orsvn
.host
is the host how it’s accessed by Jenkins, e.g. as IP address192.168.1.100
, host namesvnserver
, or host name and domainsvn.example.org
.port
is the port, even if not explicitly specified. By default, this is80
for HTTP,443
for HTTPS, 3690 for thesvn
protocol.Realm Name
is how the repository self-identifies. Common options includeVisualSVN Server
,Subversion Authentication
or the UUID of the repository.
To find out the realm, you could do any of the following:
- If you access the repository via HTTP or HTTPS: Open the repo in a web browser without saved credentials. It will use the
Realm Name
(see above) in the authentication dialog. - Use the command line
svn
program.- If you don’t have stored the credentials, run e.g.
svn info https://svnserver/repo
and it will tell you the realm when asking you to enter a password, e.g.: Authentication realm: <svn://svnserver:3690> VisualSVN Server. - If you have already stored the credentials to access the repository, look for the realm name in one of the files in
~/.subversion/auth/svn/simple
; it will be two lines below the linesvn:realmstring
.
- If you don’t have stored the credentials, run e.g.
- When accessing a repository via the
svn+ssh
protocol, the realm has the formatusername@svn+ssh://host:port
– note that the username is before thesvn+ssh://
(unlike the URL used for normal SVN operations), and that there are no angle brackets and no realm name. For this protocol the default port is 22.
Make sure to enter the realm exactly as shown, starting with a
<
(except for repositories accessed viasvn+ssh
– see above).Array/List:
- Nested object
-
realm
-
This is the realm that the SvnKit library associates with a specific checkout. For most Subversion servers this
will typically be of the format<scheme://hostname(:port)> name
,
while for servers accessed viasvn+ssh
it is of the format(username@)svn+ssh://hostname(:port)
.Type:String
credentialsId
-
Select the credential from the list of relevant credentials in order to use that credential for checking out
the source code.Type:String
quietOperation
-
Mimics subversion command line
--quiet
parameter for check out / update operations to help keep the output shorter. Prints nothing, or only summary information.Type:boolean
changelog
(optional)-
Enable or Disable ‘Include in changelog’:
If ‘Include in changelog’ is enabled for an SCM source, then when a build occurs, the changes from that SCM source will be included in the changelog.
If ‘Include in changelog’ is disabled, then when a build occurs,
the changes from this SCM source will not be included in the changelog.Type:boolean
poll
(optional)-
Enable or Disable ‘Include in polling’
If ‘Include in polling’ is enabled or ‘Include in changelog’ is enabled, then when polling occurs, the job will
be started if changes are detected from this SCM source.If ‘Include in polling’ is disabled and ‘Include in changelog’ is disabled, then when polling occurs, changes
that are detected from this repository will be ignored.Type:boolean
compareVersions
: Compare two version number strings
Compare two version numbers with each other.
See VersionNumber.java
for how version strings are handled.
The return value is an Integer;
-1
ifv1 < v2
0
ifv1 == v2
1
ifv1 > v2
v1
-
The version number string that will be compared to
v2
.Type:String
v2
-
The version number string that
v1
will be compared to.Type:String
failIfEmpty
(optional)-
Fail the build if
v1
orv2
is empty ornull
.By default the empty string or
null
is treated as the lowest version and will not fail the build.
I.e.:null
compared tonull
== 0
- empty compared to empty
== 0
null
compared to empty== 0
null
or empty compared to anything== -1
- anything compared to
null
or empty== 1
Type:boolean
configFileProvider
: Provide Configuration filesmanagedFiles
-
Array/List:
-
fileId
-
Name of the file.
Type:String
replaceTokens
(optional)-
Decides whether the token should be replaced using macro.
Type:boolean
targetLocation
(optional)-
Name of the file (with optional file relative to workspace directory) where the config file should be copied.
Type:String
variable
(optional)-
Name of the variable which can be used as the reference for further configuration.
Type:String
configFile
-
container
: Run build steps in a containerSelects a container of the agent pod so that all shell steps are executed in that container.
name
-
Type:String
shell
(optional)-
Specifies a shell which will run inside the container
and process requests from Jenkins to run executables,
set environment variables, and similar infrastructure.This does not affect the shell used to run user code,
such assh
steps.
To run your scripts with a specific shell on Linux, use an interpreter line:sh '''#!/bin/bash for x in {0..9}; do echo x; done '''
or just use a subprocess and an externally versioned script:
sh 'bash ci.sh'
On Windows, choose between the
bat
orpowershell
steps.For a pod running on Linux, defaults to
sh
, which should be in$PATH
;
for a pod running on Windows, defaults tocmd
, which should be in%Path%
.
Should not generally be overridden.Type:String
createTag
: Create Tag (Nexus Repository Manager 3.x)nexusInstanceId
-
Type:String
tagName
-
Tag name is required and must be unique. Name can only contain letters, numbers, underscores, hyphens and dots and
cannot start with an underscore or dot. The name cannot exceed 256 charactersType:String
tagAttributesJson
(optional)-
Optional metadata for the tag in JSON format. These attributes will be merged with those contained in the
attributes file if both are provided. Attributes in this field will override those present in the fileType:String
tagAttributesPath
(optional)-
The file path (environment-aware) to the optional metadata for the tag, using the workspace as the base path
Type:String
deleteComponents
: Delete Components (Nexus Repository Manager 3.x)nexusInstanceId
-
Type:String
tagName
-
Components associated with this tag will be deleted
Type:String
deleteDir
: Recursively delete the current directory from the workspace
Recursively deletes the current directory and its contents.
Symbolic links and junctions will not be followed but will be removed.
To delete a specific directory of a workspace wrap the deleteDir
step in a dir
step.
dependencyCheck
: Invoke Dependency-CheckadditionalArguments
(optional)-
Type:String
odcInstallation
(optional)-
Type:String
skipOnScmChange
(optional)-
Type:boolean
skipOnUpstreamChange
(optional)-
Type:boolean
dependencyCheckPublisher
: Publish Dependency-Check resultsfailedNewCritical
(optional)-
Type:int
failedNewHigh
(optional)-
Type:int
failedNewLow
(optional)-
Type:int
failedNewMedium
(optional)-
Type:int
failedTotalCritical
(optional)-
Type:int
failedTotalHigh
(optional)-
Type:int
failedTotalLow
(optional)-
Type:int
failedTotalMedium
(optional)-
Type:int
newThresholdAnalysisExploitable
(optional)-
Type:boolean
pattern
(optional)-
Type:String
totalThresholdAnalysisExploitable
(optional)-
Type:boolean
unstableNewCritical
(optional)-
Type:int
unstableNewHigh
(optional)-
Type:int
unstableNewLow
(optional)-
Type:int
unstableNewMedium
(optional)-
Type:int
unstableTotalCritical
(optional)-
Type:int
unstableTotalHigh
(optional)-
Type:int
unstableTotalLow
(optional)-
Type:int
unstableTotalMedium
(optional)-
Type:int
dependencyTrackPublisher
: Publish BOM to Dependency-Trackartifact
-
Specifies the artifact to upload. Dependency-Track supports uploading of CycloneDX bill-of-materials (BOM) formats.
See Best Practices
for additional information.The value can contain environment variables in the form of
${VARIABLE_NAME}
which are resolved.Type:String
synchronous
-
Synchronous publishing mode uploads a BOM to Dependency-Track and waits for Dependency-Track to process
and return results. The results returned are identical to the auditable findings but exclude findings that
have previously been suppressed. Analysis decisions and vulnerability details are included in the response.This feature provides per-build results that display all finding details as well as interactive charts that
display trending information.Synchronous mode is possible with Dependency-Track v3.3.1 and higher.
The API key provided requires the VIEW_VULNERABILITY permission to use this feature with Dependency-Track v4.4 and newer!
Type:boolean
autoCreateProjects
(optional)-
Enable auto creation of projects when authentication is enabled on Dependency-Track and the API key provided has the PROJECT_CREATION_UPLOAD permission.
Type:boolean
dependencyTrackApiKey
(optional)-
When authentication is enabled on Dependency-Track, a valid API key will be required.
Type:String
dependencyTrackFrontendUrl
(optional)-
The alternative base URL to the Frontend of Dependency-Track v3 or higher. (i.e. http://hostname:port)
Use this if you run backend and frontend on different servers. If omitted, «Dependency-Track Backend URL» will be used instead.
Type:String
dependencyTrackUrl
(optional)-
The base URL to Dependency-Track Backend (i.e. http://hostname:port)
Type:String
failedNewCritical
(optional)-
Type:int
failedNewHigh
(optional)-
Type:int
failedNewLow
(optional)-
Type:int
failedNewMedium
(optional)-
Type:int
failedTotalCritical
(optional)-
Type:int
failedTotalHigh
(optional)-
Type:int
failedTotalLow
(optional)-
Type:int
failedTotalMedium
(optional)-
Type:int
overrideGlobals
(optional)-
Allows to override global settings for «Auto Create Projects», «Dependency-Track URL», «Dependency-Track Frontend URL» and «API key».
Can be ignored in pipelines, just set the properties
dependencyTrackUrl
,dependencyTrackFrontendUrl
,dependencyTrackApiKey
andautoCreateProjects
as needed.Type:boolean
projectId
(optional)-
Specifies the unique Project ID of the project to upload scan results to. The Project ID is a UUID
with the following format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxIf the list of projects are not displayed (such as an HTTP 403 response), ensure the API key
specified in the global configuration has VIEW_PORTFOLIO permission in addition to BOM_UPLOAD
and/or SCAN_UPLOAD. Permissions are defined in Dependency-Track.Type:String
projectName
(optional)-
Specifies the name of the project for automatic creation of project during the upload process.
This is an alternative to specifying the unique UUID. It must be used together with a project version.
Ensure the API key specified in the global configuration has PROJECT_CREATION_UPLOAD permission and that you have enabled
Auto Create Projects
.The value can contain environment variables in the form of
${VARIABLE_NAME}
which are resolved.Type:String
projectProperties
(optional)-
Set additional properties for the given project.
The API key provided requires the PORTFOLIO_MANAGEMENT permission to use this feature!
- Nested object
-
description
(optional)-
The description to be set for the project.
Type:String
group
(optional)-
Specifies the value of «Namespace / Group / Vendor» to be set for the project.
Type:String
swidTagId
(optional)-
Specifies the SWID Tag ID to be set for the project.
Type:String
tags
(optional)-
Specifies the list of tags to be set for the project. Separate multiple tags with spaces or put each tag on a separate line.
All tags are automatically lowercased!
- Nested choice of objects
- (not enumerable)
projectVersion
(optional)-
Specifies the version of the project for automatic creation of project during the upload process.
This is an alternative to specifying the unique UUID. It must be used together with a project name.
Ensure the API key specified in the global configuration has PROJECT_CREATION_UPLOAD permission and that you have enabled
Auto Create Projects
.The value can contain environment variables in the form of
${VARIABLE_NAME}
which are resolved.Type:String
unstableNewCritical
(optional)-
Type:int
unstableNewHigh
(optional)-
Type:int
unstableNewLow
(optional)-
Type:int
unstableNewMedium
(optional)-
Type:int
unstableTotalCritical
(optional)-
Type:int
unstableTotalHigh
(optional)-
Type:int
unstableTotalLow
(optional)-
Type:int
unstableTotalMedium
(optional)-
Type:int
dir
: Change current directory
Change current directory. Any step inside the dir
block will
use this directory as current and any relative path will use it as base path.
path
-
The relative path of the directory in the workspace to use as a new working directory.
Type:String
discoverReferenceBuild
: Discover reference buildreferenceJob
(optional)-
The reference job is the baseline that is used to determine which of the issues in the current
build are new, outstanding, or fixed. This baseline is also used to determine the number of new issues for the
quality gate evaluation.Type:String
echo
: Print Messagemessage
-
The message to write to the console output.
Type:String
error
: Error signal
Signals an error.
Useful if you want to conditionally abort some part of your program.
You can also just throw new Exception()
,
but this step will avoid printing a stack trace.
message
-
The message that will be logged to the console when an error is caught.
Type:String
fileExists
: Verify if file exists in workspace
Checks if the given file exists on the current node.
Returns true | false
.
This step must be run inside a node
context:
# Declarative Syntax stage ('Check for existence of index.html') { agent any # Could be a top-level directive or a stage level directive steps { script { if (fileExists('src/main/rersources/index.html') { echo "File src/main/rersources/index.html found!" } } } }
With the Declarative Syntax, it must be run in a stage with a defined agent (e.g. different than `agent none`):
# Scripted Syntax node { if (fileExists('src/main/rersources/index.html') { echo "File src/main/rersources/index.html found!" } }
file
-
Path to a file or a directory to verify its existence.
- Both absolute and relative paths are supported. When using relative path, it is relative to the current working directory (by default: the workspace).
- Both Unix and Windows path are supported using a
/
separator:
node('Linux') { if (fileExists('/usr/local/bin/jenkins.sh') { sh '/usr/local/bin/jenkins.sh' } } node('Windows') { if (fileExists('C:/jenkins.exe') { bat 'C:/jenkins.exe' } }
When using a Windows path with the backslash (
) separator, do not forget to escape it:
node(‘Windows’) {
if (fileExists(‘src\main\resources’) {
echo ‘Found a directory resources.’
}
}
Type:String
findFiles
: Find files in the workspace
Find files in the current working directory.
The step returns an array of file info objects who’s properties you can see in the below example.
Ex:
def files = findFiles(glob: '**/TEST-*.xml')
echo """${files[0].name}
${files[0].path}
${files[0].directory}
${files[0].length}
${files[0].lastModified}"""
excludes
(optional)-
Type:String
glob
(optional)-
Ant style pattern
of file paths that should match. If this property is set all descendants of the
current working directory will be searched for a match and returned,
if it is omitted only the direct descendants of the directory will be returned.Type:String
fingerprint
: Record fingerprints of files to track usage
Jenkins can record the ‘fingerprint’ of files (most often jar files) to keep track
of where/when those files are produced and used. When you have inter-dependent
projects on Jenkins, this allows you to quickly find out answers to questions like:
-
I have
foo.jar
on my HDD but which build number of FOO did it come from? -
My BAR project depends on
foo.jar
from the FOO project. -
-
Which build of
foo.jar
is used in BAR #51? -
Which build of BAR contains my bug fix to
foo.jar
#32?
-
Which build of
To use this feature, all of the involved projects (not just the project
in which a file is produced, but also the projects in which the file
is used) need to use this and record fingerprints.
See this document
for more details.
targets
-
Type:String
caseSensitive
(optional)-
Fingerprinter uses Ant
org.apache.tools.ant.DirectoryScanner
which by default is case sensitive.
For instance, if the job produces *.hpi files, pattern «**/*.HPI» will fail to find them.This option can be used to disable case sensitivity. When it’s unchecked, pattern «**/*.HPI» will match any *.hpi files, or pattern «**/cAsEsEnSiTiVe.jar» will match a file called caseSensitive.jar.
Type:boolean
defaultExcludes
(optional)-
Type:boolean
excludes
(optional)-
Optionally specify the ‘excludes’ pattern, such as «foo/bar/**/*». Use «,» to set a list of patterns.
A file that matches this mask will not be fingerprinted even if it matches the
mask specified in ‘files to fingerprint’ section.Type:String
git
: GitGit step. It performs a clone from the specified repository.
Use the Pipeline Syntax Snippet Generator to generate a sample pipeline script for the git step.
More advanced checkout operations require the checkout
step rather than the git
step.
Examples of the git
step include:
- Git step with defaults
- Git step with https and a specific branch
- Git step with ssh and a private key credential
- Git step with https and changelog disabled
- Git step with git protocol and polling disabled
See the argument descriptions for more details.
The git
step is a simplified shorthand for a subset of the more powerful checkout
step:
checkout([$class: 'GitSCM', branches: [[name: '*/master']], userRemoteConfigs: [[url: 'http://git-server/user/repository.git']]])
NOTE: The checkout
step is the preferred SCM checkout method.
It provides significantly more functionality than the git
step.
Use the Pipeline Syntax Snippet Generator to generate a sample pipeline script for the checkout step.
The checkout
step can be used in many cases where the git
step cannot be used.
Refer to the git plugin documentation for detailed descriptions of options available to the checkout step.
For example, the git
step does not support:
- SHA-1 checkout
- Tag checkout
- Submodule checkout
- Sparse checkout
- Large file checkout (LFS)
- Reference repositories
- Branch merges
- Repository tagging
- Custom refspecs
- Timeout configuration
- Changelog calculation against a non-default reference
- Stale branch pruning
Example: Git step with defaults
Checkout from the git plugin source repository using https protocol, no credentials, and the master branch.
The Pipeline Syntax Snippet Generator generates this example:
git 'https://github.com/jenkinsci/git-plugin'
Example: Git step with https and a specific branch
Checkout from the Jenkins source repository using https protocol, no credentials, and a specific branch (stable-2.204).
Note that this must be a local branch name like ‘master’ or ‘develop’.
Branch names that are not supported by the git
step
- Remote branch names like ‘origin/master’ and ‘origin/develop’ are not supported as the branch argument
- SHA-1 hashes are not supported as the branch argument
- Tag names are not supported as the branch argument
Remote branch names, SHA-1 hashes, and tag names are supported by the general purpose checkout
step.
The Pipeline Syntax Snippet Generator generates this example:
git branch: 'stable-2.204', url: 'https://github.com/jenkinsci/jenkins.git'
Example: Git step with ssh and a private key credential
Checkout from the git client plugin source repository using ssh protocol, private key credentials, and the master branch.
The credential must be a private key credential if the remote git repository is accessed with the ssh protocol.
The credential must be a username / password credential if the remote git repository is accessed with http or https protocol.
The Pipeline Syntax Snippet Generator generates this example:
git credentialsId: 'my-private-key-credential-id', url: 'git@github.com:jenkinsci/git-client-plugin.git'
Example: Git step with https and changelog disabled
Checkout from the Jenkins source repository using https protocol, no credentials, the master branch, and changelog calculation disabled.
If changelog is false
, then the changelog will not be computed for this job.
If changelog is true
or is not set, then the changelog will be computed.
See the workflow scm step documentation for more changelog details.
The Pipeline Syntax Snippet Generator generates this example:
git changelog: false, url: 'https://github.com/jenkinsci/credentials-plugin.git'
Example: Git step with https protocol and polling disabled
Checkout from the Jenkins platform labeler repository using https protocol, no credentials, the master branch, and no polling for changes.
If poll is false
, then the remote repository will not be polled for changes.
If poll is true
or is not set, then the remote repository will be polled for changes.
See the workflow scm step documentation for more polling details.
The Pipeline Syntax Snippet Generator generates this example:
git poll: false, url: 'https://github.com/jenkinsci/platformlabeler-plugin.git'
Argument Descriptions
url
-
URL of the repository to be checked out in the workspace. Required parameter.
Repository URL’s should follow the git URL guidelines.
Git steps to access a secured repository should provide a Jenkins credential with thecredentialsId
argument rather than embedding credentials in the URL.
Credentials embedded in a repository URL may be visible in console logs or in other log files.Type:String
branch
(optional)-
Branch to be checked out in the workspace.
Default is ‘master
‘.Note that this must be a local branch name like ‘master’ or ‘develop’.
Remote branch names like ‘origin/master’ and ‘origin/develop’ are not supported as the branch argument.
Tag names are not supported as the branch argument.
SHA-1 hashes are not supported as the branch argument.
Remote branch names, tag names, and SHA-1 hashes are supported by the general purposecheckout
step.Type:String
changelog
(optional)-
Compute changelog for this job. Default is ‘
true
‘.If
changelog
is false, then the changelog will not be computed for this job.
Ifchangelog
is true or is not set, then the changelog will be computed.Type:boolean
credentialsId
(optional)-
Identifier of the credential used to access the remote git repository. Default is ‘<empty>’.
The credential must be a private key credential if the remote git repository is accessed with the ssh protocol.
The credential must be a username / password credential if the remote git repository is accessed with http or https protocol.Type:String
poll
(optional)-
Poll remote repository for changes. Default is ‘
true
‘.If
poll
is false, then the remote repository will not be polled for changes.
Ifpoll
is true or is not set, then the remote repository will be polled for changes.Type:boolean
googleStorageBucketLifecycle
: Google Storage Bucket LifecyclecredentialsId
-
Type:String
bucket
-
Type:String
ttl
-
Type:int
googleStorageBuildLogUpload
: Google Storage Build Log UploadcredentialsId
-
Type:String
bucket
-
Type:String
logName
-
Type:String
pathPrefix
(optional)-
Type:String
sharedPublicly
(optional)-
Type:boolean
showInline
(optional)-
Type:boolean
googleStorageDownload
: Google Storage DownloadcredentialsId
-
Type:String
bucketUri
-
This specifies the cloud object to download from Cloud Storage.
You can view these by visiting the «Cloud Storage» section of the Cloud Console for your project.
A single asterisk can be specified in the object path (not the bucket name), past the last «/». The asterisk behaves consistently with gsutil. For example,gs://my-bucket-name/pre/a_*.txt
would match the objects in cloud bucketmy-bucket-name
that are namedpre/a_2.txt
orpre/a_abc23-4.txt
, but notpre/a_2/log.txt
.Type:String
localDirectory
-
The local directory that will store the downloaded files. The path specified is considered relative to the build’s workspace. Example value:
- path/to/dir
Type:String
pathPrefix
(optional)-
The specified prefix will be stripped from all downloaded filenames. Filenames that do not start with this prefix will not be modified. If this prefix does not have a trailing slash, it will be added automatically.
Type:String
googleStorageUpload
: Google Storage Classic UploadcredentialsId
-
Type:String
bucket
-
Type:String
pattern
-
Type:String
pathPrefix
(optional)-
Type:String
sharedPublicly
(optional)-
Type:boolean
showInline
(optional)-
Type:boolean
input
: Wait for interactive input
This step pauses Pipeline execution and allows the user to interact and control the flow of the build.
Only a basic «proceed» or «abort» option is provided in the stage view.
You can optionally request information back, hence the name of the step.
The parameter entry screen can be accessed via a link at the bottom of the build console log or
via link in the sidebar for a build.
message
-
This parameter gives a prompt which will be shown to a human:
Ready to go? Proceed or Abort
If you click «Proceed» the build will proceed to the next step, if you click «Abort» the build will be aborted.
Type:String
id
(optional)-
Every
input
step has an unique ID. It is used in the generated URL to proceed or abort.A specific ID could be used, for example, to mechanically respond to the input from some external process/tool.
Type:String
ok
(optional)-
Type:String
parameters
(optional)-
Request that the submitter specify one or more parameter values when approving.
If just one parameter is listed, its value will become the value of theinput
step.
If multiple parameters are listed, the return value will be a map keyed by the parameter names.
If parameters are not requested, the step returns nothing if approved.On the parameter entry screen you are able to enter values for parameters that are defined in this field.
Array/List:
- Nested choice of objects
-
booleanParam
-
name
-
Type:String
defaultValue
(optional)-
Type:boolean
description
(optional)-
Type:String
choice
-
name
-
Type:String
description
(optional)-
Type:String
choices
(optional)-
- Nested choice of objects
- (not enumerable)
credentials
-
Defines a credentials parameter, which you can use during a build.
For security reasons, the credential is NOT directly exposed, the ID of the credential is exposed.
However, the selected credential is available through variable substitution in some other parts of the configuration.
The string value will be the ID of the credential. A supporting plugin can thus use the ID to retrieve
the selected credential and expose it to the build in an appropriate way.name
-
Type:String
defaultValue
-
The default credentials to use.
Type:String
credentialType
-
Type:String
required
-
When this option is selected, the credentials selection drop down will not provide the empty selection as one of
the options. This will not prevent a build without a value if there are no credentials available, for example
if the job does not have access to any credentials of the correct type or there is no default value and the
user starting the build either does not have any credentials of the correct type in their personal credentials
store or they do not have permissions on the job to use credentials from their personal store.Type:boolean
description
(optional)-
Type:String
file
-
name
-
Type:String
description
(optional)-
Type:String
$class: 'ListSubversionTagsParameterDefinition'
-
When used, this parameter will display a field at build-time so that the user
is able to select a Subversion tag from which to create the working copy for
this project.Once the two fields Name and Repository URL
are set, you must- ensure the job uses Subversion and
- set the Repository URL field of Subversion
by concatenating the two fields of this parameter.
For instance, if Name is set to
SVN_TAG
and
Repository URL is set tohttps://svn.jenkins-ci.org/tags
,
then Subversion‘s Repository URL must be set to
https://svn.jenkins-ci.org/tags/$SVN_TAG
.Notice that you can set the Repository URL field to a Subversion
repository root rather than just pointing to atags
dir (ie, you
can set it tohttps://svn.jenkins-ci.org
rather than
https://svn.jenkins-ci.org/tags
). In that case, if this repository
root contains thetrunk
,branches
andtags
folders, then the dropdown will allow the user to pick the trunk, or a
branch, or a tag.name
-
Type:String
tagsDir
-
Specify the Subversion repository URL which contains the tags to be listed
when triggering a new build.You can also specify the root of a Subversion repository: If this root contains
thetrunk
,branches
andtags
folders,
then the dropdown will displaytrunk
, all the branches and all the
tags. If the root does not contain these three folders, then all its subfolders
are listed in the dropdown.When you enter the URL, Jenkins automatically checks if it can connect to it.
If access requires authentication, you’ll be prompted for the necessary
credential. If you already have a working credential but would like to change
it for some other reasons, you can manage credentials and specify a different credential.Type:String
credentialsId
-
Type:String
tagsFilter
-
Specify a
regular expression which will be used to filter the tags which are actually
displayed when triggering a new build.Type:String
defaultValue
-
For features such as SVN polling a default value is required. If job will only
be started manually, this field is not necessary.Type:String
maxTags
-
The maximum number of tags to display in the dropdown. Any non-number value
will default to all.Type:String
reverseByDate
-
Check this option so that tags are sorted from the newest to the oldest.
If this option is checked, the Sort Z to A one won’t be taken into
account.Type:boolean
reverseByName
-
Check this option so that tags are displayed in reverse order (sorted Z to A).
Notice that if Sort newest first is checked, this option won’t be taken
into account.Type:boolean
description
(optional)-
Type:String
password
-
Pass a password to your build.
The password entered here is made available to the build in plain text as an environment variable like a string parameter would be.
The value will be stored encrypted on the Jenkins controller, similar to passwords in Jenkins configuration.name
-
Type:String
defaultValueAsSecret
-
org.kohsuke.stapler.NoStaplerConstructorException: There's no @DataBoundConstructor on any constructor of class hudson.util.Secret
description
(optional)-
Type:String
$class: 'PromotedBuildParameterDefinition'
-
name
-
Type:String
jobName
-
Type:String
process
-
Type:String
description
(optional)-
Type:String
run
-
name
-
Type:String
projectName
-
Type:String
filter
-
Values:
ALL
STABLE
SUCCESSFUL
COMPLETED
description
(optional)-
Type:String
string
-
name
-
Type:String
defaultValue
(optional)-
Type:String
description
(optional)-
Type:String
trim
(optional)-
Strip whitespace from the beginning and end of the string.
Type:boolean
text
-
name
-
Type:String
defaultValue
(optional)-
Type:String
description
(optional)-
Type:String
trim
(optional)-
Strip whitespace from the beginning and end of the string.
Type:boolean
submitter
(optional)-
User IDs and/or external group names of person or people permitted to respond to the input, separated by ‘,’.
Spaces will be trimmed. This means that «alice, bob, blah » is the same as «alice,bob,blah».
Note: Jenkins administrators are able to respond to the input regardless of the value of this parameter.Type:String
submitterParameter
(optional)-
If specified, this is the name of the return value that will contain the ID of the user that approves this
input.The return value will be handled in a fashion similar to the
parameters
value.Type:String
isUnix
: Checks if running on a Unix-like node
Returns true if enclosing node
is running on a Unix-like system (such as Linux or Mac OS X), false if Windows.
javadoc
: Publish JavadocjavadocDir
-
Type:String
keepAll
-
If you check this option, Jenkins will retain Javadoc for each successful build.
This allows you to browse Javadoc for older builds, at the expense of additional
disk space requirement.If you leave this option unchecked, Jenkins will only keep the latest Javadoc,
so older Javadoc will be overwritten as new builds succeed.Type:boolean
jobDsl
: Process Job DSLsadditionalClasspath
(optional)-
Newline separated list of additional classpath entries for the Job DSL scripts. All entries must be relative to the
workspace root, e.g. build/classes/main. Supports Ant-style patterns like lib/*.jar.Type:String
additionalParameters
(optional)-
java.lang.UnsupportedOperationException: do not know how to categorize attributes of type java.util.Map<java.lang.String, java.lang.Object>
failOnMissingPlugin
(optional)-
If checked, the build will be marked as failed if a plugin must be installed or updated to support all features used
in the DSL scripts. If not checked, the build will be marked as unstable instead.Type:boolean
failOnSeedCollision
(optional)-
Fail build if generated item(s) have the same name as existing items already managed by another seed job. By default, this plugin will always regenerate all jobs and views, thus updating previously generated jobs and views even if managed by another seed job. Check this box if you wish to fail the job if a generated item name collision is detected.
Type:boolean
ignoreExisting
(optional)-
Ignore previously generated jobs and views. By default, this plugin will always regenerate all jobs and views, thus updating previously generated jobs and views. Check this box if you wish to leave previous jobs and views as is.
Type:boolean
ignoreMissingFiles
(optional)-
Ignore missing DSL scripts. If not checked, the build step will fail if a configured script is missing or if
a wildcard does not match any files.Type:boolean
lookupStrategy
(optional)-
Determines how relative job names in DSL scripts are interpreted. You will only see a difference when
the seed job is located in a
folder.-
Jenkins Root
When this option is selected relative job names are always interpreted relative to the Jenkins root. -
Seed Job
If you choose this option relative job names in DSL scripts will be
interpreted relative to the folder in which the seed job is located. Suppose you have a seed job which is
located in a folder named seedJobFolder and a DSL script which creates a job named
subfolder2/job. The job that is created by the seed job will be at the location
/seedJobFolder/subfolder2/job.
Values:
JENKINS_ROOT
SEED_JOB
-
Jenkins Root
removedConfigFilesAction
(optional)-
Specifies what to do when previously generated config files are not referenced anymore.
Note: when using multiple Job DSL build steps in a single job, set this to «Delete» only for the last Job
DSL build step. Otherwise config files may be deleted and re-created. See
JENKINS-44142 for details. removedJobAction
(optional)-
Specifies what to do when a previously generated job is not referenced anymore.
Note: when using multiple Job DSL build steps in a single job, set this to «Delete» or «Disable» only for
the last Job DSL build step. Otherwise jobs will be deleted and re-created or disabled and re-enabled and you
may lose the job history of generated jobs. See
JENKINS-44142 for details.Values:
IGNORE
DISABLE
DELETE
removedViewAction
(optional)-
Specifies what to do when a previously generated view is not referenced anymore.
Note: when using multiple Job DSL build steps in a single job, set this to «Delete» only for the last Job
DSL build step. Otherwise views may be deleted and re-created. See
JENKINS-44142 for details. sandbox
(optional)-
If checked, runs the DSL scripts in a sandbox with limited abilities.
You will also need to configure this job to run with the identity of a particular user.
If unchecked, and you are not a Jenkins administrator,
you will need to wait for an administrator to approve the scripts.Type:boolean
scriptText
(optional)-
DSL Script, which is groovy code. Look at documentation for details on the syntax.
Type:String
targets
(optional)-
Newline separated list of DSL scripts, located in the Workspace.
Can use wildcards like ‘jobs/**/*.groovy’. See
the @includes of Ant fileset
for the exact format.Scripts are executed in the same order as specified. The execution order of expanded wildcards is unspecified.
Type:String
unstableOnDeprecation
(optional)-
If checked, marks the build as unstable when using deprecated features. If not checked, a warning will be
printed to the build log only.Type:boolean
useScriptText
(optional)-
Type:boolean
junit
: Archive JUnit-formatted test results
Jenkins understands the JUnit test report XML format (which is also used by TestNG).
When this option is configured, Jenkins can provide useful information about test results,
such as historical test result trends, a web UI for viewing test reports, tracking failures,
and so on.
To use this feature, first set up your build to run tests, then
specify the path to JUnit XML files in the
Ant glob syntax,
such as **/build/test-reports/*.xml. Be sure not to include any non-report
files into this pattern. You can specify multiple patterns of files separated by commas.
testResults
-
Type:String
allowEmptyResults
(optional)-
If checked, the default behavior of failing a build on missing test result files
or empty test results is changed to not affect the status of the build.
Please note that this setting make it harder to spot misconfigured jobs or
build failures where the test tool does not exit with an error code when
not producing test report files.Type:boolean
checksName
(optional)-
If provided, and publishing checks enabled, the plugin will use this name when publishing results to corresponding
SCM hosting platforms. If not, a default including the current stage / branch names will be used.Type:String
healthScaleFactor
(optional)-
The amplification factor to apply to test failures when computing the test result contribution to the build health
score.
The default factor is1.0
- A factor of
0.0
will disable the test result contribution to build health score. - A factor of
0.1
means that 10% of tests failing will score 99% health - A factor of
0.5
means that 10% of tests failing will score 95% health - A factor of
1.0
means that 10% of tests failing will score 90% health - A factor of
2.0
means that 10% of tests failing will score 80% health - A factor of
2.5
means that 10% of tests failing will score 75% health - A factor of
5.0
means that 10% of tests failing will score 50% health - A factor of
10.0
means that 10% of tests failing will score 0% health
The factor is persisted with the build results, so changes will only be reflected in new builds.
Type:double
- A factor of
keepLongStdio
(optional)-
If checked, any standard output or error from a test suite will be retained
in the test results after the build completes. (This refers only to additional
messages printed to console, not to a failure stack trace.) Such output is
always kept if the test failed, but by default lengthy output from passing
tests is truncated to save space. Check this option if you need to see every
log message from even passing tests, but beware that Jenkins’s memory consumption
can substantially increase as a result, even if you never look at the test results!Type:boolean
skipMarkingBuildUnstable
(optional)-
If this option is unchecked, then the plugin will mark the build as unstable when it finds at least 1 test failure.
If this option is checked, then the build will still be successful even if there are test failures reported.
In any case, the corresponding pipeline node (and stage) will be marked as unstable in case of test failure.Type:boolean
skipOldReports
(optional)-
Type:boolean
skipPublishingChecks
(optional)-
If this option is unchecked, then the plugin automatically publishes the test results to corresponding SCM hosting platforms.
For example, if you are using this feature for a GitHub organization project, the warnings will be published to
GitHub through the Checks API. If this operation slows down your build, or you don’t want to publish the warnings to
SCM platforms, you can use this option to deactivate this feature.Type:boolean
testDataPublishers
(optional)
kubeconfig
: Setup Kubernetes CLI (kubectl)Configure Kubernetes client (kubectl) so it can be used in the build to run Kubernetes commands
serverUrl
-
URL of the Kubernetes API endpoint. If not set the connection options will be autoconfigured from service account or kube config file.
Type:String
credentialsId
-
Type:String
caCertificate
-
The base64 encoded certificate of the certificate authority (CA). It is used to verify the server certificate.
Leaving this field empty will skip the certificate verification.
Type:String
library
: Load a library on the fly
Load a library dynamically rather than using @Library
syntax.
You may use global variables defined in the library thereafter:
library 'mylib@master'
usefulFunction()
You may also load classes defined in the library by selecting their fully-qualified names
like properties on the return value of this step, then call static methods
or call constructors as if they were a method named new
:
def utils = library('mylib').com.mycorp.jenkins.Utils.new(this)
utils.handyStuff()
identifier
-
A library name to load.
Should normally match that of a predefined library.
You can append a version after@
.
You may instead define a library inline here.Type:String
changelog
(optional)-
Whether to include any changes in the library
in the recent changes of jobs using the library.
Defaults to including the changes.Type:boolean
retriever
(optional)-
- Nested choice of objects
-
legacySCM
-
scm
-
- Nested choice of objects
-
$class: 'GitSCM'
-
The git plugin provides fundamental git operations for Jenkins projects.
It can poll, fetch, checkout, and merge contents of git repositories.The git plugin provides an SCM implementation to be used with the Pipeline SCM
checkout
step.
The Pipeline Syntax Snippet Generator guides the user to select git plugin checkout options and provides online help for each of the options.userRemoteConfigs
-
Specify the repository to track. This can be a URL or a local file path.
Note that for super-projects (repositories with submodules), only a local file
path or a complete URL is valid. The following are examples of valid git URLs.- ssh://git@github.com/github/git.git
- git@github.com:github/git.git (short notation for ssh protocol)
- ssh://user@other.host.com/~/repos/R.git (to access the repos/R.git
repository in the user’s home directory) - https://github.com/github/git.git
If the repository is a super-project, the
location from which to clone submodules is dependent on whether the repository
is bare or non-bare (i.e. has a working directory).- If the super-project is bare, the location of the submodules will be
taken from .gitmodules. - If the super-project is not bare, it is assumed that the
repository has each of its submodules cloned and checked out appropriately.
Thus, the submodules will be taken directly from a path like
${SUPER_PROJECT_URL}/${SUBMODULE}
, rather than relying on
information from .gitmodules.
For a local URL/path to a super-project,
git rev-parse —is-bare-repository
is used to detect whether the super-project is bare or not.
For a remote URL to a super-project, the ending of the URL determines whether
a bare or non-bare repository is assumed:- If the remote URL ends with /.git, a non-bare repository is
assumed. - If the remote URL does NOT end with /.git, a bare
repository is assumed.
Array/List:
- Nested object
-
url
-
Specify the URL or path of the git repository.
This uses the same syntax as yourgit clone
command.Type:String
name
-
ID of the repository, such as
origin
, to uniquely identify this repository among other remote repositories.
This is the same «name» that you use in yourgit remote
command. If left empty,
Jenkins will generate unique names for you.You normally want to specify this when you have multiple remote repositories.
Type:String
refspec
-
A refspec controls the remote refs to be retrieved and how they map to local refs. If left blank, it will default to
the normal behaviour ofgit fetch
, which retrieves all the branch heads asremotes/REPOSITORYNAME/BRANCHNAME
.
This default behaviour is OK for most cases.In other words, the default refspec is «+refs/heads/*:refs/remotes/REPOSITORYNAME/*» where
REPOSITORYNAME
is the value
you specify in the above «name of repository» textbox.When do you want to modify this value? A good example is when you want to just retrieve one branch. For example,
+refs/heads/master:refs/remotes/origin/master
would only retrieve the master branch and nothing else.The plugin uses a default refspec for its initial fetch, unless the «Advanced Clone Option» is set to honor refspec.
This keeps compatibility with previous behavior, and allows the job definition to decide if the refspec should be
honored on initial clone.Multiple refspecs can be entered by separating them with a space character.
+refs/heads/master:refs/remotes/origin/master +refs/heads/develop:refs/remotes/origin/develop
retrieves the master branch and the develop branch and nothing else.See the refspec definition in Git user manual for more details.
Type:String
credentialsId
-
Credential used to check out sources.
Type:String
branches
-
List of branches to build.
Jenkins jobs are most effective when each job builds only a single branch.
When a single job builds multiple branches, the changelog comparisons between branches often show no changes or incorrect changes.Array/List:
- Nested object
-
name
-
Specify the branches if you’d like to track a specific branch in a repository.
If left blank, all branches will be examined for changes and built.The safest way is to use the
refs/heads/<branchName>
syntax. This way the expected branch
is unambiguous.If your branch name has a
/
in it make sure to use the full reference above. When not presented
with a full path the plugin will only use the part of the string right of the last slash.
Meaningfoo/bar
will actually matchbar
.If you use a wildcard branch specifier, with a slash (e.g.
release/
),
you’ll need to specify the origin repository in the branch names to
make sure changes are picked up. So e.g.origin/release/
Possible options:
-
<branchName>
Tracks/checks out the specified branch. If ambiguous the first result is taken, which is not necessarily
the expected one. Better userefs/heads/<branchName>
.
E.g.master
,feature1
, … -
refs/heads/<branchName>
Tracks/checks out the specified branch.
E.g.refs/heads/master
,refs/heads/feature1/master
, … -
<remoteRepoName>/<branchName>
Tracks/checks out the specified branch. If ambiguous the first result is taken, which is not necessarily
the expected one.
Better userefs/heads/<branchName>
.
E.g.origin/master
-
remotes/<remoteRepoName>/<branchName>
Tracks/checks out the specified branch.
E.g.remotes/origin/master
-
refs/remotes/<remoteRepoName>/<branchName>
Tracks/checks out the specified branch.
E.g.refs/remotes/origin/master
-
<tagName>
This does not work since the tag will not be recognized as tag.
Userefs/tags/<tagName>
instead.
E.g.git-2.3.0
-
refs/tags/<tagName>
Tracks/checks out the specified tag.
E.g.refs/tags/git-2.3.0
-
<commitId>
Checks out the specified commit.
E.g.5062ac843f2b947733e6a3b105977056821bd352
,5062ac84
, … -
${ENV_VARIABLE}
It is also possible to use environment variables. In this case the variables are evaluated and the
result is used as described above.
E.g.${TREEISH}
,refs/tags/${TAGNAME}
, … -
<Wildcards>
The syntax is of the form:REPOSITORYNAME/BRANCH
.
In addition,BRANCH
is recognized as a shorthand of*/BRANCH
, ‘*’ is recognized as a wildcard,
and ‘**’ is recognized as wildcard that includes the separator ‘/’. Therefore,origin/branches*
would
matchorigin/branches-foo
but notorigin/branches/foo
, whileorigin/branches**
would
match bothorigin/branches-foo
andorigin/branches/foo
. -
:<regular expression>
The syntax is of the form::regexp
.
Regular expression syntax in branches to build will only
build those branches whose names match the regular
expression.
Examples::^(?!(origin/prefix)).*
- matches:
origin
ororigin/master
ororigin/feature
- does not match:
origin/prefix
ororigin/prefix_123
ororigin/prefix-abc
- matches:
:origin/release-d{8}
- matches:
origin/release-20150101
- does not match:
origin/release-2015010
ororigin/release-201501011
ororigin/release-20150101-something
- matches:
:^(?!origin/master$|origin/develop$).*
- matches:
origin/branch1
ororigin/branch-2
ororigin/master123
ororigin/develop-123
- does not match:
origin/master
ororigin/develop
- matches:
Type:String
-
browser
-
Defines the repository browser that displays changes detected by the git plugin.
- Nested choice of objects
-
$class: 'AssemblaWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://www.assembla.com/code/PROJECT/git/).
Type:String
bitbucketServer
-
repoUrl
-
Specify the Bitbucket Server root URL for this repository (such as https://bitbucket:7990/OWNER/REPO/).
Type:String
$class: 'BitbucketWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://bitbucket.org/OWNER/REPO/).
Type:String
$class: 'CGit'
-
repoUrl
-
Specify the root URL serving this repository (such as http://cgit.example.com:port/group/REPO/).
Type:String
$class: 'FisheyeGitRepositoryBrowser'
-
repoUrl
-
Specify the URL of this repository in FishEye (such as http://fisheye6.cenqua.com/browse/ant/).
Type:String
$class: 'GitBlitRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository.
Type:String
projectName
-
Specify the name of the project in GitBlit.
Type:String
$class: 'GitLab'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gitlabserver:port/group/REPO/).
Type:String
version
(optional)-
Specify the major and minor version of GitLab you use (such as 9.1). If you
don’t specify a version, a modern version of GitLab (>= 8.0) is assumed.Type:String
$class: 'GitList'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gitlistserver:port/REPO/).
Type:String
$class: 'GitWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://github.com/jenkinsci/jenkins.git).
Type:String
$class: 'GithubWeb'
-
repoUrl
-
Specify the HTTP URL for this repository’s GitHub page (such as https://github.com/jquery/jquery).
Type:String
$class: 'Gitiles'
-
repoUrl
-
Specify the root URL serving this repository (such as https://gwt.googlesource.com/gwt/).
Type:String
$class: 'GitoriousWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://gitorious.org/gitorious/mainline).
Type:String
$class: 'GogsGit'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gogs.example.com:port/username/some-repo-url.git).
Type:String
$class: 'KilnGit'
-
repoUrl
-
Specify the root URL serving this repository (such as https://khanacademy.kilnhg.com/Code/Website/Group/webapp).
Type:String
$class: 'Phabricator'
-
repoUrl
-
Specify the phabricator instance root URL (such as http://phabricator.example.com).
Type:String
repo
-
Specify the repository name in phabricator (such as the foo part of phabricator.example.com/diffusion/foo/browse).
Type:String
$class: 'RedmineWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as http://SERVER/PATH/projects/PROJECT/repository).
Type:String
$class: 'RhodeCode'
-
repoUrl
-
Specify the HTTP URL for this repository’s RhodeCode page (such as http://rhodecode.mydomain.com:5000/projects/PROJECT/repos/REPO/).
Type:String
$class: 'ScmManagerGitRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository (such as https://scm-manager.org/scm/repo/namespace/name).
Type:String
$class: 'Stash'
-
repoUrl
-
Specify the HTTP URL for this repository’s Stash page (such as http://stash.mydomain.com:7990/projects/PROJECT/repos/REPO/).
Type:String
$class: 'TFS2013GitRepositoryBrowser'
-
repoUrl
-
Either the name of the remote whose URL should be used, or the URL of this
module in TFS (such as http://fisheye6.cenqua.com/tfs/PROJECT/_git/REPO/).
If empty (default), the URL of the «origin» repository is used.If TFS is also used as the repository server, this can usually be left blank.
Type:String
$class: 'ViewGitWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as http://code.fealdia.org/viewgit/).
Type:String
projectName
-
Specify the name of the project in ViewGit (e.g. scripts, scuttle etc. from http://code.fealdia.org/viewgit/).
Type:String
gitTool
-
Absolute path to the git executable.
This is different from other Jenkins tool definitions.
Rather than providing the directory that contains the executable, you must provide the complete path to the executable.
Setting ‘/usr/bin/git
‘ would be correct, while setting ‘/usr/bin/
‘ is not correct.Type:String
extensions
-
Extensions add new behavior or modify existing plugin behavior for different uses.
Extensions help users more precisely tune plugin behavior to meet their needs.Extensions include:
-
Clone extensions modify the git operations that retrieve remote changes into the agent workspace.
The extensions can adjust the amount of history retrieved, how long the retrieval is allowed to run, and other retrieval details. -
Checkout extensions modify the git operations that place files in the workspace from the git repository on the agent.
The extensions can adjust the maximum duration of the checkout operation, the use and behavior of git submodules, the location of the workspace on the disc, and more. - Changelog extensions adapt the source code difference calculations for different cases.
- Tagging extensions allow the plugin to apply tags in the current workspace.
-
Build initiation extensions control the conditions that start a build.
They can ignore notifications of a change or force a deeper evaluation of the commits when polling. -
Merge extensions can optionally merge changes from other branches into the current branch of the agent workspace.
They control the source branch for the merge and the options applied to the merge.
Array/List:
- Nested choice of objects
-
$class: 'AuthorInChangelog'
-
The default behavior is to use the Git commit’s «Committer» value in Jenkins’ build changesets.
If this option is selected, the Git commit’s «Author» value would be used instead. $class: 'BuildChooserSetting'
-
When you are interested in using a job to build multiple heads (most typically multiple branches),
you can choose how Jenkins choose what branches to build in what order.This extension point in Jenkins is used by many other plugins to control the job to build
specific commits. When you activate those plugins, you may see them installing a custom strategy
here.buildChooser
-
- Nested choice of objects
-
$class: 'AncestryBuildChooser'
-
maximumAgeInDays
-
Type:int
ancestorCommitSha1
-
Type:String
$class: 'DefaultBuildChooser'
-
$class: 'InverseBuildChooser'
-
$class: 'BuildSingleRevisionOnly'
-
Disable scheduling for multiple candidate revisions.
If we have 3 branches:
—-A—.—.— B
——C
jenkins would try to build (B) and (C).
This behaviour disables this and only builds one of them.
It is helpful to reduce the load of the Jenkins infrastructure when the
SCM system like Bitbucket or GitHub should decide what commits to build. $class: 'ChangelogToBranch'
-
This method calculates the changelog against the specified branch.
options
-
- Nested object
-
compareRemote
-
Name of the repository, such as
origin
, that contains the branch you specify below.Type:String
compareTarget
-
The name of the branch within the named repository to compare against.
Type:String
$class: 'CheckoutOption'
-
timeout
-
Specify a timeout (in minutes) for checkout.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
$class: 'CleanBeforeCheckout'
-
Clean up the workspace before every checkout by deleting all untracked files and directories,
including those which are specified in.gitignore
.
It also resets all tracked files to their versioned state.
This ensures that the workspace is
in the same state as if you cloned and checked out in a brand-new empty directory, and ensures
that your build is not affected by the files generated by the previous build.deleteUntrackedNestedRepositories
(optional)-
Deletes untracked submodules and any other subdirectories which contain
.git
directories.Type:boolean
$class: 'CleanCheckout'
-
Clean up the workspace after every checkout by deleting all untracked files and directories,
including those which are specified in.gitignore
.
It also resets all tracked files to their versioned state.
This ensures that the workspace is
in the same state as if you cloned and checked out in a brand-new empty directory, and ensures
that your build is not affected by the files generated by the previous build.deleteUntrackedNestedRepositories
(optional)-
Deletes untracked submodules and any other subdirectories which contain
.git
directories.Type:boolean
$class: 'CloneOption'
-
shallow
-
Perform shallow clone, so that git will not download the history of the project,
saving time and disk space when you just want to access the latest version of a repository.Type:boolean
noTags
-
Deselect this to perform a clone without tags, saving time and disk space when you just want to access
what is specified by the refspec.Type:boolean
reference
-
Specify a folder containing a repository that will be used by Git as a reference during clone operations.
This option will be ignored if the folder is not available on the controller or agent where the clone is being executed.Type:String
timeout
-
Specify a timeout (in minutes) for clone and fetch operations.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
depth
(optional)-
Set shallow clone depth, so that git will only download recent history of the project,
saving time and disk space when you just want to access the latest commits of a repository.Type:int
honorRefspec
(optional)-
Perform initial clone using the refspec defined for the repository.
This can save time, data transfer and disk space when you only need
to access the references specified by the refspec.Type:boolean
$class: 'DisableRemotePoll'
-
Git plugin uses git ls-remote polling mechanism by default when configured with a single branch (no wildcards!).
This compare the latest built commit SHA with the remote branch without cloning a local copy of the repo.If you don’t want to / can’t use this.
If this option is selected, polling will require a workspace and might trigger unwanted builds (see JENKINS-10131).
$class: 'GitLFSPull'
-
Enable git large file support for the workspace by pulling large files after the checkout completes.
Requires that the controller and each agent performing an LFS checkout have installed `git lfs`. $class: 'IgnoreNotifyCommit'
-
If checked, this repository will be ignored when the notifyCommit-URL is accessed regardless of if the repository
matches or not. $class: 'LocalBranch'
-
If given, checkout the revision to build as HEAD on this branch.
If selected, and its value is an empty string or «**», then the branch
name is computed from the remote branch without the origin. In that
case, a remote branch origin/master will be checked out to a local
branch named master, and a remote branch origin/develop/new-feature
will be checked out to a local branch named develop/newfeature.Please note that this has not been tested with submodules.
localBranch
-
Type:String
$class: 'MessageExclusion'
-
excludedMessage
-
If set, and Jenkins is set to poll for changes, Jenkins will ignore any revisions committed with message matched to
Pattern when determining
if a build needs to be triggered. This can be used to exclude commits done by the build itself from triggering another build,
assuming the build server commits the change with a distinct message.Exclusion uses Pattern
matching.*[maven-release-plugin].*
The example above illustrates that if only revisions with «[maven-release-plugin]» message in first comment line
have been committed to the SCM a build will not occur.You can create more complex patterns using embedded flag expressions.
(?s).*FOO.*
This example will search FOO message in all comment lines.
Type:String
$class: 'PathRestriction'
-
If set, and Jenkins is set to poll for changes, Jenkins will pay attention to included and/or excluded files and/or
folders when determining if a build needs to be triggered.Using this behaviour will preclude the faster git ls-remote polling mechanism, forcing polling to require a workspace thus sometimes triggering unwanted builds, as if you had selected the Force polling using workspace extension as well.
includedRegions
-
Each inclusion uses java regular expression pattern matching,
and must be separated by a new line.
An empty list implies that everything is included.myapp/src/main/web/.*.html myapp/src/main/web/.*.jpeg myapp/src/main/web/.*.gif
The example above illustrates that a build will only occur, if html/jpeg/gif files
have been committed to the SCM. Exclusions take precedence over inclusions, if there is
an overlap between included and excluded regions.Type:String
excludedRegions
-
Each exclusion uses java regular expression pattern matching,
and must be separated by a new line.myapp/src/main/web/.*.html myapp/src/main/web/.*.jpeg myapp/src/main/web/.*.gif
The example above illustrates that if only html/jpeg/gif files have been committed to
the SCM a build will not occur.Type:String
$class: 'PerBuildTag'
-
Create a tag in the workspace for every build to unambiguously mark the commit that was built.
You can combine this with Git publisher to push the tags to the remote repository. $class: 'PreBuildMerge'
-
These options allow you to perform a merge to a particular branch before building.
For example, you could specify an integration branch to be built, and to merge to master.
In this scenario, on every change of integration, Jenkins will perform a merge with the master branch,
and try to perform a build if the merge is successful.
It then may push the merge back to the remote repository if the Git Push post-build action is selected.options
-
- Nested object
-
mergeTarget
-
The name of the branch within the named repository to merge to, such as
master
.Type:String
fastForwardMode
(optional)-
Merge fast-forward mode selection.
The default, —ff, gracefully falls back to a merge commit when required.
For more information, see the Git Merge Documentation mergeRemote
(optional)-
Name of the repository, such as
origin
, that contains the branch you specify below. If left blank,
it’ll default to the name of the first repository configured above.Type:String
mergeStrategy
(optional)-
Merge strategy selection.
This feature is not fully implemented in JGIT.Values:
DEFAULT
RESOLVE
RECURSIVE
OCTOPUS
OURS
SUBTREE
RECURSIVE_THEIRS
$class: 'PruneStaleBranch'
-
Run «git remote prune» for each remote, to prune obsolete local branches.
pruneTags
-
pruneTags
-
Type:boolean
$class: 'RelativeTargetDirectory'
-
relativeTargetDir
-
Specify a local directory (relative to the workspace root)
where the Git repository will be checked out. If left empty, the workspace root itself
will be used.This extension should not be used in Jenkins Pipeline (either declarative or scripted).
Jenkins Pipeline already provides standard techniques for checkout to a subdirectory.
Use ws and
dir
in Jenkins Pipeline rather than this extension.Type:String
$class: 'ScmName'
-
Unique name for this SCM. Needed when using Git within the Multi SCM plugin.
name
-
Type:String
$class: 'SparseCheckoutPaths'
-
Specify the paths that you’d like to sparse checkout. This may be used for saving space (Think about a reference repository).
Be sure to use a recent version of Git, at least above 1.7.10sparseCheckoutPaths
-
Array/List:
- Nested object
-
path
-
Type:String
$class: 'SubmoduleOption'
-
disableSubmodules
-
By disabling support for submodules you can still keep using basic
git plugin functionality and just have Jenkins to ignore submodules
completely as if they didn’t exist.Type:boolean
recursiveSubmodules
-
Retrieve all submodules recursively
(uses ‘—recursive’ option which requires git>=1.6.5)
Type:boolean
trackingSubmodules
-
Retrieve the tip of the configured branch in .gitmodules
(Uses ‘—remote’ option which requires git>=1.8.2)
Type:boolean
reference
-
Specify a folder containing a repository that will be used by Git as a reference during clone operations.
This option will be ignored if the folder is not available on the controller or agent where the clone is being executed.
To prepare a reference folder with multiple subprojects, create a bare git repository and add all the remote urls then perform a fetch:git init --bare git remote add SubProject1 https://gitrepo.com/subproject1 git remote add SubProject2 https://gitrepo.com/subproject2 git fetch --all
Type:String
timeout
-
Specify a timeout (in minutes) for submodules operations.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
parentCredentials
-
Use credentials from the default remote of the parent project.
Type:boolean
depth
(optional)-
Set shallow clone depth, so that git will only download recent history of the project,
saving time and disk space when you just want to access the latest commits of a repository.Type:int
shallow
(optional)-
Perform shallow clone, so that git will not download the history of the project,
saving time and disk space when you just want to access the latest version of a repository.Type:boolean
threads
(optional)-
Specify the number of threads that will be used to update submodules.
If unspecified, the command line git default thread count is used.Type:int
$class: 'UserExclusion'
-
excludedUsers
-
If set, and Jenkins is set to poll for changes, Jenkins will ignore any revisions committed by users in this list when determining if a build needs to be triggered. This can be used to exclude commits done by the build itself from triggering another build, assuming the build server commits the change with a distinct SCM user.
Using this behaviour will preclude the faster git ls-remote polling mechanism, forcing polling to require a workspace thus sometimes triggering unwanted builds, as if you had selected the Force polling using workspace extension as well.
Each exclusion uses exact string comparison and must be separated by a new line.
User names are only excluded if they exactly match one of the names in this list.auto_build_user
The example above illustrates that if only revisions by «auto_build_user» have been committed to the SCM a build will not occur.
Type:String
$class: 'UserIdentity'
-
name
-
If given, «GIT_COMMITTER_NAME=[this]» and «GIT_AUTHOR_NAME=[this]» are set for builds. This overrides whatever is in the global settings.
Type:String
email
-
If given, «GIT_COMMITTER_EMAIL=[this]» and «GIT_AUTHOR_EMAIL=[this]» are set for builds. This overrides whatever is in the global settings.
Type:String
$class: 'WipeWorkspace'
-
Delete the contents of the workspace before building, ensuring a fully fresh workspace.
-
Clone extensions modify the git operations that retrieve remote changes into the agent workspace.
doGenerateSubmoduleConfigurations
(optional)-
Removed facility that was intended to test combinations of git submodule versions.
Removed in git plugin 4.6.0.
Ignores the user provided value and always usesfalse
as its value.Type:boolean
submoduleCfg
(optional)-
Removed facility that was intended to test combinations of git submodule versions.
Removed in git plugin 4.6.0.
Ignores the user provided value(s) and always uses empty values.Array/List:
- Nested object
-
submoduleName
-
Removed in git plugin 4.6.0.
Type:String
branches
-
Removed in git plugin 4.6.0.
$class: 'MercurialSCM'
-
source
-
Specify the repository to track. This can be URL or a local file path.
If you are specifying HTTP credentials, do not include a username in the URL.Type:String
browser
(optional)-
- Nested choice of objects
-
$class: 'FishEye'
-
url
-
Specify the root URL serving this repository, such as: http://www.example.org/browse/hg/
Type:String
$class: 'GoogleCode'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'HgWeb'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'Kallithea'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'KilnHG'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'RhodeCode'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'RhodeCodeLegacy'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'ScmManager'
-
url
-
Specify the root URL serving this repository (such as
http://YOURSCMMANAGER/scm/repo/NAMESPACE/NAME/
).Type:String
clean
(optional)-
When this option is checked, each build will wipe any local modifications
or untracked files in the repository checkout.
This is often a convenient way to ensure that a build is not
using any artifacts from earlier builds.Type:boolean
credentialsId
(optional)-
Optional credentials to use when cloning or pulling from the remote repository.
Supports username/password with HTTP(S) URLs, and SSH private key with SSH URLs.Type:String
disableChangeLog
(optional)-
When checked, Hudson will not calculate the Mercurial changelog for each build.
Disabling the changelog can decrease the amount of time needed to update a
very large repository.Type:boolean
installation
(optional)-
Type:String
modules
(optional)-
Reduce unnecessary builds by specifying a comma or space delimited list of «modules» within the repository.
A module is a directory name within the repository that this project lives in. If this field is set,
changes outside the specified modules will not trigger a build (even though the whole repository is checked
out anyway due to the Mercurial limitation.)Type:String
revision
(optional)-
Specify the branch or tag name you would like to track.
(If you do not type anything, the default value is thedefault
branch.)Type:String
revisionType
(optional)-
Specify the kind of revision you expect Jenkins to update your working copy to.
Values:
BRANCH
TAG
CHANGESET
REVSET
subdir
(optional)-
If not empty, check out the Mercurial repository into this subdirectory of the
job’s workspace. For example:my/sources
(use forward slashes).
If changing this entry, you probably want to clean the workspace first.Type:String
none
-
$class: 'SubversionSCM'
-
Checks out the source code from Subversion repositories. See
post-commit hook set up for improved turn-around time and
performance in polling.locations
-
Array/List:
- Nested object
-
remote
-
Type:String
credentialsId
-
Type:String
local
-
Specify a local directory (relative to the workspace root)
where this module is checked out. If left empty, the last path component of the URL
is used as the default, just like thesvn
CLI.
A single period (.
) may be used to check out the project directly
into the workspace rather than into a subdirectory.Type:String
depthOption
-
—depth
option for checkout and update commands. Default value is
infinity
.
- empty includes only the immediate target of the operation, not any of its file or directory children.
- files includes the immediate target of the operation and any of its immediate file children.
- immediates includes the immediate target of the operation and any of its immediate file or directory children. The directory children will themselves be empty.
- infinity includes the immediate target, its file and directory children, its children’s children, and so on to full recursion.
- as-it-is takes the working depth from the current working copy, allows for setting update depth manually using —set-depth option.
More information can be found
here.Type:String
ignoreExternalsOption
-
«—ignore-externals» option will be used with svn checkout, svn update commands to disable externals definition processing.
More information can be found
here.
Note: there is the potential to leveragesvn:externals
to gain read access to the entire
Subversion repository. This can happen if you follow the normal practice of giving Jenkins
credentials with read access to the entire Subversion repository. You will also need to provide the credentials
to use when checking/polling out the svn:externals using the Additional Credentials option.Type:boolean
cancelProcessOnExternalsFail
-
Determines if the process should be cancelled when checkout/update svn:externals failed. Will work when «Ignore externals» box is not checked.
Default choice is to cancelled the process when checkout/update svn:externals failed.Type:boolean
workspaceUpdater
-
- Nested choice of objects
-
$class: 'CheckoutUpdater'
-
$class: 'NoopUpdater'
-
$class: 'UpdateUpdater'
-
$class: 'UpdateWithCleanUpdater'
-
$class: 'UpdateWithRevertUpdater'
-
browser
-
- Nested choice of objects
-
$class: 'Assembla'
-
spaceName
-
Type:String
$class: 'CollabNetSVN'
-
url
-
The repository browser URL for the root of the project.
For example, a Java.net project calledmyproject
would use
https://myproject.dev.java.net/source/browse/myproject
.
Type:String
$class: 'FishEyeSVN'
-
url
-
Specify the URL of this module in FishEye.
(such ashttp://fisheye6.cenqua.com/browse/ant/
)
Type:String
rootModule
-
Specify the root Subversion module that this FishEye monitors.
For example, forhttp://fisheye6.cenqua.com/browse/ant/
,
this field would beant
because it displays the directory «/ant»
of the ASF repo. If FishEye is configured to display the whole SVN repository,
leave this field empty.Type:String
svnPhabricator
-
url
-
Type:String
repo
-
Type:String
$class: 'SVNWeb'
-
url
-
Type:String
$class: 'ScmManagerSvnRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository (such as https://scm-manager.org/scm/repo/namespace/name).
Type:String
$class: 'Sventon'
-
url
-
Specify the URL of the Sventon repository browser.
For example, if you normally browse fromhttp://somehost.com/svn/repobrowser.svn?name=local
,
this field would behttp://somehost.com/svn/
Type:String
repositoryInstance
-
Specify the Sventon repository instance name that references this subversion repository.
For example, if you normally browse fromhttp://somehost.com/svn/repobrowser.svn?name=local
,
this field would belocal
Type:String
$class: 'Sventon2'
-
url
-
Specify the URL of the Sventon repository browser.
For example, if you normally browse fromhttp://somehost.com/svn/repobrowser.svn?name=local
,
this field would behttp://somehost.com/svn/
Type:String
repositoryInstance
-
Specify the Sventon repository instance name that references this subversion repository.
For example, if you normally browse fromhttp://somehost.com/svn/repobrowser.svn?name=local
,
this field would belocal
Type:String
$class: 'ViewSVN'
-
url
-
Specify the root URL of ViewSVN for this repository
(such as this).Type:String
$class: 'VisualSVN'
-
url
-
Type:String
$class: 'WebSVN'
-
url
-
Type:String
excludedRegions
-
If set, and Jenkins is set to poll for changes, Jenkins will ignore any files and/or
folders in this list when determining if a build needs to be triggered.Each exclusion uses regular expression pattern matching, and must be separated by a new line.
/trunk/myapp/src/main/web/.*.html /trunk/myapp/src/main/web/.*.jpeg /trunk/myapp/src/main/web/.*.gif
The example above illustrates that if only html/jpeg/gif files have been committed to
the SCM a build will not occur.More information on regular expressions can be found
here.Type:String
excludedUsers
-
If set, and Jenkins is set to poll for changes, Jenkins will ignore any revisions committed by users in this list when determining if a build needs to be triggered. This can be used to exclude commits done by the build itself from triggering another build, assuming the build server commits the change with a distinct SCM user.
Each exclusion uses literal pattern matching, and must be separated by a new line.
auto_build_user
The example above illustrates that if only revisions by «auto_build_user» have been committed to the SCM a build will not occur.
Type:String
excludedRevprop
-
If set, and Jenkins is set to poll for changes, Jenkins will ignore any revisions
that are marked with the given revision property (revprop) when determining if
a build needs to be triggered. This can be used to exclude commits done by the
build itself from triggering another build, assuming the build server commits
the change with the correct revprop.This type of exclusion only works with Subversion 1.5 servers and newer.
More information on revision properties can be found
here.Type:String
excludedCommitMessages
-
If set, and Jenkins is set to poll for changes, Jenkins will ignore any revisions
with commit messages containing any of the given regular expressions when
determining if a build needs to be triggered.Type:String
includedRegions
-
If set, and Jenkins is set to poll for changes, Jenkins will ignore any files and/or
folders that are not in this list when determining if a build needs to be triggered.Each inclusion uses regular expression pattern matching, and must be separated by a new line.
This is useful when you need to check out an entire resource for building, but only want to do
the build when a subset has changed./trunk/myapp/c/library1/.* /trunk/myapp/c/library2/.*
If /trunk/myapp is checked out, the build will only occur when there are changes to
either the c/library1 and c/library2 subtrees.If there are also excluded regions specified, then a file is not ignored when it is in
the included list and not in the excluded list.More information on regular expressions can be found
here.Type:String
ignoreDirPropChanges
-
If set, Jenkins ignores svn-property only changes of directories.
These changes are ignored when determining whether a build should be triggered and are removed from a
build’s changeset.
Main usage of this property is to ignore svn:mergeinfo changes (which would otherwise e.g. lead to a complete rebuild
of a maven project, in spite of incremental build option).Type:boolean
filterChangelog
-
If set Jenkins will apply the same inclusion and exclusion patterns for displaying changelog entries as it does for polling for changes.
If this is disabled, changes which are excluded for polling are still displayed in the changelog.Type:boolean
additionalCredentials
-
If there are additional credentials required in order to obtain a complete checkout of the source, they can be
provided here.The realm is how the repository self-identifies to a client. It usually has the following format:
<proto://host:port> Realm Name
proto
is the protocol, e.g.http
orsvn
.host
is the host how it’s accessed by Jenkins, e.g. as IP address192.168.1.100
, host namesvnserver
, or host name and domainsvn.example.org
.port
is the port, even if not explicitly specified. By default, this is80
for HTTP,443
for HTTPS, 3690 for thesvn
protocol.Realm Name
is how the repository self-identifies. Common options includeVisualSVN Server
,Subversion Authentication
or the UUID of the repository.
To find out the realm, you could do any of the following:
- If you access the repository via HTTP or HTTPS: Open the repo in a web browser without saved credentials. It will use the
Realm Name
(see above) in the authentication dialog. - Use the command line
svn
program.- If you don’t have stored the credentials, run e.g.
svn info https://svnserver/repo
and it will tell you the realm when asking you to enter a password, e.g.: Authentication realm: <svn://svnserver:3690> VisualSVN Server. - If you have already stored the credentials to access the repository, look for the realm name in one of the files in
~/.subversion/auth/svn/simple
; it will be two lines below the linesvn:realmstring
.
- If you don’t have stored the credentials, run e.g.
- When accessing a repository via the
svn+ssh
protocol, the realm has the formatusername@svn+ssh://host:port
– note that the username is before thesvn+ssh://
(unlike the URL used for normal SVN operations), and that there are no angle brackets and no realm name. For this protocol the default port is 22.
Make sure to enter the realm exactly as shown, starting with a
<
(except for repositories accessed viasvn+ssh
– see above).Array/List:
- Nested object
-
realm
-
This is the realm that the SvnKit library associates with a specific checkout. For most Subversion servers this
will typically be of the format<scheme://hostname(:port)> name
,
while for servers accessed viasvn+ssh
it is of the format(username@)svn+ssh://hostname(:port)
.Type:String
credentialsId
-
Select the credential from the list of relevant credentials in order to use that credential for checking out
the source code.Type:String
quietOperation
-
Mimics subversion command line
--quiet
parameter for check out / update operations to help keep the output shorter. Prints nothing, or only summary information.Type:boolean
libraryPath
(optional)-
A relative path from the root of the SCM to the root of the library.
Leave this field blank if the root of the library is the root of the SCM.
Note that «..» is not permitted as a path component to avoid security issues.Type:String
modernSCM
-
scm
-
- Nested choice of objects
-
bitbucket
-
Discovers branches and/or pull requests from a specific repository in either Bitbucket Cloud or a Bitbucket Server
instance.repoOwner
-
Specify the name of the Bitbucket Team or Bitbucket User Account.
It could be a Bitbucket Project also, if using Bitbucket Server.
In this case (Bitbucket Server):- Use the project key, not the project name.
- If using a user account instead of a project, add a «~» character before the username, i.e. «~joe».
Type:String
repository
-
Type:String
autoRegisterHook
(optional)-
Type:boolean
bitbucketServerUrl
(optional)-
Type:String
checkoutCredentialsId
(optional)-
Type:String
credentialsId
(optional)-
Credentials used to scan branches (also the default credentials to use when checking out sources).
For security reasons most credentials are only available when HTTPS is used.
Type:String
excludes
(optional)-
Type:String
id
(optional)-
Type:String
includes
(optional)-
Type:String
serverUrl
(optional)-
The server to connect to.
The list of servers is configured in the Manage Jenkins » Configure Jenkins › Bitbucket Endpoints screen.
The list of servers can include both Bitbucket Cloud and Bitbucket Server instances.Type:String
traits
(optional)-
The behaviours control what is discovered from the Bitbucket repository. The behaviours are grouped into a number
of categories:- Within repository
- These behaviours determine what gets discovered. If you do not configure at least one discovery
behaviour then nothing will be found! - General
- These behaviours affect the configuration of each discovered branch / pull request.
- Git
- These behaviours affect the configuration of each discovered branch / pull request
and are specific to Git semantics.
Array/List:
- Nested choice of objects
-
$class: 'AuthorInChangelogTrait'
-
bitbucketBuildStatusNotifications
-
Configure the Bitbucket notifications.
disableNotificationForNotBuildJobs
(optional)-
Type:boolean
sendSuccessNotificationForUnstableBuild
(optional)-
Type:boolean
$class: 'CheckoutOptionTrait'
-
extension
-
- Nested object
-
timeout
-
Specify a timeout (in minutes) for checkout.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
$class: 'CleanAfterCheckoutTrait'
-
extension
-
- Nested object
-
Clean up the workspace after every checkout by deleting all untracked files and directories,
including those which are specified in.gitignore
.
It also resets all tracked files to their versioned state.
This ensures that the workspace is
in the same state as if you cloned and checked out in a brand-new empty directory, and ensures
that your build is not affected by the files generated by the previous build.deleteUntrackedNestedRepositories
(optional)-
Deletes untracked submodules and any other subdirectories which contain
.git
directories.Type:boolean
$class: 'CleanBeforeCheckoutTrait'
-
extension
-
- Nested object
-
Clean up the workspace before every checkout by deleting all untracked files and directories,
including those which are specified in.gitignore
.
It also resets all tracked files to their versioned state.
This ensures that the workspace is
in the same state as if you cloned and checked out in a brand-new empty directory, and ensures
that your build is not affected by the files generated by the previous build.deleteUntrackedNestedRepositories
(optional)-
Deletes untracked submodules and any other subdirectories which contain
.git
directories.Type:boolean
$class: 'CleanMercurialSCMSourceTrait'
-
When this behaviour is present, each build will wipe any local modifications
or untracked files in the repository checkout.
This is often a convenient way to ensure that a build is not
using any artifacts from earlier builds. $class: 'CloneOptionTrait'
-
extension
-
- Nested object
-
shallow
-
Perform shallow clone, so that git will not download the history of the project,
saving time and disk space when you just want to access the latest version of a repository.Type:boolean
noTags
-
Deselect this to perform a clone without tags, saving time and disk space when you just want to access
what is specified by the refspec.Type:boolean
reference
-
Specify a folder containing a repository that will be used by Git as a reference during clone operations.
This option will be ignored if the folder is not available on the controller or agent where the clone is being executed.Type:String
timeout
-
Specify a timeout (in minutes) for clone and fetch operations.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
depth
(optional)-
Set shallow clone depth, so that git will only download recent history of the project,
saving time and disk space when you just want to access the latest commits of a repository.Type:int
honorRefspec
(optional)-
Perform initial clone using the refspec defined for the repository.
This can save time, data transfer and disk space when you only need
to access the references specified by the refspec.Type:boolean
$class: 'DiscoverOtherRefsTrait'
-
Discovers other specified refs on the repository.
ref
-
The pattern under /refs on the remote repository to discover, can contain a wildcard.
Example: test/*/mergedType:String
nameMapping
(optional)-
Mapping for how the ref can be named in for example the
@Library
.
Example: test-@{1}
Where @{1} replaces the first wildcard in the ref when discovered.By default it will be «namespace_before_wildcard-@{1}». E.g. if ref is «test/*/merged» the default mapping would be
«test-@{1}».Type:String
$class: 'GitBrowserSCMSourceTrait'
-
browser
-
- Nested choice of objects
-
$class: 'AssemblaWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://www.assembla.com/code/PROJECT/git/).
Type:String
bitbucketServer
-
repoUrl
-
Specify the Bitbucket Server root URL for this repository (such as https://bitbucket:7990/OWNER/REPO/).
Type:String
$class: 'BitbucketWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://bitbucket.org/OWNER/REPO/).
Type:String
$class: 'CGit'
-
repoUrl
-
Specify the root URL serving this repository (such as http://cgit.example.com:port/group/REPO/).
Type:String
$class: 'FisheyeGitRepositoryBrowser'
-
repoUrl
-
Specify the URL of this repository in FishEye (such as http://fisheye6.cenqua.com/browse/ant/).
Type:String
$class: 'GitBlitRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository.
Type:String
projectName
-
Specify the name of the project in GitBlit.
Type:String
$class: 'GitLab'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gitlabserver:port/group/REPO/).
Type:String
version
(optional)-
Specify the major and minor version of GitLab you use (such as 9.1). If you
don’t specify a version, a modern version of GitLab (>= 8.0) is assumed.Type:String
$class: 'GitList'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gitlistserver:port/REPO/).
Type:String
$class: 'GitWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://github.com/jenkinsci/jenkins.git).
Type:String
$class: 'GithubWeb'
-
repoUrl
-
Specify the HTTP URL for this repository’s GitHub page (such as https://github.com/jquery/jquery).
Type:String
$class: 'Gitiles'
-
repoUrl
-
Specify the root URL serving this repository (such as https://gwt.googlesource.com/gwt/).
Type:String
$class: 'GitoriousWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://gitorious.org/gitorious/mainline).
Type:String
$class: 'GogsGit'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gogs.example.com:port/username/some-repo-url.git).
Type:String
$class: 'KilnGit'
-
repoUrl
-
Specify the root URL serving this repository (such as https://khanacademy.kilnhg.com/Code/Website/Group/webapp).
Type:String
$class: 'Phabricator'
-
repoUrl
-
Specify the phabricator instance root URL (such as http://phabricator.example.com).
Type:String
repo
-
Specify the repository name in phabricator (such as the foo part of phabricator.example.com/diffusion/foo/browse).
Type:String
$class: 'RedmineWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as http://SERVER/PATH/projects/PROJECT/repository).
Type:String
$class: 'RhodeCode'
-
repoUrl
-
Specify the HTTP URL for this repository’s RhodeCode page (such as http://rhodecode.mydomain.com:5000/projects/PROJECT/repos/REPO/).
Type:String
$class: 'ScmManagerGitRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository (such as https://scm-manager.org/scm/repo/namespace/name).
Type:String
$class: 'Stash'
-
repoUrl
-
Specify the HTTP URL for this repository’s Stash page (such as http://stash.mydomain.com:7990/projects/PROJECT/repos/REPO/).
Type:String
$class: 'TFS2013GitRepositoryBrowser'
-
repoUrl
-
Either the name of the remote whose URL should be used, or the URL of this
module in TFS (such as http://fisheye6.cenqua.com/tfs/PROJECT/_git/REPO/).
If empty (default), the URL of the «origin» repository is used.If TFS is also used as the repository server, this can usually be left blank.
Type:String
$class: 'ViewGitWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as http://code.fealdia.org/viewgit/).
Type:String
projectName
-
Specify the name of the project in ViewGit (e.g. scripts, scuttle etc. from http://code.fealdia.org/viewgit/).
Type:String
$class: 'GitLFSPullTrait'
-
$class: 'GitToolSCMSourceTrait'
-
gitTool
-
Type:String
gitHubIgnoreDraftPullRequestFilter
-
$class: 'IgnoreOnPushNotificationTrait'
-
$class: 'LocalBranchTrait'
-
$class: 'MercurialBrowserSCMSourceTrait'
-
browser
-
- Nested choice of objects
-
$class: 'FishEye'
-
url
-
Specify the root URL serving this repository, such as: http://www.example.org/browse/hg/
Type:String
$class: 'GoogleCode'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'HgWeb'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'Kallithea'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'KilnHG'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'RhodeCode'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'RhodeCodeLegacy'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'ScmManager'
-
url
-
Specify the root URL serving this repository (such as
http://YOURSCMMANAGER/scm/repo/NAMESPACE/NAME/
).Type:String
$class: 'MercurialInstallationSCMSourceTrait'
-
installation
-
Type:String
$class: 'PruneStaleBranchTrait'
-
$class: 'PruneStaleTagTrait'
-
bitbucketPublicRepoPullRequestFilter
-
If the repository being scanned is a public repository, this behaviour will exclude all pull requests.
(Note: This behaviour is not especially useful if scanning a single repository as you could just not include the
pull request discovery behaviours in the first place) $class: 'PullRequestDiscoveryTrait'
-
excludeBranchesWithPRs
-
Exclude branches for which there is an open pull request
Type:boolean
$class: 'RefSpecsSCMSourceTrait'
-
templates
-
Array/List:
- Nested object
-
value
-
A ref spec to fetch. Any occurrences of
@{remote}
will be replaced by the remote name
(which defaults toorigin
) before use.Type:String
headRegexFilter
-
regex
-
A Java regular expression to
restrict the names. Names that do not match the supplied regular expression will be ignored.
NOTE: this filter will be applied to all branch like things, including change requestsType:String
$class: 'RemoteNameSCMSourceTrait'
-
remoteName
-
Type:String
$class: 'SparseCheckoutPathsTrait'
-
extension
-
- Nested object
-
Specify the paths that you’d like to sparse checkout. This may be used for saving space (Think about a reference repository).
Be sure to use a recent version of Git, at least above 1.7.10sparseCheckoutPaths
-
Array/List:
- Nested object
-
path
-
Type:String
$class: 'SubmoduleOptionTrait'
-
extension
-
- Nested object
-
disableSubmodules
-
By disabling support for submodules you can still keep using basic
git plugin functionality and just have Jenkins to ignore submodules
completely as if they didn’t exist.Type:boolean
recursiveSubmodules
-
Retrieve all submodules recursively
(uses ‘—recursive’ option which requires git>=1.6.5)
Type:boolean
trackingSubmodules
-
Retrieve the tip of the configured branch in .gitmodules
(Uses ‘—remote’ option which requires git>=1.8.2)
Type:boolean
reference
-
Specify a folder containing a repository that will be used by Git as a reference during clone operations.
This option will be ignored if the folder is not available on the controller or agent where the clone is being executed.
To prepare a reference folder with multiple subprojects, create a bare git repository and add all the remote urls then perform a fetch:git init --bare git remote add SubProject1 https://gitrepo.com/subproject1 git remote add SubProject2 https://gitrepo.com/subproject2 git fetch --all
Type:String
timeout
-
Specify a timeout (in minutes) for submodules operations.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
parentCredentials
-
Use credentials from the default remote of the parent project.
Type:boolean
depth
(optional)-
Set shallow clone depth, so that git will only download recent history of the project,
saving time and disk space when you just want to access the latest commits of a repository.Type:int
shallow
(optional)-
Perform shallow clone, so that git will not download the history of the project,
saving time and disk space when you just want to access the latest version of a repository.Type:boolean
threads
(optional)-
Specify the number of threads that will be used to update submodules.
If unspecified, the command line git default thread count is used.Type:int
$class: 'UserIdentityTrait'
-
extension
-
- Nested object
-
name
-
If given, «GIT_COMMITTER_NAME=[this]» and «GIT_AUTHOR_NAME=[this]» are set for builds. This overrides whatever is in the global settings.
Type:String
email
-
If given, «GIT_COMMITTER_EMAIL=[this]» and «GIT_AUTHOR_EMAIL=[this]» are set for builds. This overrides whatever is in the global settings.
Type:String
bitbucketWebhookConfiguration
-
Sets the value for committersToIgnore in the Bitbucket Webhook. Value should be a comma separated string.
committerToIgnore is used to prevent triggering Jenkins builds when commits by certain users
are made.committersToIgnore
-
Type:String
bitbucketWebhookRegistration
-
Overrides the defaults for webhook management.
Webhooks are used to inform Jenkins about changes to repositories. There are two ways webhooks can be
configured:- Manual webhook configuration requires the user to configure Bitbucket with the Jenkins URL in order
to ensure that Bitbucket will send the events to Jenkins after every change. - Automatic webhook configuration requires that Jenkins has credentials with sufficient permission to
configure webhooks and also that Jenkins knows the URL that Bitbucket can connect to.
The Manage Jenkins » Configure Jenkins › Bitbucket Endpoints allows defining the list of
servers. Each server
can be associated with credentials. If credentials are defined then the default behaviour is to use those
credentials to automatically manage the webhooks of all repositories that Jenkins is interested in. If no
credentials are defined then the default behaviour is to require the user to manually configure webhooks.mode
-
There are two available modes:
- Disable hook management
- Disables hook management irrespective of the global defaults.
- Use item credentials for hook management
- Enabled hook management but uses the selected credentials to manage the hooks rather than those defined in
Manage Jenkins » Configure Jenkins › Bitbucket Endpoints
Type:String
- Manual webhook configuration requires the user to configure Bitbucket with the Jenkins URL in order
headWildcardFilter
-
includes
-
Space-separated list of name patterns to consider.
You may use*
as a wildcard; for example:master release*
NOTE: this filter will be applied to all branch like things, including change requestsType:String
excludes
-
Space-separated list of name patterns to ignore even if matched by the includes list.
For example:release alpha-* beta-*
NOTE: this filter will be applied to all branch like things, including change requestsType:String
$class: 'WipeWorkspaceTrait'
-
bitbucketBranchDiscovery
-
Discovers branches on the repository.
strategyId
-
Determines which branches are discovered.
- Exclude branches that are also filed as PRs
-
If you are discovering origin pull requests, it may not make sense to discover the same changes both as a
pull request and as a branch. - Only branches that are also filed as PRs
-
Discovers branches that have PR’s associated with them. This may make sense if you have a
notification sent to the team at the end of a triggered build or limited Jenkins resources. - All branches
-
Ignores whether the branch is also filed as a pull request and instead discovers all branches on the
origin repository.
Type:int
bitbucketForkDiscovery
-
Discovers pull requests where the origin repository is a fork of the target repository.
strategyId
-
Determines how pull requests are discovered.
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging
Type:int
trust
-
One of the great powers of pull requests is that anyone with read access to a repository can fork it, commit
some changes to their fork and then create a pull request against the original repository with their changes.
There are some files stored in source control that are important. For example, aJenkinsfile
may contain configuration details to sandbox pull requests in order to mitigate against malicious pull requests.
In order to protect against a malicious pull request itself modifying theJenkinsfile
to remove
the protections, you can define the trust policy for pull requests from forks.Other plugins can extend the available trust policies. The default policies are:
- Nobody
-
Pull requests from forks will all be treated as untrusted. This means that where Jenkins requires a
trusted file (e.g.Jenkinsfile
) the contents of that file will be retrieved from the
target branch on the origin repository and not from the pull request branch on the fork repository. - Forks in the same account
-
Bitbucket allows for a repository to be forked into a «sibling» repository in the same account but using
a different name. This strategy will trust any pull requests from forks that are in the same account as
the target repository on the basis that users have to have been granted write permission to account in
order create such a fork. - Everyone
-
All pull requests from forks will be treated as trusted. NOTE: this option can be dangerous
if used on a public repository hosted on Bitbucket Cloud.
java.lang.UnsupportedOperationException: do not know how to categorize attributes of type jenkins.scm.api.trait.SCMHeadAuthority<? super com.cloudbees.jenkins.plugins.bitbucket.BitbucketSCMSourceRequest, ? extends jenkins.scm.api.mixin.ChangeRequestSCMHead2, ? extends jenkins.scm.api.SCMRevision>
bitbucketPullRequestDiscovery
-
Discovers pull requests where the origin repository is the same as the target repository.
strategyId
-
Determines how pull requests are discovered.
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging
Type:int
bitbucketSshCheckout
-
By default the discovered branches / pull requests will all use the same credentials
that were used for discovery when checking out sources. This means that the checkout will be using the
https://
protocol for the Git repository.This behaviour allows you to select the SSH private key to be used for checking out sources, which will
consequently force the checkout to use thessh://
protocol.credentialsId
-
Credentials used to check out sources.
It must be a SSH key based credential.
Type:String
bitbucketTagDiscovery
-
Discovers tags on the repository.
$class: 'com.cloudogu.scmmanager.scm.BranchDiscoveryTrait'
-
$class: 'com.cloudogu.scmmanager.scm.TagDiscoveryTrait'
-
gitBranchDiscovery
-
Discovers branches on the repository.
gitTagDiscovery
-
Discovers tags on the repository.
gitHubBranchDiscovery
-
Discovers branches on the repository.
strategyId
-
Determines which branches are discovered.
- Exclude branches that are also filed as PRs
-
If you are discovering origin pull requests, you may not want to also build the source branches
for those pull requests. - Only branches that are also filed as PRs
-
Similar to discovering origin pull requests, but discovers the branch rather than the pull request.
This meansenv.GIT_BRANCH
will be set to the branch name rather thanPR-#
.
Also, status notifications for these builds will only be applied to the commit and not to the pull request. - All branches
-
Ignores whether the branch is also filed as a pull request and instead discovers all branches on the
origin repository.
Type:int
gitHubForkDiscovery
-
Discovers pull requests where the origin repository is a fork of the target repository.
strategyId
-
Determines how pull requests are discovered:
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch. - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging. - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging.
Type:int
trust
-
One of the great powers of pull requests is that anyone with read access to a repository can fork it, commit
some changes to their fork and then create a pull request against the original repository with their changes.
There are some files stored in source control that are important. For example, aJenkinsfile
may contain configuration details to sandbox pull requests in order to mitigate against malicious pull requests.
In order to protect against a malicious pull request itself modifying theJenkinsfile
to remove
the protections, you can define the trust policy for pull requests from forks.Other plugins can extend the available trust policies. The default policies are:
- Nobody
-
Pull requests from forks will all be treated as untrusted. This means that where Jenkins requires a
trusted file (e.g.Jenkinsfile
) the contents of that file will be retrieved from the
target branch on the origin repository and not from the pull request branch on the fork repository. - Collaborators
-
Pull requests from collaborators
to the origin repository will be treated as trusted, all other pull requests from fork repositories
will be treated as untrusted.
Note that if credentials used by Jenkins for scanning the repository does not have permission to
query the list of collaborators to the origin repository then only the origin account will be treated
as trusted — i.e. this will fall back toNobody
.
NOTE: all collaborators are trusted, even if they are only members of a team with read permission. - Everyone
-
All pull requests from forks will be treated as trusted. NOTE: this option can be dangerous
if used on a public repository hosted on GitHub. - From users with Admin or Write permission
-
Pull requests forks will be treated as trusted if and only if the fork owner has either Admin or Write
permissions on the origin repository.
This is the recommended policy.
Note that this strategy requires the
Review
a user’s permission level API, as a result on GitHub Enterprise Server versions before 2.12 this
is the same as trusting Nobody.
java.lang.UnsupportedOperationException: do not know how to categorize attributes of type jenkins.scm.api.trait.SCMHeadAuthority<? super org.jenkinsci.plugins.github_branch_source.GitHubSCMSourceRequest, ? extends jenkins.scm.api.mixin.ChangeRequestSCMHead2, ? extends jenkins.scm.api.SCMRevision>
gitHubPullRequestDiscovery
-
Discovers pull requests where the origin repository is the same as the target repository.
strategyId
-
Determines how pull requests are discovered:
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch. - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging. - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging.
Type:int
gitHubSshCheckout
-
By default the discovered branches / pull requests will all use the same username / password credentials
that were used for discovery when checking out sources. This means that the checkout will be using the
https://
protocol for the Git repository.This behaviour allows you to select the SSH private key to be used for checking out sources, which will
consequently force the checkout to use thessh://
protocol.credentialsId
-
Credentials used to check out sources. Must be a SSH key based credential.
Type:String
gitHubTagDiscovery
-
Discovers tags on the repository.
github
-
repoOwner
-
Specify the name of the GitHub Organization or GitHub User Account.
Type:String
repository
-
Type:String
repositoryUrl
-
Specify the HTTPS URL of the GitHub Organization / User Account and repository.
GitHub examples:
- https://github.com/jenkinsci/github-branch-source-plugin
- https://github.com/jenkinsci/github-branch-source-plugin.git
GitHub Enterprise examples:
- https://myccompany.github.com/jenkinsci/github-branch-source-plugin
- https://myccompany.github.com/jenkinsci/github-branch-source-plugin.git
Type:String
configuredByUrl
-
Type:boolean
apiUri
(optional)-
The server to connect to. The list of servers is configured in the Manage Jenkins » Configure
System » GitHub Enterprise Servers screen.Type:String
buildForkPRHead
(optional)-
Type:boolean
buildForkPRMerge
(optional)-
Type:boolean
buildOriginBranch
(optional)-
Type:boolean
buildOriginBranchWithPR
(optional)-
Type:boolean
buildOriginPRHead
(optional)-
Type:boolean
buildOriginPRMerge
(optional)-
Type:boolean
credentialsId
(optional)-
Credentials used to scan branches and pull requests,
check out sources and mark commit statuses.Note that only «username with password» credentials are supported.
Existing credentials of other kinds will be filtered out. This is because Jenkins
uses the GitHub API, which does not support other ways of authentication.If none is given, only the public repositories will be scanned, and commit status
will not be set on GitHub.If your organization contains private repositories, then you need to specify
a credential from a user who has access to those repositories. This is done
by creating a «username with password» credential where the password is
GitHub personal access tokens.
The necessary scope is «repo».Type:String
excludes
(optional)-
Type:String
id
(optional)-
Type:String
includes
(optional)-
Type:String
traits
(optional)-
The behaviours control what is discovered from the GitHub repository. The behaviours are grouped into a number
of categories:- Within repository
- These behaviours determine what gets discovered. If you do not configure at least one discovery
behaviour then nothing will be found! - General
- These behaviours affect the configuration of each discovered branch / pull request.
Array/List:
- Nested choice of objects
-
$class: 'AuthorInChangelogTrait'
-
bitbucketBuildStatusNotifications
-
Configure the Bitbucket notifications.
disableNotificationForNotBuildJobs
(optional)-
Type:boolean
sendSuccessNotificationForUnstableBuild
(optional)-
Type:boolean
$class: 'CheckoutOptionTrait'
-
extension
-
- Nested object
-
timeout
-
Specify a timeout (in minutes) for checkout.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
$class: 'CleanAfterCheckoutTrait'
-
extension
-
- Nested object
-
Clean up the workspace after every checkout by deleting all untracked files and directories,
including those which are specified in.gitignore
.
It also resets all tracked files to their versioned state.
This ensures that the workspace is
in the same state as if you cloned and checked out in a brand-new empty directory, and ensures
that your build is not affected by the files generated by the previous build.deleteUntrackedNestedRepositories
(optional)-
Deletes untracked submodules and any other subdirectories which contain
.git
directories.Type:boolean
$class: 'CleanBeforeCheckoutTrait'
-
extension
-
- Nested object
-
Clean up the workspace before every checkout by deleting all untracked files and directories,
including those which are specified in.gitignore
.
It also resets all tracked files to their versioned state.
This ensures that the workspace is
in the same state as if you cloned and checked out in a brand-new empty directory, and ensures
that your build is not affected by the files generated by the previous build.deleteUntrackedNestedRepositories
(optional)-
Deletes untracked submodules and any other subdirectories which contain
.git
directories.Type:boolean
$class: 'CleanMercurialSCMSourceTrait'
-
When this behaviour is present, each build will wipe any local modifications
or untracked files in the repository checkout.
This is often a convenient way to ensure that a build is not
using any artifacts from earlier builds. $class: 'CloneOptionTrait'
-
extension
-
- Nested object
-
shallow
-
Perform shallow clone, so that git will not download the history of the project,
saving time and disk space when you just want to access the latest version of a repository.Type:boolean
noTags
-
Deselect this to perform a clone without tags, saving time and disk space when you just want to access
what is specified by the refspec.Type:boolean
reference
-
Specify a folder containing a repository that will be used by Git as a reference during clone operations.
This option will be ignored if the folder is not available on the controller or agent where the clone is being executed.Type:String
timeout
-
Specify a timeout (in minutes) for clone and fetch operations.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
depth
(optional)-
Set shallow clone depth, so that git will only download recent history of the project,
saving time and disk space when you just want to access the latest commits of a repository.Type:int
honorRefspec
(optional)-
Perform initial clone using the refspec defined for the repository.
This can save time, data transfer and disk space when you only need
to access the references specified by the refspec.Type:boolean
$class: 'DiscoverOtherRefsTrait'
-
Discovers other specified refs on the repository.
ref
-
The pattern under /refs on the remote repository to discover, can contain a wildcard.
Example: test/*/mergedType:String
nameMapping
(optional)-
Mapping for how the ref can be named in for example the
@Library
.
Example: test-@{1}
Where @{1} replaces the first wildcard in the ref when discovered.By default it will be «namespace_before_wildcard-@{1}». E.g. if ref is «test/*/merged» the default mapping would be
«test-@{1}».Type:String
$class: 'GitBrowserSCMSourceTrait'
-
browser
-
- Nested choice of objects
-
$class: 'AssemblaWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://www.assembla.com/code/PROJECT/git/).
Type:String
bitbucketServer
-
repoUrl
-
Specify the Bitbucket Server root URL for this repository (such as https://bitbucket:7990/OWNER/REPO/).
Type:String
$class: 'BitbucketWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://bitbucket.org/OWNER/REPO/).
Type:String
$class: 'CGit'
-
repoUrl
-
Specify the root URL serving this repository (such as http://cgit.example.com:port/group/REPO/).
Type:String
$class: 'FisheyeGitRepositoryBrowser'
-
repoUrl
-
Specify the URL of this repository in FishEye (such as http://fisheye6.cenqua.com/browse/ant/).
Type:String
$class: 'GitBlitRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository.
Type:String
projectName
-
Specify the name of the project in GitBlit.
Type:String
$class: 'GitLab'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gitlabserver:port/group/REPO/).
Type:String
version
(optional)-
Specify the major and minor version of GitLab you use (such as 9.1). If you
don’t specify a version, a modern version of GitLab (>= 8.0) is assumed.Type:String
$class: 'GitList'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gitlistserver:port/REPO/).
Type:String
$class: 'GitWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://github.com/jenkinsci/jenkins.git).
Type:String
$class: 'GithubWeb'
-
repoUrl
-
Specify the HTTP URL for this repository’s GitHub page (such as https://github.com/jquery/jquery).
Type:String
$class: 'Gitiles'
-
repoUrl
-
Specify the root URL serving this repository (such as https://gwt.googlesource.com/gwt/).
Type:String
$class: 'GitoriousWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://gitorious.org/gitorious/mainline).
Type:String
$class: 'GogsGit'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gogs.example.com:port/username/some-repo-url.git).
Type:String
$class: 'KilnGit'
-
repoUrl
-
Specify the root URL serving this repository (such as https://khanacademy.kilnhg.com/Code/Website/Group/webapp).
Type:String
$class: 'Phabricator'
-
repoUrl
-
Specify the phabricator instance root URL (such as http://phabricator.example.com).
Type:String
repo
-
Specify the repository name in phabricator (such as the foo part of phabricator.example.com/diffusion/foo/browse).
Type:String
$class: 'RedmineWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as http://SERVER/PATH/projects/PROJECT/repository).
Type:String
$class: 'RhodeCode'
-
repoUrl
-
Specify the HTTP URL for this repository’s RhodeCode page (such as http://rhodecode.mydomain.com:5000/projects/PROJECT/repos/REPO/).
Type:String
$class: 'ScmManagerGitRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository (such as https://scm-manager.org/scm/repo/namespace/name).
Type:String
$class: 'Stash'
-
repoUrl
-
Specify the HTTP URL for this repository’s Stash page (such as http://stash.mydomain.com:7990/projects/PROJECT/repos/REPO/).
Type:String
$class: 'TFS2013GitRepositoryBrowser'
-
repoUrl
-
Either the name of the remote whose URL should be used, or the URL of this
module in TFS (such as http://fisheye6.cenqua.com/tfs/PROJECT/_git/REPO/).
If empty (default), the URL of the «origin» repository is used.If TFS is also used as the repository server, this can usually be left blank.
Type:String
$class: 'ViewGitWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as http://code.fealdia.org/viewgit/).
Type:String
projectName
-
Specify the name of the project in ViewGit (e.g. scripts, scuttle etc. from http://code.fealdia.org/viewgit/).
Type:String
$class: 'GitLFSPullTrait'
-
$class: 'GitToolSCMSourceTrait'
-
gitTool
-
Type:String
gitHubIgnoreDraftPullRequestFilter
-
$class: 'IgnoreOnPushNotificationTrait'
-
$class: 'LocalBranchTrait'
-
$class: 'MercurialBrowserSCMSourceTrait'
-
browser
-
- Nested choice of objects
-
$class: 'FishEye'
-
url
-
Specify the root URL serving this repository, such as: http://www.example.org/browse/hg/
Type:String
$class: 'GoogleCode'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'HgWeb'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'Kallithea'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'KilnHG'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'RhodeCode'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'RhodeCodeLegacy'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'ScmManager'
-
url
-
Specify the root URL serving this repository (such as
http://YOURSCMMANAGER/scm/repo/NAMESPACE/NAME/
).Type:String
$class: 'MercurialInstallationSCMSourceTrait'
-
installation
-
Type:String
$class: 'PruneStaleBranchTrait'
-
$class: 'PruneStaleTagTrait'
-
bitbucketPublicRepoPullRequestFilter
-
If the repository being scanned is a public repository, this behaviour will exclude all pull requests.
(Note: This behaviour is not especially useful if scanning a single repository as you could just not include the
pull request discovery behaviours in the first place) $class: 'PullRequestDiscoveryTrait'
-
excludeBranchesWithPRs
-
Exclude branches for which there is an open pull request
Type:boolean
$class: 'RefSpecsSCMSourceTrait'
-
templates
-
Array/List:
- Nested object
-
value
-
A ref spec to fetch. Any occurrences of
@{remote}
will be replaced by the remote name
(which defaults toorigin
) before use.Type:String
headRegexFilter
-
regex
-
A Java regular expression to
restrict the names. Names that do not match the supplied regular expression will be ignored.
NOTE: this filter will be applied to all branch like things, including change requestsType:String
$class: 'RemoteNameSCMSourceTrait'
-
remoteName
-
Type:String
$class: 'SparseCheckoutPathsTrait'
-
extension
-
- Nested object
-
Specify the paths that you’d like to sparse checkout. This may be used for saving space (Think about a reference repository).
Be sure to use a recent version of Git, at least above 1.7.10sparseCheckoutPaths
-
Array/List:
- Nested object
-
path
-
Type:String
$class: 'SubmoduleOptionTrait'
-
extension
-
- Nested object
-
disableSubmodules
-
By disabling support for submodules you can still keep using basic
git plugin functionality and just have Jenkins to ignore submodules
completely as if they didn’t exist.Type:boolean
recursiveSubmodules
-
Retrieve all submodules recursively
(uses ‘—recursive’ option which requires git>=1.6.5)
Type:boolean
trackingSubmodules
-
Retrieve the tip of the configured branch in .gitmodules
(Uses ‘—remote’ option which requires git>=1.8.2)
Type:boolean
reference
-
Specify a folder containing a repository that will be used by Git as a reference during clone operations.
This option will be ignored if the folder is not available on the controller or agent where the clone is being executed.
To prepare a reference folder with multiple subprojects, create a bare git repository and add all the remote urls then perform a fetch:git init --bare git remote add SubProject1 https://gitrepo.com/subproject1 git remote add SubProject2 https://gitrepo.com/subproject2 git fetch --all
Type:String
timeout
-
Specify a timeout (in minutes) for submodules operations.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
parentCredentials
-
Use credentials from the default remote of the parent project.
Type:boolean
depth
(optional)-
Set shallow clone depth, so that git will only download recent history of the project,
saving time and disk space when you just want to access the latest commits of a repository.Type:int
shallow
(optional)-
Perform shallow clone, so that git will not download the history of the project,
saving time and disk space when you just want to access the latest version of a repository.Type:boolean
threads
(optional)-
Specify the number of threads that will be used to update submodules.
If unspecified, the command line git default thread count is used.Type:int
$class: 'UserIdentityTrait'
-
extension
-
- Nested object
-
name
-
If given, «GIT_COMMITTER_NAME=[this]» and «GIT_AUTHOR_NAME=[this]» are set for builds. This overrides whatever is in the global settings.
Type:String
email
-
If given, «GIT_COMMITTER_EMAIL=[this]» and «GIT_AUTHOR_EMAIL=[this]» are set for builds. This overrides whatever is in the global settings.
Type:String
bitbucketWebhookConfiguration
-
Sets the value for committersToIgnore in the Bitbucket Webhook. Value should be a comma separated string.
committerToIgnore is used to prevent triggering Jenkins builds when commits by certain users
are made.committersToIgnore
-
Type:String
bitbucketWebhookRegistration
-
Overrides the defaults for webhook management.
Webhooks are used to inform Jenkins about changes to repositories. There are two ways webhooks can be
configured:- Manual webhook configuration requires the user to configure Bitbucket with the Jenkins URL in order
to ensure that Bitbucket will send the events to Jenkins after every change. - Automatic webhook configuration requires that Jenkins has credentials with sufficient permission to
configure webhooks and also that Jenkins knows the URL that Bitbucket can connect to.
The Manage Jenkins » Configure Jenkins › Bitbucket Endpoints allows defining the list of
servers. Each server
can be associated with credentials. If credentials are defined then the default behaviour is to use those
credentials to automatically manage the webhooks of all repositories that Jenkins is interested in. If no
credentials are defined then the default behaviour is to require the user to manually configure webhooks.mode
-
There are two available modes:
- Disable hook management
- Disables hook management irrespective of the global defaults.
- Use item credentials for hook management
- Enabled hook management but uses the selected credentials to manage the hooks rather than those defined in
Manage Jenkins » Configure Jenkins › Bitbucket Endpoints
Type:String
- Manual webhook configuration requires the user to configure Bitbucket with the Jenkins URL in order
headWildcardFilter
-
includes
-
Space-separated list of name patterns to consider.
You may use*
as a wildcard; for example:master release*
NOTE: this filter will be applied to all branch like things, including change requestsType:String
excludes
-
Space-separated list of name patterns to ignore even if matched by the includes list.
For example:release alpha-* beta-*
NOTE: this filter will be applied to all branch like things, including change requestsType:String
$class: 'WipeWorkspaceTrait'
-
bitbucketBranchDiscovery
-
Discovers branches on the repository.
strategyId
-
Determines which branches are discovered.
- Exclude branches that are also filed as PRs
-
If you are discovering origin pull requests, it may not make sense to discover the same changes both as a
pull request and as a branch. - Only branches that are also filed as PRs
-
Discovers branches that have PR’s associated with them. This may make sense if you have a
notification sent to the team at the end of a triggered build or limited Jenkins resources. - All branches
-
Ignores whether the branch is also filed as a pull request and instead discovers all branches on the
origin repository.
Type:int
bitbucketForkDiscovery
-
Discovers pull requests where the origin repository is a fork of the target repository.
strategyId
-
Determines how pull requests are discovered.
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging
Type:int
trust
-
One of the great powers of pull requests is that anyone with read access to a repository can fork it, commit
some changes to their fork and then create a pull request against the original repository with their changes.
There are some files stored in source control that are important. For example, aJenkinsfile
may contain configuration details to sandbox pull requests in order to mitigate against malicious pull requests.
In order to protect against a malicious pull request itself modifying theJenkinsfile
to remove
the protections, you can define the trust policy for pull requests from forks.Other plugins can extend the available trust policies. The default policies are:
- Nobody
-
Pull requests from forks will all be treated as untrusted. This means that where Jenkins requires a
trusted file (e.g.Jenkinsfile
) the contents of that file will be retrieved from the
target branch on the origin repository and not from the pull request branch on the fork repository. - Forks in the same account
-
Bitbucket allows for a repository to be forked into a «sibling» repository in the same account but using
a different name. This strategy will trust any pull requests from forks that are in the same account as
the target repository on the basis that users have to have been granted write permission to account in
order create such a fork. - Everyone
-
All pull requests from forks will be treated as trusted. NOTE: this option can be dangerous
if used on a public repository hosted on Bitbucket Cloud.
java.lang.UnsupportedOperationException: do not know how to categorize attributes of type jenkins.scm.api.trait.SCMHeadAuthority<? super com.cloudbees.jenkins.plugins.bitbucket.BitbucketSCMSourceRequest, ? extends jenkins.scm.api.mixin.ChangeRequestSCMHead2, ? extends jenkins.scm.api.SCMRevision>
bitbucketPullRequestDiscovery
-
Discovers pull requests where the origin repository is the same as the target repository.
strategyId
-
Determines how pull requests are discovered.
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging
Type:int
bitbucketSshCheckout
-
By default the discovered branches / pull requests will all use the same credentials
that were used for discovery when checking out sources. This means that the checkout will be using the
https://
protocol for the Git repository.This behaviour allows you to select the SSH private key to be used for checking out sources, which will
consequently force the checkout to use thessh://
protocol.credentialsId
-
Credentials used to check out sources.
It must be a SSH key based credential.
Type:String
bitbucketTagDiscovery
-
Discovers tags on the repository.
$class: 'com.cloudogu.scmmanager.scm.BranchDiscoveryTrait'
-
$class: 'com.cloudogu.scmmanager.scm.TagDiscoveryTrait'
-
gitBranchDiscovery
-
Discovers branches on the repository.
gitTagDiscovery
-
Discovers tags on the repository.
gitHubBranchDiscovery
-
Discovers branches on the repository.
strategyId
-
Determines which branches are discovered.
- Exclude branches that are also filed as PRs
-
If you are discovering origin pull requests, you may not want to also build the source branches
for those pull requests. - Only branches that are also filed as PRs
-
Similar to discovering origin pull requests, but discovers the branch rather than the pull request.
This meansenv.GIT_BRANCH
will be set to the branch name rather thanPR-#
.
Also, status notifications for these builds will only be applied to the commit and not to the pull request. - All branches
-
Ignores whether the branch is also filed as a pull request and instead discovers all branches on the
origin repository.
Type:int
gitHubForkDiscovery
-
Discovers pull requests where the origin repository is a fork of the target repository.
strategyId
-
Determines how pull requests are discovered:
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch. - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging. - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging.
Type:int
trust
-
One of the great powers of pull requests is that anyone with read access to a repository can fork it, commit
some changes to their fork and then create a pull request against the original repository with their changes.
There are some files stored in source control that are important. For example, aJenkinsfile
may contain configuration details to sandbox pull requests in order to mitigate against malicious pull requests.
In order to protect against a malicious pull request itself modifying theJenkinsfile
to remove
the protections, you can define the trust policy for pull requests from forks.Other plugins can extend the available trust policies. The default policies are:
- Nobody
-
Pull requests from forks will all be treated as untrusted. This means that where Jenkins requires a
trusted file (e.g.Jenkinsfile
) the contents of that file will be retrieved from the
target branch on the origin repository and not from the pull request branch on the fork repository. - Collaborators
-
Pull requests from collaborators
to the origin repository will be treated as trusted, all other pull requests from fork repositories
will be treated as untrusted.
Note that if credentials used by Jenkins for scanning the repository does not have permission to
query the list of collaborators to the origin repository then only the origin account will be treated
as trusted — i.e. this will fall back toNobody
.
NOTE: all collaborators are trusted, even if they are only members of a team with read permission. - Everyone
-
All pull requests from forks will be treated as trusted. NOTE: this option can be dangerous
if used on a public repository hosted on GitHub. - From users with Admin or Write permission
-
Pull requests forks will be treated as trusted if and only if the fork owner has either Admin or Write
permissions on the origin repository.
This is the recommended policy.
Note that this strategy requires the
Review
a user’s permission level API, as a result on GitHub Enterprise Server versions before 2.12 this
is the same as trusting Nobody.
java.lang.UnsupportedOperationException: do not know how to categorize attributes of type jenkins.scm.api.trait.SCMHeadAuthority<? super org.jenkinsci.plugins.github_branch_source.GitHubSCMSourceRequest, ? extends jenkins.scm.api.mixin.ChangeRequestSCMHead2, ? extends jenkins.scm.api.SCMRevision>
gitHubPullRequestDiscovery
-
Discovers pull requests where the origin repository is the same as the target repository.
strategyId
-
Determines how pull requests are discovered:
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch. - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging. - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging.
Type:int
gitHubSshCheckout
-
By default the discovered branches / pull requests will all use the same username / password credentials
that were used for discovery when checking out sources. This means that the checkout will be using the
https://
protocol for the Git repository.This behaviour allows you to select the SSH private key to be used for checking out sources, which will
consequently force the checkout to use thessh://
protocol.credentialsId
-
Credentials used to check out sources. Must be a SSH key based credential.
Type:String
gitHubTagDiscovery
-
Discovers tags on the repository.
git
-
remote
-
Specify the URL of this remote repository. This uses the same syntax as your
git clone
command.Type:String
browser
(optional)-
- Nested choice of objects
-
$class: 'AssemblaWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://www.assembla.com/code/PROJECT/git/).
Type:String
bitbucketServer
-
repoUrl
-
Specify the Bitbucket Server root URL for this repository (such as https://bitbucket:7990/OWNER/REPO/).
Type:String
$class: 'BitbucketWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://bitbucket.org/OWNER/REPO/).
Type:String
$class: 'CGit'
-
repoUrl
-
Specify the root URL serving this repository (such as http://cgit.example.com:port/group/REPO/).
Type:String
$class: 'FisheyeGitRepositoryBrowser'
-
repoUrl
-
Specify the URL of this repository in FishEye (such as http://fisheye6.cenqua.com/browse/ant/).
Type:String
$class: 'GitBlitRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository.
Type:String
projectName
-
Specify the name of the project in GitBlit.
Type:String
$class: 'GitLab'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gitlabserver:port/group/REPO/).
Type:String
version
(optional)-
Specify the major and minor version of GitLab you use (such as 9.1). If you
don’t specify a version, a modern version of GitLab (>= 8.0) is assumed.Type:String
$class: 'GitList'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gitlistserver:port/REPO/).
Type:String
$class: 'GitWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://github.com/jenkinsci/jenkins.git).
Type:String
$class: 'GithubWeb'
-
repoUrl
-
Specify the HTTP URL for this repository’s GitHub page (such as https://github.com/jquery/jquery).
Type:String
$class: 'Gitiles'
-
repoUrl
-
Specify the root URL serving this repository (such as https://gwt.googlesource.com/gwt/).
Type:String
$class: 'GitoriousWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://gitorious.org/gitorious/mainline).
Type:String
$class: 'GogsGit'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gogs.example.com:port/username/some-repo-url.git).
Type:String
$class: 'KilnGit'
-
repoUrl
-
Specify the root URL serving this repository (such as https://khanacademy.kilnhg.com/Code/Website/Group/webapp).
Type:String
$class: 'Phabricator'
-
repoUrl
-
Specify the phabricator instance root URL (such as http://phabricator.example.com).
Type:String
repo
-
Specify the repository name in phabricator (such as the foo part of phabricator.example.com/diffusion/foo/browse).
Type:String
$class: 'RedmineWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as http://SERVER/PATH/projects/PROJECT/repository).
Type:String
$class: 'RhodeCode'
-
repoUrl
-
Specify the HTTP URL for this repository’s RhodeCode page (such as http://rhodecode.mydomain.com:5000/projects/PROJECT/repos/REPO/).
Type:String
$class: 'ScmManagerGitRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository (such as https://scm-manager.org/scm/repo/namespace/name).
Type:String
$class: 'Stash'
-
repoUrl
-
Specify the HTTP URL for this repository’s Stash page (such as http://stash.mydomain.com:7990/projects/PROJECT/repos/REPO/).
Type:String
$class: 'TFS2013GitRepositoryBrowser'
-
repoUrl
-
Either the name of the remote whose URL should be used, or the URL of this
module in TFS (such as http://fisheye6.cenqua.com/tfs/PROJECT/_git/REPO/).
If empty (default), the URL of the «origin» repository is used.If TFS is also used as the repository server, this can usually be left blank.
Type:String
$class: 'ViewGitWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as http://code.fealdia.org/viewgit/).
Type:String
projectName
-
Specify the name of the project in ViewGit (e.g. scripts, scuttle etc. from http://code.fealdia.org/viewgit/).
Type:String
credentialsId
(optional)-
Credentials used to scan branches and check out sources.
Type:String
extensions
(optional)-
Array/List:
- Nested choice of objects
-
$class: 'AuthorInChangelog'
-
The default behavior is to use the Git commit’s «Committer» value in Jenkins’ build changesets.
If this option is selected, the Git commit’s «Author» value would be used instead. $class: 'BuildChooserSetting'
-
When you are interested in using a job to build multiple heads (most typically multiple branches),
you can choose how Jenkins choose what branches to build in what order.This extension point in Jenkins is used by many other plugins to control the job to build
specific commits. When you activate those plugins, you may see them installing a custom strategy
here.buildChooser
-
- Nested choice of objects
-
$class: 'AncestryBuildChooser'
-
maximumAgeInDays
-
Type:int
ancestorCommitSha1
-
Type:String
$class: 'DefaultBuildChooser'
-
$class: 'InverseBuildChooser'
-
$class: 'BuildSingleRevisionOnly'
-
Disable scheduling for multiple candidate revisions.
If we have 3 branches:
—-A—.—.— B
——C
jenkins would try to build (B) and (C).
This behaviour disables this and only builds one of them.
It is helpful to reduce the load of the Jenkins infrastructure when the
SCM system like Bitbucket or GitHub should decide what commits to build. $class: 'ChangelogToBranch'
-
This method calculates the changelog against the specified branch.
options
-
- Nested object
-
compareRemote
-
Name of the repository, such as
origin
, that contains the branch you specify below.Type:String
compareTarget
-
The name of the branch within the named repository to compare against.
Type:String
$class: 'CheckoutOption'
-
timeout
-
Specify a timeout (in minutes) for checkout.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
$class: 'CleanBeforeCheckout'
-
Clean up the workspace before every checkout by deleting all untracked files and directories,
including those which are specified in.gitignore
.
It also resets all tracked files to their versioned state.
This ensures that the workspace is
in the same state as if you cloned and checked out in a brand-new empty directory, and ensures
that your build is not affected by the files generated by the previous build.deleteUntrackedNestedRepositories
(optional)-
Deletes untracked submodules and any other subdirectories which contain
.git
directories.Type:boolean
$class: 'CleanCheckout'
-
Clean up the workspace after every checkout by deleting all untracked files and directories,
including those which are specified in.gitignore
.
It also resets all tracked files to their versioned state.
This ensures that the workspace is
in the same state as if you cloned and checked out in a brand-new empty directory, and ensures
that your build is not affected by the files generated by the previous build.deleteUntrackedNestedRepositories
(optional)-
Deletes untracked submodules and any other subdirectories which contain
.git
directories.Type:boolean
$class: 'CloneOption'
-
shallow
-
Perform shallow clone, so that git will not download the history of the project,
saving time and disk space when you just want to access the latest version of a repository.Type:boolean
noTags
-
Deselect this to perform a clone without tags, saving time and disk space when you just want to access
what is specified by the refspec.Type:boolean
reference
-
Specify a folder containing a repository that will be used by Git as a reference during clone operations.
This option will be ignored if the folder is not available on the controller or agent where the clone is being executed.Type:String
timeout
-
Specify a timeout (in minutes) for clone and fetch operations.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
depth
(optional)-
Set shallow clone depth, so that git will only download recent history of the project,
saving time and disk space when you just want to access the latest commits of a repository.Type:int
honorRefspec
(optional)-
Perform initial clone using the refspec defined for the repository.
This can save time, data transfer and disk space when you only need
to access the references specified by the refspec.Type:boolean
$class: 'DisableRemotePoll'
-
Git plugin uses git ls-remote polling mechanism by default when configured with a single branch (no wildcards!).
This compare the latest built commit SHA with the remote branch without cloning a local copy of the repo.If you don’t want to / can’t use this.
If this option is selected, polling will require a workspace and might trigger unwanted builds (see JENKINS-10131).
$class: 'GitLFSPull'
-
Enable git large file support for the workspace by pulling large files after the checkout completes.
Requires that the controller and each agent performing an LFS checkout have installed `git lfs`. $class: 'IgnoreNotifyCommit'
-
If checked, this repository will be ignored when the notifyCommit-URL is accessed regardless of if the repository
matches or not. $class: 'LocalBranch'
-
If given, checkout the revision to build as HEAD on this branch.
If selected, and its value is an empty string or «**», then the branch
name is computed from the remote branch without the origin. In that
case, a remote branch origin/master will be checked out to a local
branch named master, and a remote branch origin/develop/new-feature
will be checked out to a local branch named develop/newfeature.Please note that this has not been tested with submodules.
localBranch
-
Type:String
$class: 'MessageExclusion'
-
excludedMessage
-
If set, and Jenkins is set to poll for changes, Jenkins will ignore any revisions committed with message matched to
Pattern when determining
if a build needs to be triggered. This can be used to exclude commits done by the build itself from triggering another build,
assuming the build server commits the change with a distinct message.Exclusion uses Pattern
matching.*[maven-release-plugin].*
The example above illustrates that if only revisions with «[maven-release-plugin]» message in first comment line
have been committed to the SCM a build will not occur.You can create more complex patterns using embedded flag expressions.
(?s).*FOO.*
This example will search FOO message in all comment lines.
Type:String
$class: 'PathRestriction'
-
If set, and Jenkins is set to poll for changes, Jenkins will pay attention to included and/or excluded files and/or
folders when determining if a build needs to be triggered.Using this behaviour will preclude the faster git ls-remote polling mechanism, forcing polling to require a workspace thus sometimes triggering unwanted builds, as if you had selected the Force polling using workspace extension as well.
includedRegions
-
Each inclusion uses java regular expression pattern matching,
and must be separated by a new line.
An empty list implies that everything is included.myapp/src/main/web/.*.html myapp/src/main/web/.*.jpeg myapp/src/main/web/.*.gif
The example above illustrates that a build will only occur, if html/jpeg/gif files
have been committed to the SCM. Exclusions take precedence over inclusions, if there is
an overlap between included and excluded regions.Type:String
excludedRegions
-
Each exclusion uses java regular expression pattern matching,
and must be separated by a new line.myapp/src/main/web/.*.html myapp/src/main/web/.*.jpeg myapp/src/main/web/.*.gif
The example above illustrates that if only html/jpeg/gif files have been committed to
the SCM a build will not occur.Type:String
$class: 'PerBuildTag'
-
Create a tag in the workspace for every build to unambiguously mark the commit that was built.
You can combine this with Git publisher to push the tags to the remote repository. $class: 'PreBuildMerge'
-
These options allow you to perform a merge to a particular branch before building.
For example, you could specify an integration branch to be built, and to merge to master.
In this scenario, on every change of integration, Jenkins will perform a merge with the master branch,
and try to perform a build if the merge is successful.
It then may push the merge back to the remote repository if the Git Push post-build action is selected.options
-
- Nested object
-
mergeTarget
-
The name of the branch within the named repository to merge to, such as
master
.Type:String
fastForwardMode
(optional)-
Merge fast-forward mode selection.
The default, —ff, gracefully falls back to a merge commit when required.
For more information, see the Git Merge Documentation mergeRemote
(optional)-
Name of the repository, such as
origin
, that contains the branch you specify below. If left blank,
it’ll default to the name of the first repository configured above.Type:String
mergeStrategy
(optional)-
Merge strategy selection.
This feature is not fully implemented in JGIT.Values:
DEFAULT
RESOLVE
RECURSIVE
OCTOPUS
OURS
SUBTREE
RECURSIVE_THEIRS
$class: 'PruneStaleBranch'
-
Run «git remote prune» for each remote, to prune obsolete local branches.
pruneTags
-
pruneTags
-
Type:boolean
$class: 'RelativeTargetDirectory'
-
relativeTargetDir
-
Specify a local directory (relative to the workspace root)
where the Git repository will be checked out. If left empty, the workspace root itself
will be used.This extension should not be used in Jenkins Pipeline (either declarative or scripted).
Jenkins Pipeline already provides standard techniques for checkout to a subdirectory.
Use ws and
dir
in Jenkins Pipeline rather than this extension.Type:String
$class: 'ScmName'
-
Unique name for this SCM. Needed when using Git within the Multi SCM plugin.
name
-
Type:String
$class: 'SparseCheckoutPaths'
-
Specify the paths that you’d like to sparse checkout. This may be used for saving space (Think about a reference repository).
Be sure to use a recent version of Git, at least above 1.7.10sparseCheckoutPaths
-
Array/List:
- Nested object
-
path
-
Type:String
$class: 'SubmoduleOption'
-
disableSubmodules
-
By disabling support for submodules you can still keep using basic
git plugin functionality and just have Jenkins to ignore submodules
completely as if they didn’t exist.Type:boolean
recursiveSubmodules
-
Retrieve all submodules recursively
(uses ‘—recursive’ option which requires git>=1.6.5)
Type:boolean
trackingSubmodules
-
Retrieve the tip of the configured branch in .gitmodules
(Uses ‘—remote’ option which requires git>=1.8.2)
Type:boolean
reference
-
Specify a folder containing a repository that will be used by Git as a reference during clone operations.
This option will be ignored if the folder is not available on the controller or agent where the clone is being executed.
To prepare a reference folder with multiple subprojects, create a bare git repository and add all the remote urls then perform a fetch:git init --bare git remote add SubProject1 https://gitrepo.com/subproject1 git remote add SubProject2 https://gitrepo.com/subproject2 git fetch --all
Type:String
timeout
-
Specify a timeout (in minutes) for submodules operations.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
parentCredentials
-
Use credentials from the default remote of the parent project.
Type:boolean
depth
(optional)-
Set shallow clone depth, so that git will only download recent history of the project,
saving time and disk space when you just want to access the latest commits of a repository.Type:int
shallow
(optional)-
Perform shallow clone, so that git will not download the history of the project,
saving time and disk space when you just want to access the latest version of a repository.Type:boolean
threads
(optional)-
Specify the number of threads that will be used to update submodules.
If unspecified, the command line git default thread count is used.Type:int
$class: 'UserExclusion'
-
excludedUsers
-
If set, and Jenkins is set to poll for changes, Jenkins will ignore any revisions committed by users in this list when determining if a build needs to be triggered. This can be used to exclude commits done by the build itself from triggering another build, assuming the build server commits the change with a distinct SCM user.
Using this behaviour will preclude the faster git ls-remote polling mechanism, forcing polling to require a workspace thus sometimes triggering unwanted builds, as if you had selected the Force polling using workspace extension as well.
Each exclusion uses exact string comparison and must be separated by a new line.
User names are only excluded if they exactly match one of the names in this list.auto_build_user
The example above illustrates that if only revisions by «auto_build_user» have been committed to the SCM a build will not occur.
Type:String
$class: 'UserIdentity'
-
name
-
If given, «GIT_COMMITTER_NAME=[this]» and «GIT_AUTHOR_NAME=[this]» are set for builds. This overrides whatever is in the global settings.
Type:String
email
-
If given, «GIT_COMMITTER_EMAIL=[this]» and «GIT_AUTHOR_EMAIL=[this]» are set for builds. This overrides whatever is in the global settings.
Type:String
$class: 'WipeWorkspace'
-
Delete the contents of the workspace before building, ensuring a fully fresh workspace.
gitTool
(optional)-
Type:String
id
(optional)-
Type:String
traits
(optional)-
Array/List:
- Nested choice of objects
-
$class: 'AuthorInChangelogTrait'
-
bitbucketBuildStatusNotifications
-
Configure the Bitbucket notifications.
disableNotificationForNotBuildJobs
(optional)-
Type:boolean
sendSuccessNotificationForUnstableBuild
(optional)-
Type:boolean
$class: 'CheckoutOptionTrait'
-
extension
-
- Nested object
-
timeout
-
Specify a timeout (in minutes) for checkout.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
$class: 'CleanAfterCheckoutTrait'
-
extension
-
- Nested object
-
Clean up the workspace after every checkout by deleting all untracked files and directories,
including those which are specified in.gitignore
.
It also resets all tracked files to their versioned state.
This ensures that the workspace is
in the same state as if you cloned and checked out in a brand-new empty directory, and ensures
that your build is not affected by the files generated by the previous build.deleteUntrackedNestedRepositories
(optional)-
Deletes untracked submodules and any other subdirectories which contain
.git
directories.Type:boolean
$class: 'CleanBeforeCheckoutTrait'
-
extension
-
- Nested object
-
Clean up the workspace before every checkout by deleting all untracked files and directories,
including those which are specified in.gitignore
.
It also resets all tracked files to their versioned state.
This ensures that the workspace is
in the same state as if you cloned and checked out in a brand-new empty directory, and ensures
that your build is not affected by the files generated by the previous build.deleteUntrackedNestedRepositories
(optional)-
Deletes untracked submodules and any other subdirectories which contain
.git
directories.Type:boolean
$class: 'CleanMercurialSCMSourceTrait'
-
When this behaviour is present, each build will wipe any local modifications
or untracked files in the repository checkout.
This is often a convenient way to ensure that a build is not
using any artifacts from earlier builds. $class: 'CloneOptionTrait'
-
extension
-
- Nested object
-
shallow
-
Perform shallow clone, so that git will not download the history of the project,
saving time and disk space when you just want to access the latest version of a repository.Type:boolean
noTags
-
Deselect this to perform a clone without tags, saving time and disk space when you just want to access
what is specified by the refspec.Type:boolean
reference
-
Specify a folder containing a repository that will be used by Git as a reference during clone operations.
This option will be ignored if the folder is not available on the controller or agent where the clone is being executed.Type:String
timeout
-
Specify a timeout (in minutes) for clone and fetch operations.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
depth
(optional)-
Set shallow clone depth, so that git will only download recent history of the project,
saving time and disk space when you just want to access the latest commits of a repository.Type:int
honorRefspec
(optional)-
Perform initial clone using the refspec defined for the repository.
This can save time, data transfer and disk space when you only need
to access the references specified by the refspec.Type:boolean
$class: 'DiscoverOtherRefsTrait'
-
Discovers other specified refs on the repository.
ref
-
The pattern under /refs on the remote repository to discover, can contain a wildcard.
Example: test/*/mergedType:String
nameMapping
(optional)-
Mapping for how the ref can be named in for example the
@Library
.
Example: test-@{1}
Where @{1} replaces the first wildcard in the ref when discovered.By default it will be «namespace_before_wildcard-@{1}». E.g. if ref is «test/*/merged» the default mapping would be
«test-@{1}».Type:String
$class: 'GitBrowserSCMSourceTrait'
-
browser
-
- Nested choice of objects
-
$class: 'AssemblaWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://www.assembla.com/code/PROJECT/git/).
Type:String
bitbucketServer
-
repoUrl
-
Specify the Bitbucket Server root URL for this repository (such as https://bitbucket:7990/OWNER/REPO/).
Type:String
$class: 'BitbucketWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://bitbucket.org/OWNER/REPO/).
Type:String
$class: 'CGit'
-
repoUrl
-
Specify the root URL serving this repository (such as http://cgit.example.com:port/group/REPO/).
Type:String
$class: 'FisheyeGitRepositoryBrowser'
-
repoUrl
-
Specify the URL of this repository in FishEye (such as http://fisheye6.cenqua.com/browse/ant/).
Type:String
$class: 'GitBlitRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository.
Type:String
projectName
-
Specify the name of the project in GitBlit.
Type:String
$class: 'GitLab'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gitlabserver:port/group/REPO/).
Type:String
version
(optional)-
Specify the major and minor version of GitLab you use (such as 9.1). If you
don’t specify a version, a modern version of GitLab (>= 8.0) is assumed.Type:String
$class: 'GitList'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gitlistserver:port/REPO/).
Type:String
$class: 'GitWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://github.com/jenkinsci/jenkins.git).
Type:String
$class: 'GithubWeb'
-
repoUrl
-
Specify the HTTP URL for this repository’s GitHub page (such as https://github.com/jquery/jquery).
Type:String
$class: 'Gitiles'
-
repoUrl
-
Specify the root URL serving this repository (such as https://gwt.googlesource.com/gwt/).
Type:String
$class: 'GitoriousWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://gitorious.org/gitorious/mainline).
Type:String
$class: 'GogsGit'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gogs.example.com:port/username/some-repo-url.git).
Type:String
$class: 'KilnGit'
-
repoUrl
-
Specify the root URL serving this repository (such as https://khanacademy.kilnhg.com/Code/Website/Group/webapp).
Type:String
$class: 'Phabricator'
-
repoUrl
-
Specify the phabricator instance root URL (such as http://phabricator.example.com).
Type:String
repo
-
Specify the repository name in phabricator (such as the foo part of phabricator.example.com/diffusion/foo/browse).
Type:String
$class: 'RedmineWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as http://SERVER/PATH/projects/PROJECT/repository).
Type:String
$class: 'RhodeCode'
-
repoUrl
-
Specify the HTTP URL for this repository’s RhodeCode page (such as http://rhodecode.mydomain.com:5000/projects/PROJECT/repos/REPO/).
Type:String
$class: 'ScmManagerGitRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository (such as https://scm-manager.org/scm/repo/namespace/name).
Type:String
$class: 'Stash'
-
repoUrl
-
Specify the HTTP URL for this repository’s Stash page (such as http://stash.mydomain.com:7990/projects/PROJECT/repos/REPO/).
Type:String
$class: 'TFS2013GitRepositoryBrowser'
-
repoUrl
-
Either the name of the remote whose URL should be used, or the URL of this
module in TFS (such as http://fisheye6.cenqua.com/tfs/PROJECT/_git/REPO/).
If empty (default), the URL of the «origin» repository is used.If TFS is also used as the repository server, this can usually be left blank.
Type:String
$class: 'ViewGitWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as http://code.fealdia.org/viewgit/).
Type:String
projectName
-
Specify the name of the project in ViewGit (e.g. scripts, scuttle etc. from http://code.fealdia.org/viewgit/).
Type:String
$class: 'GitLFSPullTrait'
-
$class: 'GitToolSCMSourceTrait'
-
gitTool
-
Type:String
gitHubIgnoreDraftPullRequestFilter
-
$class: 'IgnoreOnPushNotificationTrait'
-
$class: 'LocalBranchTrait'
-
$class: 'MercurialBrowserSCMSourceTrait'
-
browser
-
- Nested choice of objects
-
$class: 'FishEye'
-
url
-
Specify the root URL serving this repository, such as: http://www.example.org/browse/hg/
Type:String
$class: 'GoogleCode'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'HgWeb'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'Kallithea'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'KilnHG'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'RhodeCode'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'RhodeCodeLegacy'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'ScmManager'
-
url
-
Specify the root URL serving this repository (such as
http://YOURSCMMANAGER/scm/repo/NAMESPACE/NAME/
).Type:String
$class: 'MercurialInstallationSCMSourceTrait'
-
installation
-
Type:String
$class: 'PruneStaleBranchTrait'
-
$class: 'PruneStaleTagTrait'
-
bitbucketPublicRepoPullRequestFilter
-
If the repository being scanned is a public repository, this behaviour will exclude all pull requests.
(Note: This behaviour is not especially useful if scanning a single repository as you could just not include the
pull request discovery behaviours in the first place) $class: 'PullRequestDiscoveryTrait'
-
excludeBranchesWithPRs
-
Exclude branches for which there is an open pull request
Type:boolean
$class: 'RefSpecsSCMSourceTrait'
-
templates
-
Array/List:
- Nested object
-
value
-
A ref spec to fetch. Any occurrences of
@{remote}
will be replaced by the remote name
(which defaults toorigin
) before use.Type:String
headRegexFilter
-
regex
-
A Java regular expression to
restrict the names. Names that do not match the supplied regular expression will be ignored.
NOTE: this filter will be applied to all branch like things, including change requestsType:String
$class: 'RemoteNameSCMSourceTrait'
-
remoteName
-
Type:String
$class: 'SparseCheckoutPathsTrait'
-
extension
-
- Nested object
-
Specify the paths that you’d like to sparse checkout. This may be used for saving space (Think about a reference repository).
Be sure to use a recent version of Git, at least above 1.7.10sparseCheckoutPaths
-
Array/List:
- Nested object
-
path
-
Type:String
$class: 'SubmoduleOptionTrait'
-
extension
-
- Nested object
-
disableSubmodules
-
By disabling support for submodules you can still keep using basic
git plugin functionality and just have Jenkins to ignore submodules
completely as if they didn’t exist.Type:boolean
recursiveSubmodules
-
Retrieve all submodules recursively
(uses ‘—recursive’ option which requires git>=1.6.5)
Type:boolean
trackingSubmodules
-
Retrieve the tip of the configured branch in .gitmodules
(Uses ‘—remote’ option which requires git>=1.8.2)
Type:boolean
reference
-
Specify a folder containing a repository that will be used by Git as a reference during clone operations.
This option will be ignored if the folder is not available on the controller or agent where the clone is being executed.
To prepare a reference folder with multiple subprojects, create a bare git repository and add all the remote urls then perform a fetch:git init --bare git remote add SubProject1 https://gitrepo.com/subproject1 git remote add SubProject2 https://gitrepo.com/subproject2 git fetch --all
Type:String
timeout
-
Specify a timeout (in minutes) for submodules operations.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
parentCredentials
-
Use credentials from the default remote of the parent project.
Type:boolean
depth
(optional)-
Set shallow clone depth, so that git will only download recent history of the project,
saving time and disk space when you just want to access the latest commits of a repository.Type:int
shallow
(optional)-
Perform shallow clone, so that git will not download the history of the project,
saving time and disk space when you just want to access the latest version of a repository.Type:boolean
threads
(optional)-
Specify the number of threads that will be used to update submodules.
If unspecified, the command line git default thread count is used.Type:int
$class: 'UserIdentityTrait'
-
extension
-
- Nested object
-
name
-
If given, «GIT_COMMITTER_NAME=[this]» and «GIT_AUTHOR_NAME=[this]» are set for builds. This overrides whatever is in the global settings.
Type:String
email
-
If given, «GIT_COMMITTER_EMAIL=[this]» and «GIT_AUTHOR_EMAIL=[this]» are set for builds. This overrides whatever is in the global settings.
Type:String
bitbucketWebhookConfiguration
-
Sets the value for committersToIgnore in the Bitbucket Webhook. Value should be a comma separated string.
committerToIgnore is used to prevent triggering Jenkins builds when commits by certain users
are made.committersToIgnore
-
Type:String
bitbucketWebhookRegistration
-
Overrides the defaults for webhook management.
Webhooks are used to inform Jenkins about changes to repositories. There are two ways webhooks can be
configured:- Manual webhook configuration requires the user to configure Bitbucket with the Jenkins URL in order
to ensure that Bitbucket will send the events to Jenkins after every change. - Automatic webhook configuration requires that Jenkins has credentials with sufficient permission to
configure webhooks and also that Jenkins knows the URL that Bitbucket can connect to.
The Manage Jenkins » Configure Jenkins › Bitbucket Endpoints allows defining the list of
servers. Each server
can be associated with credentials. If credentials are defined then the default behaviour is to use those
credentials to automatically manage the webhooks of all repositories that Jenkins is interested in. If no
credentials are defined then the default behaviour is to require the user to manually configure webhooks.mode
-
There are two available modes:
- Disable hook management
- Disables hook management irrespective of the global defaults.
- Use item credentials for hook management
- Enabled hook management but uses the selected credentials to manage the hooks rather than those defined in
Manage Jenkins » Configure Jenkins › Bitbucket Endpoints
Type:String
- Manual webhook configuration requires the user to configure Bitbucket with the Jenkins URL in order
headWildcardFilter
-
includes
-
Space-separated list of name patterns to consider.
You may use*
as a wildcard; for example:master release*
NOTE: this filter will be applied to all branch like things, including change requestsType:String
excludes
-
Space-separated list of name patterns to ignore even if matched by the includes list.
For example:release alpha-* beta-*
NOTE: this filter will be applied to all branch like things, including change requestsType:String
$class: 'WipeWorkspaceTrait'
-
bitbucketBranchDiscovery
-
Discovers branches on the repository.
strategyId
-
Determines which branches are discovered.
- Exclude branches that are also filed as PRs
-
If you are discovering origin pull requests, it may not make sense to discover the same changes both as a
pull request and as a branch. - Only branches that are also filed as PRs
-
Discovers branches that have PR’s associated with them. This may make sense if you have a
notification sent to the team at the end of a triggered build or limited Jenkins resources. - All branches
-
Ignores whether the branch is also filed as a pull request and instead discovers all branches on the
origin repository.
Type:int
bitbucketForkDiscovery
-
Discovers pull requests where the origin repository is a fork of the target repository.
strategyId
-
Determines how pull requests are discovered.
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging
Type:int
trust
-
One of the great powers of pull requests is that anyone with read access to a repository can fork it, commit
some changes to their fork and then create a pull request against the original repository with their changes.
There are some files stored in source control that are important. For example, aJenkinsfile
may contain configuration details to sandbox pull requests in order to mitigate against malicious pull requests.
In order to protect against a malicious pull request itself modifying theJenkinsfile
to remove
the protections, you can define the trust policy for pull requests from forks.Other plugins can extend the available trust policies. The default policies are:
- Nobody
-
Pull requests from forks will all be treated as untrusted. This means that where Jenkins requires a
trusted file (e.g.Jenkinsfile
) the contents of that file will be retrieved from the
target branch on the origin repository and not from the pull request branch on the fork repository. - Forks in the same account
-
Bitbucket allows for a repository to be forked into a «sibling» repository in the same account but using
a different name. This strategy will trust any pull requests from forks that are in the same account as
the target repository on the basis that users have to have been granted write permission to account in
order create such a fork. - Everyone
-
All pull requests from forks will be treated as trusted. NOTE: this option can be dangerous
if used on a public repository hosted on Bitbucket Cloud.
java.lang.UnsupportedOperationException: do not know how to categorize attributes of type jenkins.scm.api.trait.SCMHeadAuthority<? super com.cloudbees.jenkins.plugins.bitbucket.BitbucketSCMSourceRequest, ? extends jenkins.scm.api.mixin.ChangeRequestSCMHead2, ? extends jenkins.scm.api.SCMRevision>
bitbucketPullRequestDiscovery
-
Discovers pull requests where the origin repository is the same as the target repository.
strategyId
-
Determines how pull requests are discovered.
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging
Type:int
bitbucketSshCheckout
-
By default the discovered branches / pull requests will all use the same credentials
that were used for discovery when checking out sources. This means that the checkout will be using the
https://
protocol for the Git repository.This behaviour allows you to select the SSH private key to be used for checking out sources, which will
consequently force the checkout to use thessh://
protocol.credentialsId
-
Credentials used to check out sources.
It must be a SSH key based credential.
Type:String
bitbucketTagDiscovery
-
Discovers tags on the repository.
$class: 'com.cloudogu.scmmanager.scm.BranchDiscoveryTrait'
-
$class: 'com.cloudogu.scmmanager.scm.TagDiscoveryTrait'
-
gitBranchDiscovery
-
Discovers branches on the repository.
gitTagDiscovery
-
Discovers tags on the repository.
gitHubBranchDiscovery
-
Discovers branches on the repository.
strategyId
-
Determines which branches are discovered.
- Exclude branches that are also filed as PRs
-
If you are discovering origin pull requests, you may not want to also build the source branches
for those pull requests. - Only branches that are also filed as PRs
-
Similar to discovering origin pull requests, but discovers the branch rather than the pull request.
This meansenv.GIT_BRANCH
will be set to the branch name rather thanPR-#
.
Also, status notifications for these builds will only be applied to the commit and not to the pull request. - All branches
-
Ignores whether the branch is also filed as a pull request and instead discovers all branches on the
origin repository.
Type:int
gitHubForkDiscovery
-
Discovers pull requests where the origin repository is a fork of the target repository.
strategyId
-
Determines how pull requests are discovered:
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch. - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging. - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging.
Type:int
trust
-
One of the great powers of pull requests is that anyone with read access to a repository can fork it, commit
some changes to their fork and then create a pull request against the original repository with their changes.
There are some files stored in source control that are important. For example, aJenkinsfile
may contain configuration details to sandbox pull requests in order to mitigate against malicious pull requests.
In order to protect against a malicious pull request itself modifying theJenkinsfile
to remove
the protections, you can define the trust policy for pull requests from forks.Other plugins can extend the available trust policies. The default policies are:
- Nobody
-
Pull requests from forks will all be treated as untrusted. This means that where Jenkins requires a
trusted file (e.g.Jenkinsfile
) the contents of that file will be retrieved from the
target branch on the origin repository and not from the pull request branch on the fork repository. - Collaborators
-
Pull requests from collaborators
to the origin repository will be treated as trusted, all other pull requests from fork repositories
will be treated as untrusted.
Note that if credentials used by Jenkins for scanning the repository does not have permission to
query the list of collaborators to the origin repository then only the origin account will be treated
as trusted — i.e. this will fall back toNobody
.
NOTE: all collaborators are trusted, even if they are only members of a team with read permission. - Everyone
-
All pull requests from forks will be treated as trusted. NOTE: this option can be dangerous
if used on a public repository hosted on GitHub. - From users with Admin or Write permission
-
Pull requests forks will be treated as trusted if and only if the fork owner has either Admin or Write
permissions on the origin repository.
This is the recommended policy.
Note that this strategy requires the
Review
a user’s permission level API, as a result on GitHub Enterprise Server versions before 2.12 this
is the same as trusting Nobody.
java.lang.UnsupportedOperationException: do not know how to categorize attributes of type jenkins.scm.api.trait.SCMHeadAuthority<? super org.jenkinsci.plugins.github_branch_source.GitHubSCMSourceRequest, ? extends jenkins.scm.api.mixin.ChangeRequestSCMHead2, ? extends jenkins.scm.api.SCMRevision>
gitHubPullRequestDiscovery
-
Discovers pull requests where the origin repository is the same as the target repository.
strategyId
-
Determines how pull requests are discovered:
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch. - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging. - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging.
Type:int
gitHubSshCheckout
-
By default the discovered branches / pull requests will all use the same username / password credentials
that were used for discovery when checking out sources. This means that the checkout will be using the
https://
protocol for the Git repository.This behaviour allows you to select the SSH private key to be used for checking out sources, which will
consequently force the checkout to use thessh://
protocol.credentialsId
-
Credentials used to check out sources. Must be a SSH key based credential.
Type:String
gitHubTagDiscovery
-
Discovers tags on the repository.
$class: 'MercurialSCMSource'
-
source
-
Specify the repository to track. This can be URL or a local file path.
If you are specifying HTTP credentials, do not include a username in the URL.Type:String
credentialsId
(optional)-
Optional credentials to use when cloning or pulling from the remote repository.
Supports username/password with HTTP(S) URLs, and SSH private key with SSH URLs.Type:String
id
(optional)-
Type:String
traits
(optional)-
Array/List:
- Nested choice of objects
-
$class: 'AuthorInChangelogTrait'
-
bitbucketBuildStatusNotifications
-
Configure the Bitbucket notifications.
disableNotificationForNotBuildJobs
(optional)-
Type:boolean
sendSuccessNotificationForUnstableBuild
(optional)-
Type:boolean
$class: 'CheckoutOptionTrait'
-
extension
-
- Nested object
-
timeout
-
Specify a timeout (in minutes) for checkout.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
$class: 'CleanAfterCheckoutTrait'
-
extension
-
- Nested object
-
Clean up the workspace after every checkout by deleting all untracked files and directories,
including those which are specified in.gitignore
.
It also resets all tracked files to their versioned state.
This ensures that the workspace is
in the same state as if you cloned and checked out in a brand-new empty directory, and ensures
that your build is not affected by the files generated by the previous build.deleteUntrackedNestedRepositories
(optional)-
Deletes untracked submodules and any other subdirectories which contain
.git
directories.Type:boolean
$class: 'CleanBeforeCheckoutTrait'
-
extension
-
- Nested object
-
Clean up the workspace before every checkout by deleting all untracked files and directories,
including those which are specified in.gitignore
.
It also resets all tracked files to their versioned state.
This ensures that the workspace is
in the same state as if you cloned and checked out in a brand-new empty directory, and ensures
that your build is not affected by the files generated by the previous build.deleteUntrackedNestedRepositories
(optional)-
Deletes untracked submodules and any other subdirectories which contain
.git
directories.Type:boolean
$class: 'CleanMercurialSCMSourceTrait'
-
When this behaviour is present, each build will wipe any local modifications
or untracked files in the repository checkout.
This is often a convenient way to ensure that a build is not
using any artifacts from earlier builds. $class: 'CloneOptionTrait'
-
extension
-
- Nested object
-
shallow
-
Perform shallow clone, so that git will not download the history of the project,
saving time and disk space when you just want to access the latest version of a repository.Type:boolean
noTags
-
Deselect this to perform a clone without tags, saving time and disk space when you just want to access
what is specified by the refspec.Type:boolean
reference
-
Specify a folder containing a repository that will be used by Git as a reference during clone operations.
This option will be ignored if the folder is not available on the controller or agent where the clone is being executed.Type:String
timeout
-
Specify a timeout (in minutes) for clone and fetch operations.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
depth
(optional)-
Set shallow clone depth, so that git will only download recent history of the project,
saving time and disk space when you just want to access the latest commits of a repository.Type:int
honorRefspec
(optional)-
Perform initial clone using the refspec defined for the repository.
This can save time, data transfer and disk space when you only need
to access the references specified by the refspec.Type:boolean
$class: 'DiscoverOtherRefsTrait'
-
Discovers other specified refs on the repository.
ref
-
The pattern under /refs on the remote repository to discover, can contain a wildcard.
Example: test/*/mergedType:String
nameMapping
(optional)-
Mapping for how the ref can be named in for example the
@Library
.
Example: test-@{1}
Where @{1} replaces the first wildcard in the ref when discovered.By default it will be «namespace_before_wildcard-@{1}». E.g. if ref is «test/*/merged» the default mapping would be
«test-@{1}».Type:String
$class: 'GitBrowserSCMSourceTrait'
-
browser
-
- Nested choice of objects
-
$class: 'AssemblaWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://www.assembla.com/code/PROJECT/git/).
Type:String
bitbucketServer
-
repoUrl
-
Specify the Bitbucket Server root URL for this repository (such as https://bitbucket:7990/OWNER/REPO/).
Type:String
$class: 'BitbucketWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://bitbucket.org/OWNER/REPO/).
Type:String
$class: 'CGit'
-
repoUrl
-
Specify the root URL serving this repository (such as http://cgit.example.com:port/group/REPO/).
Type:String
$class: 'FisheyeGitRepositoryBrowser'
-
repoUrl
-
Specify the URL of this repository in FishEye (such as http://fisheye6.cenqua.com/browse/ant/).
Type:String
$class: 'GitBlitRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository.
Type:String
projectName
-
Specify the name of the project in GitBlit.
Type:String
$class: 'GitLab'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gitlabserver:port/group/REPO/).
Type:String
version
(optional)-
Specify the major and minor version of GitLab you use (such as 9.1). If you
don’t specify a version, a modern version of GitLab (>= 8.0) is assumed.Type:String
$class: 'GitList'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gitlistserver:port/REPO/).
Type:String
$class: 'GitWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://github.com/jenkinsci/jenkins.git).
Type:String
$class: 'GithubWeb'
-
repoUrl
-
Specify the HTTP URL for this repository’s GitHub page (such as https://github.com/jquery/jquery).
Type:String
$class: 'Gitiles'
-
repoUrl
-
Specify the root URL serving this repository (such as https://gwt.googlesource.com/gwt/).
Type:String
$class: 'GitoriousWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://gitorious.org/gitorious/mainline).
Type:String
$class: 'GogsGit'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gogs.example.com:port/username/some-repo-url.git).
Type:String
$class: 'KilnGit'
-
repoUrl
-
Specify the root URL serving this repository (such as https://khanacademy.kilnhg.com/Code/Website/Group/webapp).
Type:String
$class: 'Phabricator'
-
repoUrl
-
Specify the phabricator instance root URL (such as http://phabricator.example.com).
Type:String
repo
-
Specify the repository name in phabricator (such as the foo part of phabricator.example.com/diffusion/foo/browse).
Type:String
$class: 'RedmineWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as http://SERVER/PATH/projects/PROJECT/repository).
Type:String
$class: 'RhodeCode'
-
repoUrl
-
Specify the HTTP URL for this repository’s RhodeCode page (such as http://rhodecode.mydomain.com:5000/projects/PROJECT/repos/REPO/).
Type:String
$class: 'ScmManagerGitRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository (such as https://scm-manager.org/scm/repo/namespace/name).
Type:String
$class: 'Stash'
-
repoUrl
-
Specify the HTTP URL for this repository’s Stash page (such as http://stash.mydomain.com:7990/projects/PROJECT/repos/REPO/).
Type:String
$class: 'TFS2013GitRepositoryBrowser'
-
repoUrl
-
Either the name of the remote whose URL should be used, or the URL of this
module in TFS (such as http://fisheye6.cenqua.com/tfs/PROJECT/_git/REPO/).
If empty (default), the URL of the «origin» repository is used.If TFS is also used as the repository server, this can usually be left blank.
Type:String
$class: 'ViewGitWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as http://code.fealdia.org/viewgit/).
Type:String
projectName
-
Specify the name of the project in ViewGit (e.g. scripts, scuttle etc. from http://code.fealdia.org/viewgit/).
Type:String
$class: 'GitLFSPullTrait'
-
$class: 'GitToolSCMSourceTrait'
-
gitTool
-
Type:String
gitHubIgnoreDraftPullRequestFilter
-
$class: 'IgnoreOnPushNotificationTrait'
-
$class: 'LocalBranchTrait'
-
$class: 'MercurialBrowserSCMSourceTrait'
-
browser
-
- Nested choice of objects
-
$class: 'FishEye'
-
url
-
Specify the root URL serving this repository, such as: http://www.example.org/browse/hg/
Type:String
$class: 'GoogleCode'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'HgWeb'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'Kallithea'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'KilnHG'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'RhodeCode'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'RhodeCodeLegacy'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'ScmManager'
-
url
-
Specify the root URL serving this repository (such as
http://YOURSCMMANAGER/scm/repo/NAMESPACE/NAME/
).Type:String
$class: 'MercurialInstallationSCMSourceTrait'
-
installation
-
Type:String
$class: 'PruneStaleBranchTrait'
-
$class: 'PruneStaleTagTrait'
-
bitbucketPublicRepoPullRequestFilter
-
If the repository being scanned is a public repository, this behaviour will exclude all pull requests.
(Note: This behaviour is not especially useful if scanning a single repository as you could just not include the
pull request discovery behaviours in the first place) $class: 'PullRequestDiscoveryTrait'
-
excludeBranchesWithPRs
-
Exclude branches for which there is an open pull request
Type:boolean
$class: 'RefSpecsSCMSourceTrait'
-
templates
-
Array/List:
- Nested object
-
value
-
A ref spec to fetch. Any occurrences of
@{remote}
will be replaced by the remote name
(which defaults toorigin
) before use.Type:String
headRegexFilter
-
regex
-
A Java regular expression to
restrict the names. Names that do not match the supplied regular expression will be ignored.
NOTE: this filter will be applied to all branch like things, including change requestsType:String
$class: 'RemoteNameSCMSourceTrait'
-
remoteName
-
Type:String
$class: 'SparseCheckoutPathsTrait'
-
extension
-
- Nested object
-
Specify the paths that you’d like to sparse checkout. This may be used for saving space (Think about a reference repository).
Be sure to use a recent version of Git, at least above 1.7.10sparseCheckoutPaths
-
Array/List:
- Nested object
-
path
-
Type:String
$class: 'SubmoduleOptionTrait'
-
extension
-
- Nested object
-
disableSubmodules
-
By disabling support for submodules you can still keep using basic
git plugin functionality and just have Jenkins to ignore submodules
completely as if they didn’t exist.Type:boolean
recursiveSubmodules
-
Retrieve all submodules recursively
(uses ‘—recursive’ option which requires git>=1.6.5)
Type:boolean
trackingSubmodules
-
Retrieve the tip of the configured branch in .gitmodules
(Uses ‘—remote’ option which requires git>=1.8.2)
Type:boolean
reference
-
Specify a folder containing a repository that will be used by Git as a reference during clone operations.
This option will be ignored if the folder is not available on the controller or agent where the clone is being executed.
To prepare a reference folder with multiple subprojects, create a bare git repository and add all the remote urls then perform a fetch:git init --bare git remote add SubProject1 https://gitrepo.com/subproject1 git remote add SubProject2 https://gitrepo.com/subproject2 git fetch --all
Type:String
timeout
-
Specify a timeout (in minutes) for submodules operations.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
parentCredentials
-
Use credentials from the default remote of the parent project.
Type:boolean
depth
(optional)-
Set shallow clone depth, so that git will only download recent history of the project,
saving time and disk space when you just want to access the latest commits of a repository.Type:int
shallow
(optional)-
Perform shallow clone, so that git will not download the history of the project,
saving time and disk space when you just want to access the latest version of a repository.Type:boolean
threads
(optional)-
Specify the number of threads that will be used to update submodules.
If unspecified, the command line git default thread count is used.Type:int
$class: 'UserIdentityTrait'
-
extension
-
- Nested object
-
name
-
If given, «GIT_COMMITTER_NAME=[this]» and «GIT_AUTHOR_NAME=[this]» are set for builds. This overrides whatever is in the global settings.
Type:String
email
-
If given, «GIT_COMMITTER_EMAIL=[this]» and «GIT_AUTHOR_EMAIL=[this]» are set for builds. This overrides whatever is in the global settings.
Type:String
bitbucketWebhookConfiguration
-
Sets the value for committersToIgnore in the Bitbucket Webhook. Value should be a comma separated string.
committerToIgnore is used to prevent triggering Jenkins builds when commits by certain users
are made.committersToIgnore
-
Type:String
bitbucketWebhookRegistration
-
Overrides the defaults for webhook management.
Webhooks are used to inform Jenkins about changes to repositories. There are two ways webhooks can be
configured:- Manual webhook configuration requires the user to configure Bitbucket with the Jenkins URL in order
to ensure that Bitbucket will send the events to Jenkins after every change. - Automatic webhook configuration requires that Jenkins has credentials with sufficient permission to
configure webhooks and also that Jenkins knows the URL that Bitbucket can connect to.
The Manage Jenkins » Configure Jenkins › Bitbucket Endpoints allows defining the list of
servers. Each server
can be associated with credentials. If credentials are defined then the default behaviour is to use those
credentials to automatically manage the webhooks of all repositories that Jenkins is interested in. If no
credentials are defined then the default behaviour is to require the user to manually configure webhooks.mode
-
There are two available modes:
- Disable hook management
- Disables hook management irrespective of the global defaults.
- Use item credentials for hook management
- Enabled hook management but uses the selected credentials to manage the hooks rather than those defined in
Manage Jenkins » Configure Jenkins › Bitbucket Endpoints
Type:String
- Manual webhook configuration requires the user to configure Bitbucket with the Jenkins URL in order
headWildcardFilter
-
includes
-
Space-separated list of name patterns to consider.
You may use*
as a wildcard; for example:master release*
NOTE: this filter will be applied to all branch like things, including change requestsType:String
excludes
-
Space-separated list of name patterns to ignore even if matched by the includes list.
For example:release alpha-* beta-*
NOTE: this filter will be applied to all branch like things, including change requestsType:String
$class: 'WipeWorkspaceTrait'
-
bitbucketBranchDiscovery
-
Discovers branches on the repository.
strategyId
-
Determines which branches are discovered.
- Exclude branches that are also filed as PRs
-
If you are discovering origin pull requests, it may not make sense to discover the same changes both as a
pull request and as a branch. - Only branches that are also filed as PRs
-
Discovers branches that have PR’s associated with them. This may make sense if you have a
notification sent to the team at the end of a triggered build or limited Jenkins resources. - All branches
-
Ignores whether the branch is also filed as a pull request and instead discovers all branches on the
origin repository.
Type:int
bitbucketForkDiscovery
-
Discovers pull requests where the origin repository is a fork of the target repository.
strategyId
-
Determines how pull requests are discovered.
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging
Type:int
trust
-
One of the great powers of pull requests is that anyone with read access to a repository can fork it, commit
some changes to their fork and then create a pull request against the original repository with their changes.
There are some files stored in source control that are important. For example, aJenkinsfile
may contain configuration details to sandbox pull requests in order to mitigate against malicious pull requests.
In order to protect against a malicious pull request itself modifying theJenkinsfile
to remove
the protections, you can define the trust policy for pull requests from forks.Other plugins can extend the available trust policies. The default policies are:
- Nobody
-
Pull requests from forks will all be treated as untrusted. This means that where Jenkins requires a
trusted file (e.g.Jenkinsfile
) the contents of that file will be retrieved from the
target branch on the origin repository and not from the pull request branch on the fork repository. - Forks in the same account
-
Bitbucket allows for a repository to be forked into a «sibling» repository in the same account but using
a different name. This strategy will trust any pull requests from forks that are in the same account as
the target repository on the basis that users have to have been granted write permission to account in
order create such a fork. - Everyone
-
All pull requests from forks will be treated as trusted. NOTE: this option can be dangerous
if used on a public repository hosted on Bitbucket Cloud.
java.lang.UnsupportedOperationException: do not know how to categorize attributes of type jenkins.scm.api.trait.SCMHeadAuthority<? super com.cloudbees.jenkins.plugins.bitbucket.BitbucketSCMSourceRequest, ? extends jenkins.scm.api.mixin.ChangeRequestSCMHead2, ? extends jenkins.scm.api.SCMRevision>
bitbucketPullRequestDiscovery
-
Discovers pull requests where the origin repository is the same as the target repository.
strategyId
-
Determines how pull requests are discovered.
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging
Type:int
bitbucketSshCheckout
-
By default the discovered branches / pull requests will all use the same credentials
that were used for discovery when checking out sources. This means that the checkout will be using the
https://
protocol for the Git repository.This behaviour allows you to select the SSH private key to be used for checking out sources, which will
consequently force the checkout to use thessh://
protocol.credentialsId
-
Credentials used to check out sources.
It must be a SSH key based credential.
Type:String
bitbucketTagDiscovery
-
Discovers tags on the repository.
$class: 'com.cloudogu.scmmanager.scm.BranchDiscoveryTrait'
-
$class: 'com.cloudogu.scmmanager.scm.TagDiscoveryTrait'
-
gitBranchDiscovery
-
Discovers branches on the repository.
gitTagDiscovery
-
Discovers tags on the repository.
gitHubBranchDiscovery
-
Discovers branches on the repository.
strategyId
-
Determines which branches are discovered.
- Exclude branches that are also filed as PRs
-
If you are discovering origin pull requests, you may not want to also build the source branches
for those pull requests. - Only branches that are also filed as PRs
-
Similar to discovering origin pull requests, but discovers the branch rather than the pull request.
This meansenv.GIT_BRANCH
will be set to the branch name rather thanPR-#
.
Also, status notifications for these builds will only be applied to the commit and not to the pull request. - All branches
-
Ignores whether the branch is also filed as a pull request and instead discovers all branches on the
origin repository.
Type:int
gitHubForkDiscovery
-
Discovers pull requests where the origin repository is a fork of the target repository.
strategyId
-
Determines how pull requests are discovered:
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch. - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging. - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging.
Type:int
trust
-
One of the great powers of pull requests is that anyone with read access to a repository can fork it, commit
some changes to their fork and then create a pull request against the original repository with their changes.
There are some files stored in source control that are important. For example, aJenkinsfile
may contain configuration details to sandbox pull requests in order to mitigate against malicious pull requests.
In order to protect against a malicious pull request itself modifying theJenkinsfile
to remove
the protections, you can define the trust policy for pull requests from forks.Other plugins can extend the available trust policies. The default policies are:
- Nobody
-
Pull requests from forks will all be treated as untrusted. This means that where Jenkins requires a
trusted file (e.g.Jenkinsfile
) the contents of that file will be retrieved from the
target branch on the origin repository and not from the pull request branch on the fork repository. - Collaborators
-
Pull requests from collaborators
to the origin repository will be treated as trusted, all other pull requests from fork repositories
will be treated as untrusted.
Note that if credentials used by Jenkins for scanning the repository does not have permission to
query the list of collaborators to the origin repository then only the origin account will be treated
as trusted — i.e. this will fall back toNobody
.
NOTE: all collaborators are trusted, even if they are only members of a team with read permission. - Everyone
-
All pull requests from forks will be treated as trusted. NOTE: this option can be dangerous
if used on a public repository hosted on GitHub. - From users with Admin or Write permission
-
Pull requests forks will be treated as trusted if and only if the fork owner has either Admin or Write
permissions on the origin repository.
This is the recommended policy.
Note that this strategy requires the
Review
a user’s permission level API, as a result on GitHub Enterprise Server versions before 2.12 this
is the same as trusting Nobody.
java.lang.UnsupportedOperationException: do not know how to categorize attributes of type jenkins.scm.api.trait.SCMHeadAuthority<? super org.jenkinsci.plugins.github_branch_source.GitHubSCMSourceRequest, ? extends jenkins.scm.api.mixin.ChangeRequestSCMHead2, ? extends jenkins.scm.api.SCMRevision>
gitHubPullRequestDiscovery
-
Discovers pull requests where the origin repository is the same as the target repository.
strategyId
-
Determines how pull requests are discovered:
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch. - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging. - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging.
Type:int
gitHubSshCheckout
-
By default the discovered branches / pull requests will all use the same username / password credentials
that were used for discovery when checking out sources. This means that the checkout will be using the
https://
protocol for the Git repository.This behaviour allows you to select the SSH private key to be used for checking out sources, which will
consequently force the checkout to use thessh://
protocol.credentialsId
-
Credentials used to check out sources. Must be a SSH key based credential.
Type:String
gitHubTagDiscovery
-
Discovers tags on the repository.
scmManager
-
serverUrl
-
Specify the root URL of the SCM-Manager instance including the context path (such as https://scm-manager.org/scm/)
or an ssh URL (such as ssh://scm-manager.com:2222/; this requires the
SSH plugin in SCM-Manager).Type:String
repository
-
Select an existing repository from the SCM-Manager instance.
Type:String
credentialsId
-
Select valid credentials for the specified SCM-Manager instance.
Type:String
id
(optional)-
Type:String
traits
(optional)-
Array/List:
- Nested choice of objects
-
$class: 'AuthorInChangelogTrait'
-
bitbucketBuildStatusNotifications
-
Configure the Bitbucket notifications.
disableNotificationForNotBuildJobs
(optional)-
Type:boolean
sendSuccessNotificationForUnstableBuild
(optional)-
Type:boolean
$class: 'CheckoutOptionTrait'
-
extension
-
- Nested object
-
timeout
-
Specify a timeout (in minutes) for checkout.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
$class: 'CleanAfterCheckoutTrait'
-
extension
-
- Nested object
-
Clean up the workspace after every checkout by deleting all untracked files and directories,
including those which are specified in.gitignore
.
It also resets all tracked files to their versioned state.
This ensures that the workspace is
in the same state as if you cloned and checked out in a brand-new empty directory, and ensures
that your build is not affected by the files generated by the previous build.deleteUntrackedNestedRepositories
(optional)-
Deletes untracked submodules and any other subdirectories which contain
.git
directories.Type:boolean
$class: 'CleanBeforeCheckoutTrait'
-
extension
-
- Nested object
-
Clean up the workspace before every checkout by deleting all untracked files and directories,
including those which are specified in.gitignore
.
It also resets all tracked files to their versioned state.
This ensures that the workspace is
in the same state as if you cloned and checked out in a brand-new empty directory, and ensures
that your build is not affected by the files generated by the previous build.deleteUntrackedNestedRepositories
(optional)-
Deletes untracked submodules and any other subdirectories which contain
.git
directories.Type:boolean
$class: 'CleanMercurialSCMSourceTrait'
-
When this behaviour is present, each build will wipe any local modifications
or untracked files in the repository checkout.
This is often a convenient way to ensure that a build is not
using any artifacts from earlier builds. $class: 'CloneOptionTrait'
-
extension
-
- Nested object
-
shallow
-
Perform shallow clone, so that git will not download the history of the project,
saving time and disk space when you just want to access the latest version of a repository.Type:boolean
noTags
-
Deselect this to perform a clone without tags, saving time and disk space when you just want to access
what is specified by the refspec.Type:boolean
reference
-
Specify a folder containing a repository that will be used by Git as a reference during clone operations.
This option will be ignored if the folder is not available on the controller or agent where the clone is being executed.Type:String
timeout
-
Specify a timeout (in minutes) for clone and fetch operations.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
depth
(optional)-
Set shallow clone depth, so that git will only download recent history of the project,
saving time and disk space when you just want to access the latest commits of a repository.Type:int
honorRefspec
(optional)-
Perform initial clone using the refspec defined for the repository.
This can save time, data transfer and disk space when you only need
to access the references specified by the refspec.Type:boolean
$class: 'DiscoverOtherRefsTrait'
-
Discovers other specified refs on the repository.
ref
-
The pattern under /refs on the remote repository to discover, can contain a wildcard.
Example: test/*/mergedType:String
nameMapping
(optional)-
Mapping for how the ref can be named in for example the
@Library
.
Example: test-@{1}
Where @{1} replaces the first wildcard in the ref when discovered.By default it will be «namespace_before_wildcard-@{1}». E.g. if ref is «test/*/merged» the default mapping would be
«test-@{1}».Type:String
$class: 'GitBrowserSCMSourceTrait'
-
browser
-
- Nested choice of objects
-
$class: 'AssemblaWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://www.assembla.com/code/PROJECT/git/).
Type:String
bitbucketServer
-
repoUrl
-
Specify the Bitbucket Server root URL for this repository (such as https://bitbucket:7990/OWNER/REPO/).
Type:String
$class: 'BitbucketWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://bitbucket.org/OWNER/REPO/).
Type:String
$class: 'CGit'
-
repoUrl
-
Specify the root URL serving this repository (such as http://cgit.example.com:port/group/REPO/).
Type:String
$class: 'FisheyeGitRepositoryBrowser'
-
repoUrl
-
Specify the URL of this repository in FishEye (such as http://fisheye6.cenqua.com/browse/ant/).
Type:String
$class: 'GitBlitRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository.
Type:String
projectName
-
Specify the name of the project in GitBlit.
Type:String
$class: 'GitLab'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gitlabserver:port/group/REPO/).
Type:String
version
(optional)-
Specify the major and minor version of GitLab you use (such as 9.1). If you
don’t specify a version, a modern version of GitLab (>= 8.0) is assumed.Type:String
$class: 'GitList'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gitlistserver:port/REPO/).
Type:String
$class: 'GitWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://github.com/jenkinsci/jenkins.git).
Type:String
$class: 'GithubWeb'
-
repoUrl
-
Specify the HTTP URL for this repository’s GitHub page (such as https://github.com/jquery/jquery).
Type:String
$class: 'Gitiles'
-
repoUrl
-
Specify the root URL serving this repository (such as https://gwt.googlesource.com/gwt/).
Type:String
$class: 'GitoriousWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://gitorious.org/gitorious/mainline).
Type:String
$class: 'GogsGit'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gogs.example.com:port/username/some-repo-url.git).
Type:String
$class: 'KilnGit'
-
repoUrl
-
Specify the root URL serving this repository (such as https://khanacademy.kilnhg.com/Code/Website/Group/webapp).
Type:String
$class: 'Phabricator'
-
repoUrl
-
Specify the phabricator instance root URL (such as http://phabricator.example.com).
Type:String
repo
-
Specify the repository name in phabricator (such as the foo part of phabricator.example.com/diffusion/foo/browse).
Type:String
$class: 'RedmineWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as http://SERVER/PATH/projects/PROJECT/repository).
Type:String
$class: 'RhodeCode'
-
repoUrl
-
Specify the HTTP URL for this repository’s RhodeCode page (such as http://rhodecode.mydomain.com:5000/projects/PROJECT/repos/REPO/).
Type:String
$class: 'ScmManagerGitRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository (such as https://scm-manager.org/scm/repo/namespace/name).
Type:String
$class: 'Stash'
-
repoUrl
-
Specify the HTTP URL for this repository’s Stash page (such as http://stash.mydomain.com:7990/projects/PROJECT/repos/REPO/).
Type:String
$class: 'TFS2013GitRepositoryBrowser'
-
repoUrl
-
Either the name of the remote whose URL should be used, or the URL of this
module in TFS (such as http://fisheye6.cenqua.com/tfs/PROJECT/_git/REPO/).
If empty (default), the URL of the «origin» repository is used.If TFS is also used as the repository server, this can usually be left blank.
Type:String
$class: 'ViewGitWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as http://code.fealdia.org/viewgit/).
Type:String
projectName
-
Specify the name of the project in ViewGit (e.g. scripts, scuttle etc. from http://code.fealdia.org/viewgit/).
Type:String
$class: 'GitLFSPullTrait'
-
$class: 'GitToolSCMSourceTrait'
-
gitTool
-
Type:String
gitHubIgnoreDraftPullRequestFilter
-
$class: 'IgnoreOnPushNotificationTrait'
-
$class: 'LocalBranchTrait'
-
$class: 'MercurialBrowserSCMSourceTrait'
-
browser
-
- Nested choice of objects
-
$class: 'FishEye'
-
url
-
Specify the root URL serving this repository, such as: http://www.example.org/browse/hg/
Type:String
$class: 'GoogleCode'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'HgWeb'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'Kallithea'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'KilnHG'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'RhodeCode'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'RhodeCodeLegacy'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'ScmManager'
-
url
-
Specify the root URL serving this repository (such as
http://YOURSCMMANAGER/scm/repo/NAMESPACE/NAME/
).Type:String
$class: 'MercurialInstallationSCMSourceTrait'
-
installation
-
Type:String
$class: 'PruneStaleBranchTrait'
-
$class: 'PruneStaleTagTrait'
-
bitbucketPublicRepoPullRequestFilter
-
If the repository being scanned is a public repository, this behaviour will exclude all pull requests.
(Note: This behaviour is not especially useful if scanning a single repository as you could just not include the
pull request discovery behaviours in the first place) $class: 'PullRequestDiscoveryTrait'
-
excludeBranchesWithPRs
-
Exclude branches for which there is an open pull request
Type:boolean
$class: 'RefSpecsSCMSourceTrait'
-
templates
-
Array/List:
- Nested object
-
value
-
A ref spec to fetch. Any occurrences of
@{remote}
will be replaced by the remote name
(which defaults toorigin
) before use.Type:String
headRegexFilter
-
regex
-
A Java regular expression to
restrict the names. Names that do not match the supplied regular expression will be ignored.
NOTE: this filter will be applied to all branch like things, including change requestsType:String
$class: 'RemoteNameSCMSourceTrait'
-
remoteName
-
Type:String
$class: 'SparseCheckoutPathsTrait'
-
extension
-
- Nested object
-
Specify the paths that you’d like to sparse checkout. This may be used for saving space (Think about a reference repository).
Be sure to use a recent version of Git, at least above 1.7.10sparseCheckoutPaths
-
Array/List:
- Nested object
-
path
-
Type:String
$class: 'SubmoduleOptionTrait'
-
extension
-
- Nested object
-
disableSubmodules
-
By disabling support for submodules you can still keep using basic
git plugin functionality and just have Jenkins to ignore submodules
completely as if they didn’t exist.Type:boolean
recursiveSubmodules
-
Retrieve all submodules recursively
(uses ‘—recursive’ option which requires git>=1.6.5)
Type:boolean
trackingSubmodules
-
Retrieve the tip of the configured branch in .gitmodules
(Uses ‘—remote’ option which requires git>=1.8.2)
Type:boolean
reference
-
Specify a folder containing a repository that will be used by Git as a reference during clone operations.
This option will be ignored if the folder is not available on the controller or agent where the clone is being executed.
To prepare a reference folder with multiple subprojects, create a bare git repository and add all the remote urls then perform a fetch:git init --bare git remote add SubProject1 https://gitrepo.com/subproject1 git remote add SubProject2 https://gitrepo.com/subproject2 git fetch --all
Type:String
timeout
-
Specify a timeout (in minutes) for submodules operations.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
parentCredentials
-
Use credentials from the default remote of the parent project.
Type:boolean
depth
(optional)-
Set shallow clone depth, so that git will only download recent history of the project,
saving time and disk space when you just want to access the latest commits of a repository.Type:int
shallow
(optional)-
Perform shallow clone, so that git will not download the history of the project,
saving time and disk space when you just want to access the latest version of a repository.Type:boolean
threads
(optional)-
Specify the number of threads that will be used to update submodules.
If unspecified, the command line git default thread count is used.Type:int
$class: 'UserIdentityTrait'
-
extension
-
- Nested object
-
name
-
If given, «GIT_COMMITTER_NAME=[this]» and «GIT_AUTHOR_NAME=[this]» are set for builds. This overrides whatever is in the global settings.
Type:String
email
-
If given, «GIT_COMMITTER_EMAIL=[this]» and «GIT_AUTHOR_EMAIL=[this]» are set for builds. This overrides whatever is in the global settings.
Type:String
bitbucketWebhookConfiguration
-
Sets the value for committersToIgnore in the Bitbucket Webhook. Value should be a comma separated string.
committerToIgnore is used to prevent triggering Jenkins builds when commits by certain users
are made.committersToIgnore
-
Type:String
bitbucketWebhookRegistration
-
Overrides the defaults for webhook management.
Webhooks are used to inform Jenkins about changes to repositories. There are two ways webhooks can be
configured:- Manual webhook configuration requires the user to configure Bitbucket with the Jenkins URL in order
to ensure that Bitbucket will send the events to Jenkins after every change. - Automatic webhook configuration requires that Jenkins has credentials with sufficient permission to
configure webhooks and also that Jenkins knows the URL that Bitbucket can connect to.
The Manage Jenkins » Configure Jenkins › Bitbucket Endpoints allows defining the list of
servers. Each server
can be associated with credentials. If credentials are defined then the default behaviour is to use those
credentials to automatically manage the webhooks of all repositories that Jenkins is interested in. If no
credentials are defined then the default behaviour is to require the user to manually configure webhooks.mode
-
There are two available modes:
- Disable hook management
- Disables hook management irrespective of the global defaults.
- Use item credentials for hook management
- Enabled hook management but uses the selected credentials to manage the hooks rather than those defined in
Manage Jenkins » Configure Jenkins › Bitbucket Endpoints
Type:String
- Manual webhook configuration requires the user to configure Bitbucket with the Jenkins URL in order
headWildcardFilter
-
includes
-
Space-separated list of name patterns to consider.
You may use*
as a wildcard; for example:master release*
NOTE: this filter will be applied to all branch like things, including change requestsType:String
excludes
-
Space-separated list of name patterns to ignore even if matched by the includes list.
For example:release alpha-* beta-*
NOTE: this filter will be applied to all branch like things, including change requestsType:String
$class: 'WipeWorkspaceTrait'
-
bitbucketBranchDiscovery
-
Discovers branches on the repository.
strategyId
-
Determines which branches are discovered.
- Exclude branches that are also filed as PRs
-
If you are discovering origin pull requests, it may not make sense to discover the same changes both as a
pull request and as a branch. - Only branches that are also filed as PRs
-
Discovers branches that have PR’s associated with them. This may make sense if you have a
notification sent to the team at the end of a triggered build or limited Jenkins resources. - All branches
-
Ignores whether the branch is also filed as a pull request and instead discovers all branches on the
origin repository.
Type:int
bitbucketForkDiscovery
-
Discovers pull requests where the origin repository is a fork of the target repository.
strategyId
-
Determines how pull requests are discovered.
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging
Type:int
trust
-
One of the great powers of pull requests is that anyone with read access to a repository can fork it, commit
some changes to their fork and then create a pull request against the original repository with their changes.
There are some files stored in source control that are important. For example, aJenkinsfile
may contain configuration details to sandbox pull requests in order to mitigate against malicious pull requests.
In order to protect against a malicious pull request itself modifying theJenkinsfile
to remove
the protections, you can define the trust policy for pull requests from forks.Other plugins can extend the available trust policies. The default policies are:
- Nobody
-
Pull requests from forks will all be treated as untrusted. This means that where Jenkins requires a
trusted file (e.g.Jenkinsfile
) the contents of that file will be retrieved from the
target branch on the origin repository and not from the pull request branch on the fork repository. - Forks in the same account
-
Bitbucket allows for a repository to be forked into a «sibling» repository in the same account but using
a different name. This strategy will trust any pull requests from forks that are in the same account as
the target repository on the basis that users have to have been granted write permission to account in
order create such a fork. - Everyone
-
All pull requests from forks will be treated as trusted. NOTE: this option can be dangerous
if used on a public repository hosted on Bitbucket Cloud.
java.lang.UnsupportedOperationException: do not know how to categorize attributes of type jenkins.scm.api.trait.SCMHeadAuthority<? super com.cloudbees.jenkins.plugins.bitbucket.BitbucketSCMSourceRequest, ? extends jenkins.scm.api.mixin.ChangeRequestSCMHead2, ? extends jenkins.scm.api.SCMRevision>
bitbucketPullRequestDiscovery
-
Discovers pull requests where the origin repository is the same as the target repository.
strategyId
-
Determines how pull requests are discovered.
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging
Type:int
bitbucketSshCheckout
-
By default the discovered branches / pull requests will all use the same credentials
that were used for discovery when checking out sources. This means that the checkout will be using the
https://
protocol for the Git repository.This behaviour allows you to select the SSH private key to be used for checking out sources, which will
consequently force the checkout to use thessh://
protocol.credentialsId
-
Credentials used to check out sources.
It must be a SSH key based credential.
Type:String
bitbucketTagDiscovery
-
Discovers tags on the repository.
$class: 'com.cloudogu.scmmanager.scm.BranchDiscoveryTrait'
-
$class: 'com.cloudogu.scmmanager.scm.TagDiscoveryTrait'
-
gitBranchDiscovery
-
Discovers branches on the repository.
gitTagDiscovery
-
Discovers tags on the repository.
gitHubBranchDiscovery
-
Discovers branches on the repository.
strategyId
-
Determines which branches are discovered.
- Exclude branches that are also filed as PRs
-
If you are discovering origin pull requests, you may not want to also build the source branches
for those pull requests. - Only branches that are also filed as PRs
-
Similar to discovering origin pull requests, but discovers the branch rather than the pull request.
This meansenv.GIT_BRANCH
will be set to the branch name rather thanPR-#
.
Also, status notifications for these builds will only be applied to the commit and not to the pull request. - All branches
-
Ignores whether the branch is also filed as a pull request and instead discovers all branches on the
origin repository.
Type:int
gitHubForkDiscovery
-
Discovers pull requests where the origin repository is a fork of the target repository.
strategyId
-
Determines how pull requests are discovered:
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch. - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging. - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging.
Type:int
trust
-
One of the great powers of pull requests is that anyone with read access to a repository can fork it, commit
some changes to their fork and then create a pull request against the original repository with their changes.
There are some files stored in source control that are important. For example, aJenkinsfile
may contain configuration details to sandbox pull requests in order to mitigate against malicious pull requests.
In order to protect against a malicious pull request itself modifying theJenkinsfile
to remove
the protections, you can define the trust policy for pull requests from forks.Other plugins can extend the available trust policies. The default policies are:
- Nobody
-
Pull requests from forks will all be treated as untrusted. This means that where Jenkins requires a
trusted file (e.g.Jenkinsfile
) the contents of that file will be retrieved from the
target branch on the origin repository and not from the pull request branch on the fork repository. - Collaborators
-
Pull requests from collaborators
to the origin repository will be treated as trusted, all other pull requests from fork repositories
will be treated as untrusted.
Note that if credentials used by Jenkins for scanning the repository does not have permission to
query the list of collaborators to the origin repository then only the origin account will be treated
as trusted — i.e. this will fall back toNobody
.
NOTE: all collaborators are trusted, even if they are only members of a team with read permission. - Everyone
-
All pull requests from forks will be treated as trusted. NOTE: this option can be dangerous
if used on a public repository hosted on GitHub. - From users with Admin or Write permission
-
Pull requests forks will be treated as trusted if and only if the fork owner has either Admin or Write
permissions on the origin repository.
This is the recommended policy.
Note that this strategy requires the
Review
a user’s permission level API, as a result on GitHub Enterprise Server versions before 2.12 this
is the same as trusting Nobody.
java.lang.UnsupportedOperationException: do not know how to categorize attributes of type jenkins.scm.api.trait.SCMHeadAuthority<? super org.jenkinsci.plugins.github_branch_source.GitHubSCMSourceRequest, ? extends jenkins.scm.api.mixin.ChangeRequestSCMHead2, ? extends jenkins.scm.api.SCMRevision>
gitHubPullRequestDiscovery
-
Discovers pull requests where the origin repository is the same as the target repository.
strategyId
-
Determines how pull requests are discovered:
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch. - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging. - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging.
Type:int
gitHubSshCheckout
-
By default the discovered branches / pull requests will all use the same username / password credentials
that were used for discovery when checking out sources. This means that the checkout will be using the
https://
protocol for the Git repository.This behaviour allows you to select the SSH private key to be used for checking out sources, which will
consequently force the checkout to use thessh://
protocol.credentialsId
-
Credentials used to check out sources. Must be a SSH key based credential.
Type:String
gitHubTagDiscovery
-
Discovers tags on the repository.
scmManagerSvn
-
serverUrl
-
Specify the root URL of the SCM-Manager instance including the context path (such as https://scm-manager.org/scm/).
Type:String
repository
-
Select an existing repository from the SCM-Manager instance.
Type:String
id
(optional)-
Type:String
credentialsId
(optional)-
Select valid credentials for the specified SCM-Manager instance.
Type:String
browser
(optional)-
- Nested choice of objects
-
$class: 'Assembla'
-
spaceName
-
Type:String
$class: 'CollabNetSVN'
-
url
-
The repository browser URL for the root of the project.
For example, a Java.net project calledmyproject
would use
https://myproject.dev.java.net/source/browse/myproject
.
Type:String
$class: 'FishEyeSVN'
-
url
-
Specify the URL of this module in FishEye.
(such ashttp://fisheye6.cenqua.com/browse/ant/
)
Type:String
rootModule
-
Specify the root Subversion module that this FishEye monitors.
For example, forhttp://fisheye6.cenqua.com/browse/ant/
,
this field would beant
because it displays the directory «/ant»
of the ASF repo. If FishEye is configured to display the whole SVN repository,
leave this field empty.Type:String
svnPhabricator
-
url
-
Type:String
repo
-
Type:String
$class: 'SVNWeb'
-
url
-
Type:String
$class: 'ScmManagerSvnRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository (such as https://scm-manager.org/scm/repo/namespace/name).
Type:String
$class: 'Sventon'
-
url
-
Specify the URL of the Sventon repository browser.
For example, if you normally browse fromhttp://somehost.com/svn/repobrowser.svn?name=local
,
this field would behttp://somehost.com/svn/
Type:String
repositoryInstance
-
Specify the Sventon repository instance name that references this subversion repository.
For example, if you normally browse fromhttp://somehost.com/svn/repobrowser.svn?name=local
,
this field would belocal
Type:String
$class: 'Sventon2'
-
url
-
Specify the URL of the Sventon repository browser.
For example, if you normally browse fromhttp://somehost.com/svn/repobrowser.svn?name=local
,
this field would behttp://somehost.com/svn/
Type:String
repositoryInstance
-
Specify the Sventon repository instance name that references this subversion repository.
For example, if you normally browse fromhttp://somehost.com/svn/repobrowser.svn?name=local
,
this field would belocal
Type:String
$class: 'ViewSVN'
-
url
-
Specify the root URL of ViewSVN for this repository
(such as this).Type:String
$class: 'VisualSVN'
-
url
-
Type:String
$class: 'WebSVN'
-
url
-
Type:String
excludes
(optional)-
Optionally specify branches to be excluded from builds using glob expressions.
Type:String
includes
(optional)-
Specify the branches to be build using glob expressions (like trunk,branches/*,tags/*,sandbox/*).
Type:String
workspaceUpdater
(optional)-
- Nested choice of objects
-
$class: 'CheckoutUpdater'
-
$class: 'NoopUpdater'
-
$class: 'UpdateUpdater'
-
$class: 'UpdateWithCleanUpdater'
-
$class: 'UpdateWithRevertUpdater'
-
fromScm
-
name
-
The name of the SCM head/trunk/branch/tag that this source provides.
Type:String
scm
-
- Nested choice of objects
-
$class: 'GitSCM'
-
The git plugin provides fundamental git operations for Jenkins projects.
It can poll, fetch, checkout, and merge contents of git repositories.The git plugin provides an SCM implementation to be used with the Pipeline SCM
checkout
step.
The Pipeline Syntax Snippet Generator guides the user to select git plugin checkout options and provides online help for each of the options.userRemoteConfigs
-
Specify the repository to track. This can be a URL or a local file path.
Note that for super-projects (repositories with submodules), only a local file
path or a complete URL is valid. The following are examples of valid git URLs.- ssh://git@github.com/github/git.git
- git@github.com:github/git.git (short notation for ssh protocol)
- ssh://user@other.host.com/~/repos/R.git (to access the repos/R.git
repository in the user’s home directory) - https://github.com/github/git.git
If the repository is a super-project, the
location from which to clone submodules is dependent on whether the repository
is bare or non-bare (i.e. has a working directory).- If the super-project is bare, the location of the submodules will be
taken from .gitmodules. - If the super-project is not bare, it is assumed that the
repository has each of its submodules cloned and checked out appropriately.
Thus, the submodules will be taken directly from a path like
${SUPER_PROJECT_URL}/${SUBMODULE}
, rather than relying on
information from .gitmodules.
For a local URL/path to a super-project,
git rev-parse —is-bare-repository
is used to detect whether the super-project is bare or not.
For a remote URL to a super-project, the ending of the URL determines whether
a bare or non-bare repository is assumed:- If the remote URL ends with /.git, a non-bare repository is
assumed. - If the remote URL does NOT end with /.git, a bare
repository is assumed.
Array/List:
- Nested object
-
url
-
Specify the URL or path of the git repository.
This uses the same syntax as yourgit clone
command.Type:String
name
-
ID of the repository, such as
origin
, to uniquely identify this repository among other remote repositories.
This is the same «name» that you use in yourgit remote
command. If left empty,
Jenkins will generate unique names for you.You normally want to specify this when you have multiple remote repositories.
Type:String
refspec
-
A refspec controls the remote refs to be retrieved and how they map to local refs. If left blank, it will default to
the normal behaviour ofgit fetch
, which retrieves all the branch heads asremotes/REPOSITORYNAME/BRANCHNAME
.
This default behaviour is OK for most cases.In other words, the default refspec is «+refs/heads/*:refs/remotes/REPOSITORYNAME/*» where
REPOSITORYNAME
is the value
you specify in the above «name of repository» textbox.When do you want to modify this value? A good example is when you want to just retrieve one branch. For example,
+refs/heads/master:refs/remotes/origin/master
would only retrieve the master branch and nothing else.The plugin uses a default refspec for its initial fetch, unless the «Advanced Clone Option» is set to honor refspec.
This keeps compatibility with previous behavior, and allows the job definition to decide if the refspec should be
honored on initial clone.Multiple refspecs can be entered by separating them with a space character.
+refs/heads/master:refs/remotes/origin/master +refs/heads/develop:refs/remotes/origin/develop
retrieves the master branch and the develop branch and nothing else.See the refspec definition in Git user manual for more details.
Type:String
credentialsId
-
Credential used to check out sources.
Type:String
branches
-
List of branches to build.
Jenkins jobs are most effective when each job builds only a single branch.
When a single job builds multiple branches, the changelog comparisons between branches often show no changes or incorrect changes.Array/List:
- Nested object
-
name
-
Specify the branches if you’d like to track a specific branch in a repository.
If left blank, all branches will be examined for changes and built.The safest way is to use the
refs/heads/<branchName>
syntax. This way the expected branch
is unambiguous.If your branch name has a
/
in it make sure to use the full reference above. When not presented
with a full path the plugin will only use the part of the string right of the last slash.
Meaningfoo/bar
will actually matchbar
.If you use a wildcard branch specifier, with a slash (e.g.
release/
),
you’ll need to specify the origin repository in the branch names to
make sure changes are picked up. So e.g.origin/release/
Possible options:
-
<branchName>
Tracks/checks out the specified branch. If ambiguous the first result is taken, which is not necessarily
the expected one. Better userefs/heads/<branchName>
.
E.g.master
,feature1
, … -
refs/heads/<branchName>
Tracks/checks out the specified branch.
E.g.refs/heads/master
,refs/heads/feature1/master
, … -
<remoteRepoName>/<branchName>
Tracks/checks out the specified branch. If ambiguous the first result is taken, which is not necessarily
the expected one.
Better userefs/heads/<branchName>
.
E.g.origin/master
-
remotes/<remoteRepoName>/<branchName>
Tracks/checks out the specified branch.
E.g.remotes/origin/master
-
refs/remotes/<remoteRepoName>/<branchName>
Tracks/checks out the specified branch.
E.g.refs/remotes/origin/master
-
<tagName>
This does not work since the tag will not be recognized as tag.
Userefs/tags/<tagName>
instead.
E.g.git-2.3.0
-
refs/tags/<tagName>
Tracks/checks out the specified tag.
E.g.refs/tags/git-2.3.0
-
<commitId>
Checks out the specified commit.
E.g.5062ac843f2b947733e6a3b105977056821bd352
,5062ac84
, … -
${ENV_VARIABLE}
It is also possible to use environment variables. In this case the variables are evaluated and the
result is used as described above.
E.g.${TREEISH}
,refs/tags/${TAGNAME}
, … -
<Wildcards>
The syntax is of the form:REPOSITORYNAME/BRANCH
.
In addition,BRANCH
is recognized as a shorthand of*/BRANCH
, ‘*’ is recognized as a wildcard,
and ‘**’ is recognized as wildcard that includes the separator ‘/’. Therefore,origin/branches*
would
matchorigin/branches-foo
but notorigin/branches/foo
, whileorigin/branches**
would
match bothorigin/branches-foo
andorigin/branches/foo
. -
:<regular expression>
The syntax is of the form::regexp
.
Regular expression syntax in branches to build will only
build those branches whose names match the regular
expression.
Examples::^(?!(origin/prefix)).*
- matches:
origin
ororigin/master
ororigin/feature
- does not match:
origin/prefix
ororigin/prefix_123
ororigin/prefix-abc
- matches:
:origin/release-d{8}
- matches:
origin/release-20150101
- does not match:
origin/release-2015010
ororigin/release-201501011
ororigin/release-20150101-something
- matches:
:^(?!origin/master$|origin/develop$).*
- matches:
origin/branch1
ororigin/branch-2
ororigin/master123
ororigin/develop-123
- does not match:
origin/master
ororigin/develop
- matches:
Type:String
-
browser
-
Defines the repository browser that displays changes detected by the git plugin.
- Nested choice of objects
-
$class: 'AssemblaWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://www.assembla.com/code/PROJECT/git/).
Type:String
bitbucketServer
-
repoUrl
-
Specify the Bitbucket Server root URL for this repository (such as https://bitbucket:7990/OWNER/REPO/).
Type:String
$class: 'BitbucketWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://bitbucket.org/OWNER/REPO/).
Type:String
$class: 'CGit'
-
repoUrl
-
Specify the root URL serving this repository (such as http://cgit.example.com:port/group/REPO/).
Type:String
$class: 'FisheyeGitRepositoryBrowser'
-
repoUrl
-
Specify the URL of this repository in FishEye (such as http://fisheye6.cenqua.com/browse/ant/).
Type:String
$class: 'GitBlitRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository.
Type:String
projectName
-
Specify the name of the project in GitBlit.
Type:String
$class: 'GitLab'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gitlabserver:port/group/REPO/).
Type:String
version
(optional)-
Specify the major and minor version of GitLab you use (such as 9.1). If you
don’t specify a version, a modern version of GitLab (>= 8.0) is assumed.Type:String
$class: 'GitList'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gitlistserver:port/REPO/).
Type:String
$class: 'GitWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://github.com/jenkinsci/jenkins.git).
Type:String
$class: 'GithubWeb'
-
repoUrl
-
Specify the HTTP URL for this repository’s GitHub page (such as https://github.com/jquery/jquery).
Type:String
$class: 'Gitiles'
-
repoUrl
-
Specify the root URL serving this repository (such as https://gwt.googlesource.com/gwt/).
Type:String
$class: 'GitoriousWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://gitorious.org/gitorious/mainline).
Type:String
$class: 'GogsGit'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gogs.example.com:port/username/some-repo-url.git).
Type:String
$class: 'KilnGit'
-
repoUrl
-
Specify the root URL serving this repository (such as https://khanacademy.kilnhg.com/Code/Website/Group/webapp).
Type:String
$class: 'Phabricator'
-
repoUrl
-
Specify the phabricator instance root URL (such as http://phabricator.example.com).
Type:String
repo
-
Specify the repository name in phabricator (such as the foo part of phabricator.example.com/diffusion/foo/browse).
Type:String
$class: 'RedmineWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as http://SERVER/PATH/projects/PROJECT/repository).
Type:String
$class: 'RhodeCode'
-
repoUrl
-
Specify the HTTP URL for this repository’s RhodeCode page (such as http://rhodecode.mydomain.com:5000/projects/PROJECT/repos/REPO/).
Type:String
$class: 'ScmManagerGitRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository (such as https://scm-manager.org/scm/repo/namespace/name).
Type:String
$class: 'Stash'
-
repoUrl
-
Specify the HTTP URL for this repository’s Stash page (such as http://stash.mydomain.com:7990/projects/PROJECT/repos/REPO/).
Type:String
$class: 'TFS2013GitRepositoryBrowser'
-
repoUrl
-
Either the name of the remote whose URL should be used, or the URL of this
module in TFS (such as http://fisheye6.cenqua.com/tfs/PROJECT/_git/REPO/).
If empty (default), the URL of the «origin» repository is used.If TFS is also used as the repository server, this can usually be left blank.
Type:String
$class: 'ViewGitWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as http://code.fealdia.org/viewgit/).
Type:String
projectName
-
Specify the name of the project in ViewGit (e.g. scripts, scuttle etc. from http://code.fealdia.org/viewgit/).
Type:String
gitTool
-
Absolute path to the git executable.
This is different from other Jenkins tool definitions.
Rather than providing the directory that contains the executable, you must provide the complete path to the executable.
Setting ‘/usr/bin/git
‘ would be correct, while setting ‘/usr/bin/
‘ is not correct.Type:String
extensions
-
Extensions add new behavior or modify existing plugin behavior for different uses.
Extensions help users more precisely tune plugin behavior to meet their needs.Extensions include:
-
Clone extensions modify the git operations that retrieve remote changes into the agent workspace.
The extensions can adjust the amount of history retrieved, how long the retrieval is allowed to run, and other retrieval details. -
Checkout extensions modify the git operations that place files in the workspace from the git repository on the agent.
The extensions can adjust the maximum duration of the checkout operation, the use and behavior of git submodules, the location of the workspace on the disc, and more. - Changelog extensions adapt the source code difference calculations for different cases.
- Tagging extensions allow the plugin to apply tags in the current workspace.
-
Build initiation extensions control the conditions that start a build.
They can ignore notifications of a change or force a deeper evaluation of the commits when polling. -
Merge extensions can optionally merge changes from other branches into the current branch of the agent workspace.
They control the source branch for the merge and the options applied to the merge.
Array/List:
- Nested choice of objects
-
$class: 'AuthorInChangelog'
-
The default behavior is to use the Git commit’s «Committer» value in Jenkins’ build changesets.
If this option is selected, the Git commit’s «Author» value would be used instead. $class: 'BuildChooserSetting'
-
When you are interested in using a job to build multiple heads (most typically multiple branches),
you can choose how Jenkins choose what branches to build in what order.This extension point in Jenkins is used by many other plugins to control the job to build
specific commits. When you activate those plugins, you may see them installing a custom strategy
here.buildChooser
-
- Nested choice of objects
-
$class: 'AncestryBuildChooser'
-
maximumAgeInDays
-
Type:int
ancestorCommitSha1
-
Type:String
$class: 'DefaultBuildChooser'
-
$class: 'InverseBuildChooser'
-
$class: 'BuildSingleRevisionOnly'
-
Disable scheduling for multiple candidate revisions.
If we have 3 branches:
—-A—.—.— B
——C
jenkins would try to build (B) and (C).
This behaviour disables this and only builds one of them.
It is helpful to reduce the load of the Jenkins infrastructure when the
SCM system like Bitbucket or GitHub should decide what commits to build. $class: 'ChangelogToBranch'
-
This method calculates the changelog against the specified branch.
options
-
- Nested object
-
compareRemote
-
Name of the repository, such as
origin
, that contains the branch you specify below.Type:String
compareTarget
-
The name of the branch within the named repository to compare against.
Type:String
$class: 'CheckoutOption'
-
timeout
-
Specify a timeout (in minutes) for checkout.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
$class: 'CleanBeforeCheckout'
-
Clean up the workspace before every checkout by deleting all untracked files and directories,
including those which are specified in.gitignore
.
It also resets all tracked files to their versioned state.
This ensures that the workspace is
in the same state as if you cloned and checked out in a brand-new empty directory, and ensures
that your build is not affected by the files generated by the previous build.deleteUntrackedNestedRepositories
(optional)-
Deletes untracked submodules and any other subdirectories which contain
.git
directories.Type:boolean
$class: 'CleanCheckout'
-
Clean up the workspace after every checkout by deleting all untracked files and directories,
including those which are specified in.gitignore
.
It also resets all tracked files to their versioned state.
This ensures that the workspace is
in the same state as if you cloned and checked out in a brand-new empty directory, and ensures
that your build is not affected by the files generated by the previous build.deleteUntrackedNestedRepositories
(optional)-
Deletes untracked submodules and any other subdirectories which contain
.git
directories.Type:boolean
$class: 'CloneOption'
-
shallow
-
Perform shallow clone, so that git will not download the history of the project,
saving time and disk space when you just want to access the latest version of a repository.Type:boolean
noTags
-
Deselect this to perform a clone without tags, saving time and disk space when you just want to access
what is specified by the refspec.Type:boolean
reference
-
Specify a folder containing a repository that will be used by Git as a reference during clone operations.
This option will be ignored if the folder is not available on the controller or agent where the clone is being executed.Type:String
timeout
-
Specify a timeout (in minutes) for clone and fetch operations.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
depth
(optional)-
Set shallow clone depth, so that git will only download recent history of the project,
saving time and disk space when you just want to access the latest commits of a repository.Type:int
honorRefspec
(optional)-
Perform initial clone using the refspec defined for the repository.
This can save time, data transfer and disk space when you only need
to access the references specified by the refspec.Type:boolean
$class: 'DisableRemotePoll'
-
Git plugin uses git ls-remote polling mechanism by default when configured with a single branch (no wildcards!).
This compare the latest built commit SHA with the remote branch without cloning a local copy of the repo.If you don’t want to / can’t use this.
If this option is selected, polling will require a workspace and might trigger unwanted builds (see JENKINS-10131).
$class: 'GitLFSPull'
-
Enable git large file support for the workspace by pulling large files after the checkout completes.
Requires that the controller and each agent performing an LFS checkout have installed `git lfs`. $class: 'IgnoreNotifyCommit'
-
If checked, this repository will be ignored when the notifyCommit-URL is accessed regardless of if the repository
matches or not. $class: 'LocalBranch'
-
If given, checkout the revision to build as HEAD on this branch.
If selected, and its value is an empty string or «**», then the branch
name is computed from the remote branch without the origin. In that
case, a remote branch origin/master will be checked out to a local
branch named master, and a remote branch origin/develop/new-feature
will be checked out to a local branch named develop/newfeature.Please note that this has not been tested with submodules.
localBranch
-
Type:String
$class: 'MessageExclusion'
-
excludedMessage
-
If set, and Jenkins is set to poll for changes, Jenkins will ignore any revisions committed with message matched to
Pattern when determining
if a build needs to be triggered. This can be used to exclude commits done by the build itself from triggering another build,
assuming the build server commits the change with a distinct message.Exclusion uses Pattern
matching.*[maven-release-plugin].*
The example above illustrates that if only revisions with «[maven-release-plugin]» message in first comment line
have been committed to the SCM a build will not occur.You can create more complex patterns using embedded flag expressions.
(?s).*FOO.*
This example will search FOO message in all comment lines.
Type:String
$class: 'PathRestriction'
-
If set, and Jenkins is set to poll for changes, Jenkins will pay attention to included and/or excluded files and/or
folders when determining if a build needs to be triggered.Using this behaviour will preclude the faster git ls-remote polling mechanism, forcing polling to require a workspace thus sometimes triggering unwanted builds, as if you had selected the Force polling using workspace extension as well.
includedRegions
-
Each inclusion uses java regular expression pattern matching,
and must be separated by a new line.
An empty list implies that everything is included.myapp/src/main/web/.*.html myapp/src/main/web/.*.jpeg myapp/src/main/web/.*.gif
The example above illustrates that a build will only occur, if html/jpeg/gif files
have been committed to the SCM. Exclusions take precedence over inclusions, if there is
an overlap between included and excluded regions.Type:String
excludedRegions
-
Each exclusion uses java regular expression pattern matching,
and must be separated by a new line.myapp/src/main/web/.*.html myapp/src/main/web/.*.jpeg myapp/src/main/web/.*.gif
The example above illustrates that if only html/jpeg/gif files have been committed to
the SCM a build will not occur.Type:String
$class: 'PerBuildTag'
-
Create a tag in the workspace for every build to unambiguously mark the commit that was built.
You can combine this with Git publisher to push the tags to the remote repository. $class: 'PreBuildMerge'
-
These options allow you to perform a merge to a particular branch before building.
For example, you could specify an integration branch to be built, and to merge to master.
In this scenario, on every change of integration, Jenkins will perform a merge with the master branch,
and try to perform a build if the merge is successful.
It then may push the merge back to the remote repository if the Git Push post-build action is selected.options
-
- Nested object
-
mergeTarget
-
The name of the branch within the named repository to merge to, such as
master
.Type:String
fastForwardMode
(optional)-
Merge fast-forward mode selection.
The default, —ff, gracefully falls back to a merge commit when required.
For more information, see the Git Merge Documentation mergeRemote
(optional)-
Name of the repository, such as
origin
, that contains the branch you specify below. If left blank,
it’ll default to the name of the first repository configured above.Type:String
mergeStrategy
(optional)-
Merge strategy selection.
This feature is not fully implemented in JGIT.Values:
DEFAULT
RESOLVE
RECURSIVE
OCTOPUS
OURS
SUBTREE
RECURSIVE_THEIRS
$class: 'PruneStaleBranch'
-
Run «git remote prune» for each remote, to prune obsolete local branches.
pruneTags
-
pruneTags
-
Type:boolean
$class: 'RelativeTargetDirectory'
-
relativeTargetDir
-
Specify a local directory (relative to the workspace root)
where the Git repository will be checked out. If left empty, the workspace root itself
will be used.This extension should not be used in Jenkins Pipeline (either declarative or scripted).
Jenkins Pipeline already provides standard techniques for checkout to a subdirectory.
Use ws and
dir
in Jenkins Pipeline rather than this extension.Type:String
$class: 'ScmName'
-
Unique name for this SCM. Needed when using Git within the Multi SCM plugin.
name
-
Type:String
$class: 'SparseCheckoutPaths'
-
Specify the paths that you’d like to sparse checkout. This may be used for saving space (Think about a reference repository).
Be sure to use a recent version of Git, at least above 1.7.10sparseCheckoutPaths
-
Array/List:
- Nested object
-
path
-
Type:String
$class: 'SubmoduleOption'
-
disableSubmodules
-
By disabling support for submodules you can still keep using basic
git plugin functionality and just have Jenkins to ignore submodules
completely as if they didn’t exist.Type:boolean
recursiveSubmodules
-
Retrieve all submodules recursively
(uses ‘—recursive’ option which requires git>=1.6.5)
Type:boolean
trackingSubmodules
-
Retrieve the tip of the configured branch in .gitmodules
(Uses ‘—remote’ option which requires git>=1.8.2)
Type:boolean
reference
-
Specify a folder containing a repository that will be used by Git as a reference during clone operations.
This option will be ignored if the folder is not available on the controller or agent where the clone is being executed.
To prepare a reference folder with multiple subprojects, create a bare git repository and add all the remote urls then perform a fetch:git init --bare git remote add SubProject1 https://gitrepo.com/subproject1 git remote add SubProject2 https://gitrepo.com/subproject2 git fetch --all
Type:String
timeout
-
Specify a timeout (in minutes) for submodules operations.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
parentCredentials
-
Use credentials from the default remote of the parent project.
Type:boolean
depth
(optional)-
Set shallow clone depth, so that git will only download recent history of the project,
saving time and disk space when you just want to access the latest commits of a repository.Type:int
shallow
(optional)-
Perform shallow clone, so that git will not download the history of the project,
saving time and disk space when you just want to access the latest version of a repository.Type:boolean
threads
(optional)-
Specify the number of threads that will be used to update submodules.
If unspecified, the command line git default thread count is used.Type:int
$class: 'UserExclusion'
-
excludedUsers
-
If set, and Jenkins is set to poll for changes, Jenkins will ignore any revisions committed by users in this list when determining if a build needs to be triggered. This can be used to exclude commits done by the build itself from triggering another build, assuming the build server commits the change with a distinct SCM user.
Using this behaviour will preclude the faster git ls-remote polling mechanism, forcing polling to require a workspace thus sometimes triggering unwanted builds, as if you had selected the Force polling using workspace extension as well.
Each exclusion uses exact string comparison and must be separated by a new line.
User names are only excluded if they exactly match one of the names in this list.auto_build_user
The example above illustrates that if only revisions by «auto_build_user» have been committed to the SCM a build will not occur.
Type:String
$class: 'UserIdentity'
-
name
-
If given, «GIT_COMMITTER_NAME=[this]» and «GIT_AUTHOR_NAME=[this]» are set for builds. This overrides whatever is in the global settings.
Type:String
email
-
If given, «GIT_COMMITTER_EMAIL=[this]» and «GIT_AUTHOR_EMAIL=[this]» are set for builds. This overrides whatever is in the global settings.
Type:String
$class: 'WipeWorkspace'
-
Delete the contents of the workspace before building, ensuring a fully fresh workspace.
-
Clone extensions modify the git operations that retrieve remote changes into the agent workspace.
doGenerateSubmoduleConfigurations
(optional)-
Removed facility that was intended to test combinations of git submodule versions.
Removed in git plugin 4.6.0.
Ignores the user provided value and always usesfalse
as its value.Type:boolean
submoduleCfg
(optional)-
Removed facility that was intended to test combinations of git submodule versions.
Removed in git plugin 4.6.0.
Ignores the user provided value(s) and always uses empty values.Array/List:
- Nested object
-
submoduleName
-
Removed in git plugin 4.6.0.
Type:String
branches
-
Removed in git plugin 4.6.0.
$class: 'MercurialSCM'
-
source
-
Specify the repository to track. This can be URL or a local file path.
If you are specifying HTTP credentials, do not include a username in the URL.Type:String
browser
(optional)-
- Nested choice of objects
-
$class: 'FishEye'
-
url
-
Specify the root URL serving this repository, such as: http://www.example.org/browse/hg/
Type:String
$class: 'GoogleCode'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'HgWeb'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'Kallithea'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'KilnHG'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'RhodeCode'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'RhodeCodeLegacy'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'ScmManager'
-
url
-
Specify the root URL serving this repository (such as
http://YOURSCMMANAGER/scm/repo/NAMESPACE/NAME/
).Type:String
clean
(optional)-
When this option is checked, each build will wipe any local modifications
or untracked files in the repository checkout.
This is often a convenient way to ensure that a build is not
using any artifacts from earlier builds.Type:boolean
credentialsId
(optional)-
Optional credentials to use when cloning or pulling from the remote repository.
Supports username/password with HTTP(S) URLs, and SSH private key with SSH URLs.Type:String
disableChangeLog
(optional)-
When checked, Hudson will not calculate the Mercurial changelog for each build.
Disabling the changelog can decrease the amount of time needed to update a
very large repository.Type:boolean
installation
(optional)-
Type:String
modules
(optional)-
Reduce unnecessary builds by specifying a comma or space delimited list of «modules» within the repository.
A module is a directory name within the repository that this project lives in. If this field is set,
changes outside the specified modules will not trigger a build (even though the whole repository is checked
out anyway due to the Mercurial limitation.)Type:String
revision
(optional)-
Specify the branch or tag name you would like to track.
(If you do not type anything, the default value is thedefault
branch.)Type:String
revisionType
(optional)-
Specify the kind of revision you expect Jenkins to update your working copy to.
Values:
BRANCH
TAG
CHANGESET
REVSET
subdir
(optional)-
If not empty, check out the Mercurial repository into this subdirectory of the
job’s workspace. For example:my/sources
(use forward slashes).
If changing this entry, you probably want to clean the workspace first.Type:String
none
-
$class: 'SubversionSCM'
-
Checks out the source code from Subversion repositories. See
post-commit hook set up for improved turn-around time and
performance in polling.locations
-
Array/List:
- Nested object
-
remote
-
Type:String
credentialsId
-
Type:String
local
-
Specify a local directory (relative to the workspace root)
where this module is checked out. If left empty, the last path component of the URL
is used as the default, just like thesvn
CLI.
A single period (.
) may be used to check out the project directly
into the workspace rather than into a subdirectory.Type:String
depthOption
-
—depth
option for checkout and update commands. Default value is
infinity
.
- empty includes only the immediate target of the operation, not any of its file or directory children.
- files includes the immediate target of the operation and any of its immediate file children.
- immediates includes the immediate target of the operation and any of its immediate file or directory children. The directory children will themselves be empty.
- infinity includes the immediate target, its file and directory children, its children’s children, and so on to full recursion.
- as-it-is takes the working depth from the current working copy, allows for setting update depth manually using —set-depth option.
More information can be found
here.Type:String
ignoreExternalsOption
-
«—ignore-externals» option will be used with svn checkout, svn update commands to disable externals definition processing.
More information can be found
here.
Note: there is the potential to leveragesvn:externals
to gain read access to the entire
Subversion repository. This can happen if you follow the normal practice of giving Jenkins
credentials with read access to the entire Subversion repository. You will also need to provide the credentials
to use when checking/polling out the svn:externals using the Additional Credentials option.Type:boolean
cancelProcessOnExternalsFail
-
Determines if the process should be cancelled when checkout/update svn:externals failed. Will work when «Ignore externals» box is not checked.
Default choice is to cancelled the process when checkout/update svn:externals failed.Type:boolean
workspaceUpdater
-
- Nested choice of objects
-
$class: 'CheckoutUpdater'
-
$class: 'NoopUpdater'
-
$class: 'UpdateUpdater'
-
$class: 'UpdateWithCleanUpdater'
-
$class: 'UpdateWithRevertUpdater'
-
browser
-
- Nested choice of objects
-
$class: 'Assembla'
-
spaceName
-
Type:String
$class: 'CollabNetSVN'
-
url
-
The repository browser URL for the root of the project.
For example, a Java.net project calledmyproject
would use
https://myproject.dev.java.net/source/browse/myproject
.
Type:String
$class: 'FishEyeSVN'
-
url
-
Specify the URL of this module in FishEye.
(such ashttp://fisheye6.cenqua.com/browse/ant/
)
Type:String
rootModule
-
Specify the root Subversion module that this FishEye monitors.
For example, forhttp://fisheye6.cenqua.com/browse/ant/
,
this field would beant
because it displays the directory «/ant»
of the ASF repo. If FishEye is configured to display the whole SVN repository,
leave this field empty.Type:String
svnPhabricator
-
url
-
Type:String
repo
-
Type:String
$class: 'SVNWeb'
-
url
-
Type:String
$class: 'ScmManagerSvnRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository (such as https://scm-manager.org/scm/repo/namespace/name).
Type:String
$class: 'Sventon'
-
url
-
Specify the URL of the Sventon repository browser.
For example, if you normally browse fromhttp://somehost.com/svn/repobrowser.svn?name=local
,
this field would behttp://somehost.com/svn/
Type:String
repositoryInstance
-
Specify the Sventon repository instance name that references this subversion repository.
For example, if you normally browse fromhttp://somehost.com/svn/repobrowser.svn?name=local
,
this field would belocal
Type:String
$class: 'Sventon2'
-
url
-
Specify the URL of the Sventon repository browser.
For example, if you normally browse fromhttp://somehost.com/svn/repobrowser.svn?name=local
,
this field would behttp://somehost.com/svn/
Type:String
repositoryInstance
-
Specify the Sventon repository instance name that references this subversion repository.
For example, if you normally browse fromhttp://somehost.com/svn/repobrowser.svn?name=local
,
this field would belocal
Type:String
$class: 'ViewSVN'
-
url
-
Specify the root URL of ViewSVN for this repository
(such as this).Type:String
$class: 'VisualSVN'
-
url
-
Type:String
$class: 'WebSVN'
-
url
-
Type:String
excludedRegions
-
If set, and Jenkins is set to poll for changes, Jenkins will ignore any files and/or
folders in this list when determining if a build needs to be triggered.Each exclusion uses regular expression pattern matching, and must be separated by a new line.
/trunk/myapp/src/main/web/.*.html /trunk/myapp/src/main/web/.*.jpeg /trunk/myapp/src/main/web/.*.gif
The example above illustrates that if only html/jpeg/gif files have been committed to
the SCM a build will not occur.More information on regular expressions can be found
here.Type:String
excludedUsers
-
If set, and Jenkins is set to poll for changes, Jenkins will ignore any revisions committed by users in this list when determining if a build needs to be triggered. This can be used to exclude commits done by the build itself from triggering another build, assuming the build server commits the change with a distinct SCM user.
Each exclusion uses literal pattern matching, and must be separated by a new line.
auto_build_user
The example above illustrates that if only revisions by «auto_build_user» have been committed to the SCM a build will not occur.
Type:String
excludedRevprop
-
If set, and Jenkins is set to poll for changes, Jenkins will ignore any revisions
that are marked with the given revision property (revprop) when determining if
a build needs to be triggered. This can be used to exclude commits done by the
build itself from triggering another build, assuming the build server commits
the change with the correct revprop.This type of exclusion only works with Subversion 1.5 servers and newer.
More information on revision properties can be found
here.Type:String
excludedCommitMessages
-
If set, and Jenkins is set to poll for changes, Jenkins will ignore any revisions
with commit messages containing any of the given regular expressions when
determining if a build needs to be triggered.Type:String
includedRegions
-
If set, and Jenkins is set to poll for changes, Jenkins will ignore any files and/or
folders that are not in this list when determining if a build needs to be triggered.Each inclusion uses regular expression pattern matching, and must be separated by a new line.
This is useful when you need to check out an entire resource for building, but only want to do
the build when a subset has changed./trunk/myapp/c/library1/.* /trunk/myapp/c/library2/.*
If /trunk/myapp is checked out, the build will only occur when there are changes to
either the c/library1 and c/library2 subtrees.If there are also excluded regions specified, then a file is not ignored when it is in
the included list and not in the excluded list.More information on regular expressions can be found
here.Type:String
ignoreDirPropChanges
-
If set, Jenkins ignores svn-property only changes of directories.
These changes are ignored when determining whether a build should be triggered and are removed from a
build’s changeset.
Main usage of this property is to ignore svn:mergeinfo changes (which would otherwise e.g. lead to a complete rebuild
of a maven project, in spite of incremental build option).Type:boolean
filterChangelog
-
If set Jenkins will apply the same inclusion and exclusion patterns for displaying changelog entries as it does for polling for changes.
If this is disabled, changes which are excluded for polling are still displayed in the changelog.Type:boolean
additionalCredentials
-
If there are additional credentials required in order to obtain a complete checkout of the source, they can be
provided here.The realm is how the repository self-identifies to a client. It usually has the following format:
<proto://host:port> Realm Name
proto
is the protocol, e.g.http
orsvn
.host
is the host how it’s accessed by Jenkins, e.g. as IP address192.168.1.100
, host namesvnserver
, or host name and domainsvn.example.org
.port
is the port, even if not explicitly specified. By default, this is80
for HTTP,443
for HTTPS, 3690 for thesvn
protocol.Realm Name
is how the repository self-identifies. Common options includeVisualSVN Server
,Subversion Authentication
or the UUID of the repository.
To find out the realm, you could do any of the following:
- If you access the repository via HTTP or HTTPS: Open the repo in a web browser without saved credentials. It will use the
Realm Name
(see above) in the authentication dialog. - Use the command line
svn
program.- If you don’t have stored the credentials, run e.g.
svn info https://svnserver/repo
and it will tell you the realm when asking you to enter a password, e.g.: Authentication realm: <svn://svnserver:3690> VisualSVN Server. - If you have already stored the credentials to access the repository, look for the realm name in one of the files in
~/.subversion/auth/svn/simple
; it will be two lines below the linesvn:realmstring
.
- If you don’t have stored the credentials, run e.g.
- When accessing a repository via the
svn+ssh
protocol, the realm has the formatusername@svn+ssh://host:port
– note that the username is before thesvn+ssh://
(unlike the URL used for normal SVN operations), and that there are no angle brackets and no realm name. For this protocol the default port is 22.
Make sure to enter the realm exactly as shown, starting with a
<
(except for repositories accessed viasvn+ssh
– see above).Array/List:
- Nested object
-
realm
-
This is the realm that the SvnKit library associates with a specific checkout. For most Subversion servers this
will typically be of the format<scheme://hostname(:port)> name
,
while for servers accessed viasvn+ssh
it is of the format(username@)svn+ssh://hostname(:port)
.Type:String
credentialsId
-
Select the credential from the list of relevant credentials in order to use that credential for checking out
the source code.Type:String
quietOperation
-
Mimics subversion command line
--quiet
parameter for check out / update operations to help keep the output shorter. Prints nothing, or only summary information.Type:boolean
id
(optional)-
Type:String
$class: 'SubversionSCMSource'
-
remoteBase
-
Type:String
id
(optional)-
Type:String
browser
(optional)-
- Nested choice of objects
-
$class: 'Assembla'
-
spaceName
-
Type:String
$class: 'CollabNetSVN'
-
url
-
The repository browser URL for the root of the project.
For example, a Java.net project calledmyproject
would use
https://myproject.dev.java.net/source/browse/myproject
.
Type:String
$class: 'FishEyeSVN'
-
url
-
Specify the URL of this module in FishEye.
(such ashttp://fisheye6.cenqua.com/browse/ant/
)
Type:String
rootModule
-
Specify the root Subversion module that this FishEye monitors.
For example, forhttp://fisheye6.cenqua.com/browse/ant/
,
this field would beant
because it displays the directory «/ant»
of the ASF repo. If FishEye is configured to display the whole SVN repository,
leave this field empty.Type:String
svnPhabricator
-
url
-
Type:String
repo
-
Type:String
$class: 'SVNWeb'
-
url
-
Type:String
$class: 'ScmManagerSvnRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository (such as https://scm-manager.org/scm/repo/namespace/name).
Type:String
$class: 'Sventon'
-
url
-
Specify the URL of the Sventon repository browser.
For example, if you normally browse fromhttp://somehost.com/svn/repobrowser.svn?name=local
,
this field would behttp://somehost.com/svn/
Type:String
repositoryInstance
-
Specify the Sventon repository instance name that references this subversion repository.
For example, if you normally browse fromhttp://somehost.com/svn/repobrowser.svn?name=local
,
this field would belocal
Type:String
$class: 'Sventon2'
-
url
-
Specify the URL of the Sventon repository browser.
For example, if you normally browse fromhttp://somehost.com/svn/repobrowser.svn?name=local
,
this field would behttp://somehost.com/svn/
Type:String
repositoryInstance
-
Specify the Sventon repository instance name that references this subversion repository.
For example, if you normally browse fromhttp://somehost.com/svn/repobrowser.svn?name=local
,
this field would belocal
Type:String
$class: 'ViewSVN'
-
url
-
Specify the root URL of ViewSVN for this repository
(such as this).Type:String
$class: 'VisualSVN'
-
url
-
Type:String
$class: 'WebSVN'
-
url
-
Type:String
credentialsId
(optional)-
Type:String
excludes
(optional)-
Type:String
includes
(optional)-
Type:String
workspaceUpdater
(optional)-
- Nested choice of objects
-
$class: 'CheckoutUpdater'
-
$class: 'NoopUpdater'
-
$class: 'UpdateUpdater'
-
$class: 'UpdateWithCleanUpdater'
-
$class: 'UpdateWithRevertUpdater'
-
libraryPath
(optional)-
A relative path from the root of the SCM to the root of the library.
Leave this field blank if the root of the library is the root of the SCM.
Note that «..» is not permitted as a path component to avoid security issues.Type:String
libraryResource
: Load a resource file from a libraryReads a resource from a library and returns its content as a plain string.
resource
-
Relative (
/
-separated) path to a resource in a library’s/resources
folder.Type:String
encoding
(optional)-
The encoding to use when reading the resource.
If left blank, the platform default encoding will be used.
Binary files can be read into a Base64-encoded string by specifying «Base64» as the encoding.Type:String
load
: Evaluate a Groovy source file into the Pipeline scriptTakes a filename in the workspace and runs it as Groovy source text.
The loaded file can contain statements at top level or just load and run a closure. For example:
def pipeline node('slave') { pipeline = load 'pipeline.groovy' pipeline.functionA() } pipeline.functionB()
Where pipeline.groovy
defines functionA and functionB functions (among others) before ending with return this;
path
-
Current directory (
pwd()
) relative path to the Groovy file to load.Type:String
lock
: Lock shared resourceresource
-
The resource name to lock as defined in Global settings.
If the resource does not exist in Global Settings it will be automatically created on build execution.
Either a resource or a label need to be specified.Type:String
extra
(optional)-
Array/List:
- Nested object
-
resource
-
The resource name to lock as defined in Global settings.
If the resource does not exist in Global Settings it will be automatically created on build execution.
Either a resource or a label need to be specified.Type:String
label
(optional)-
The label of the resources to be locked as defined in Global settings.
Either a resource or a label need to be specified.Type:String
quantity
(optional)-
The quantity of resources with the specified label to be locked as defined in Global settings.
Either a resource or a label need to be specified.
Empty value or 0 means lock all matching resources.Type:int
inversePrecedence
(optional)-
By default waiting builds get the lock in the same order they requested to acquire it.
By checking this option the newest build in the waiting queue will get the lock first.
Type:boolean
label
(optional)-
The label of the resources to be locked as defined in Global settings.
Either a resource or a label need to be specified.Type:String
quantity
(optional)-
The quantity of resources with the specified label to be locked as defined in Global settings.
Either a resource or a label need to be specified.
Empty value or 0 means lock all matching resources.Type:int
skipIfLocked
(optional)-
By default waiting builds get the lock.
By checking this option the body will not be executed if there is a queue. It will only take the lock if it can be taken immediately.
Type:boolean
variable
(optional)-
Name of an environment variable that will receive the comma separated list of the names of the locked resources while the block executes.
e.g.:
lock(label: 'label', variable: 'var') { echo "Resource locked: ${env.var}" }
Type:String
mail
: MailSimple step for sending email.
subject
-
Type:String
body
-
Type:String
bcc
(optional)-
BCC email address list. Comma separated list of email addresses.
Type:String
cc
(optional)-
CC email address list. Comma separated list of email addresses.
Type:String
charset
(optional)-
Email body character encoding. Defaults to
UTF-8
Type:String
from
(optional)-
From email address. Defaults to the admin address globally configured for the Jenkins instance.
Type:String
mimeType
(optional)-
Email body MIME type. Defaults to
text/plain
.Type:String
replyTo
(optional)-
Reploy-To email address. Defaults to the admin address globally configured for the Jenkins instance.
Type:String
to
(optional)-
To email address list. Comma separated list of email addresses.
Type:String
milestone
: The milestone step forces all builds to go through in orderBy default, Pipeline builds can run concurrently.
The milestone step forces all builds to go through in order, so an older build will never be allowed pass
a milestone (it is aborted) if a newer build already passed it.
In general this step grants:
- Builds pass milestones in order (taking the build number as sorter field).
- Older builds will not proceed (they are aborted) if a newer one already passed the milestone.
- When a build passes a milestone, any older build that passed the previous milestone but not this one is aborted.
- Once a build passes the milestone, it will never be aborted by a newer build that didn’t pass the milestone yet.
ordinal
-
An optional ordinal for the milestone. It is autogenerated if not explicitly set.
Setting explicit milestone ordinals grants that each milestone can be univocally identified across builds
even when script changes are made during a previous build. If you plan to add or remove milestone steps while there are
running builds and trigger new builds before the previous ones finished, then you should set explicit milestone ordinals.
Otherwise, let the step autogenerate them as it runs.Type:int
label
(optional)-
A label for the milestone. It’s shown in the build log metadata.
Type:String
unsafe
(optional)-
An optional flag to allow unsafe execution of the milestone step.
Do not set unless you understand the risks.Currently this will allow the execution of a milestone step within a parallel step.
It is assumed only 1 branch can contain a milestone step.Type:boolean
mineRepository
: Mine SCM repositoryscm
(optional)-
Type:String
moveComponents
: Move Components (Nexus Repository Manager 3.x)nexusInstanceId
-
Type:String
destination
-
The repository to which components will be moved
Type:String
search
(optional)-
java.lang.UnsupportedOperationException: do not know how to categorize attributes of type java.util.Map<java.lang.String, java.lang.String>
tagName
(optional)-
Components associated with this tag will be moved to the selected destination repository
Type:String
nexusPolicyEvaluation
: Invoke Nexus Policy EvaluationiqStage
-
Controls the stage the policy evaluation will be run against on the Nexus IQ Server.
Type:String
iqInstanceId
(optional)-
Type:String
advancedProperties
(optional)-
Provide advanced properties to the IQ Server in <key>=<value> pairs, with
each additional property appearing on a new line. eg:
key1=value1
key2=value2
Type:String
enableDebugLogging
(optional)-
Type:boolean
failBuildOnNetworkError
(optional)-
Controls the build outcome if there is a failure in communicating with the Nexus IQ Server (e.g. network outage). If
checked, the build will be marked as failed. Otherwise, the build is only marked as unstable.Type:boolean
iqApplication
(optional)-
- Nested choice of objects
- (not enumerable)
iqModuleExcludes
(optional)-
A comma-separated list of Ant-style
patterns relative to the workspace root that denote the module information files
(**/nexus-iq/module.xml
) to be ignored, e.g.**/my-module/target/**,
. If unspecified all modules will contribute dependency information (if any) to the
**/another-module/target/**
scan.Array/List:
- Nested object
-
moduleExclude
-
Type:String
iqScanPatterns
(optional)-
A list of Ant-style
patterns relative to the workspace root that denote the files/archives to be scanned, e.g.
**/target/*.war
or**/target/*.ear
. If unspecified, the scan will default to the patterns
**/*.jar, **/*.war, **/*.ear, **/*.zip, **/*.tar.gz
.Array/List:
- Nested object
-
scanPattern
-
Type:String
jobCredentialsId
(optional)-
To use the IQ server credentials configured in Nexus global configuration for this job select
- none -
,
otherwise select different credentials.Type:String
nexusPublisher
: Nexus Repository Manager PublishernexusInstanceId
-
Type:String
nexusRepositoryId
-
The publisher currently supports hosted release Maven 2 repositories. This list is limited to
repositories which meet this requirement.Type:String
packages
-
Array/List:
- Nested choice of objects
-
$class: 'MavenPackage'
-
mavenCoordinate
-
- Nested object
-
groupId
-
Type:String
artifactId
-
Type:String
version
-
Type:String
packaging
-
Type:String
mavenAssetList
-
Array/List:
- Nested object
-
filePath
-
Type:String
classifier
-
Type:String
extension
-
Type:String
tagName
(optional)-
Tag is only available for Nexus Repository Manager 3+
Type:String
node
: Allocate nodeAllocates an executor on a node (typically a build agent) and runs further code in the context of a workspace on that agent.
label
-
Computer name, label name, or any other label expression like
linux && 64bit
to restrict where this step builds.
May be left blank, in which case any available executor is taken.Supported operators
The following operators are supported, in descending order of precedence:
- (expression)
- parentheses — used to explicitly define the associativity of an expression
- !expression
- NOT — negation; the result of expression must not be true
- a && b
-
AND — both of the expressions a and b must be
true - a || b
-
OR — either of the expressions a or b may be
true - a -> b
-
«implies» operator — equivalent to !a || b.
For example, windows -> x64 could be thought of as «if a Windows
agent is used, then that agent must be 64-bit», while still
allowing this block to be executed on any agents that do not have
the windows label, regardless of whether they have also have an
x64 label - a <-> b
-
«if and only if» operator — equivalent to a && b ||
!a && !b
For example, windows <-> dc2 could be thought of as «if a
Windows agent is used, then that agent must be in datacenter 2, but
if a non-Windows agent is used, then it must not be in datacenter
2″
Notes
-
All operators are left-associative, i.e. a -> b -> c is
equivalent to (a -> b) -> c. -
Labels or agent names can be surrounded with quotation marks if they
contain characters that would conflict with the operator syntax.
For example, «osx (10.11)» || «Windows Server». -
Expressions can be written without whitespace, but including it is
recommended for readability; Jenkins will ignore whitespace when
evaluating expressions. -
Matching labels or agent names with wildcards or regular expressions is
not supported. -
An empty expression will always evaluate to true, matching all
agents.
Examples
- master
- This block may be executed only on the Jenkins built-in node
- linux-machine-42
-
This block may be executed only on the agent with the name
linux-machine-42 (or on any machine that happens to have a label
called linux-machine-42) - windows && jdk9
-
This block may be executed only on any Windows agent that has
version 9 of the Java Development Kit installed (assuming that agents
with JDK 9 installed have been given a jdk9 label) - postgres && !vm && (linux || freebsd)
-
This block may be executed only any on Linux or FreeBSD agent,
so long as they are not a virtual machine, and they have PostgreSQL
installed (assuming that each agent has the appropriate labels — in
particular, each agent running in a virtual machine must have the
vm label in order for this example to work as expected)
Type:String
nodesByLabel
: List of nodes by Label, by default excludes offline nodes.
Returns an array of node
names with the given label.
label
-
Type:String
offline
(optional)-
Type:boolean
parallel
: Execute in parallelorg.kohsuke.stapler.NoStaplerConstructorException: There's no @DataBoundConstructor on any constructor of class org.jenkinsci.plugins.workflow.cps.steps.ParallelStep
podTemplate
: Define a podTemplate to use in the kubernetes pluginDefines a Kubernetes pod template that can be used to create nodes.
Example:
podTemplate(...) { node(POD_LABEL) { // some steps } }
activeDeadlineSeconds
(optional)-
Type:int
annotations
(optional)-
Array/List:
-
key
-
The annotation key.
Type:String
value
-
The annotation value.
Type:String
podAnnotation
-
cloud
(optional)-
The Kubernetes cloud to use to schedule the pod.
If unset, the first available Kubernetes cloud will be used.Type:String
containers
(optional)-
Array/List:
-
name
-
The name for the container to be run.
One container is automatically created with name
jnlp
, and runs the Jenkins JNLP agent service.In order to replace the default JNLP agent, the name of the container with the custom JNLP image must be
jnlp
.Type:String
image
-
Docker image ID for a jenkins JNLP agent.
This image is responsible to run a jenkins jnlp bootstrap agent and connect to Jenkins controller.
Secret key and agent name as well as jenkins callback URL are passed as argument as expected
byhudson.remoting.jnlp.Main
.Type:String
alwaysPullImage
(optional)-
If ticked, the latest version of the image will be pulled every time it is used.
See Images — Kubernetes for the default Kubernetes behaviour.
Type:boolean
args
(optional)-
Arguments to pass to the command.
${computer.jnlpmac}
and${computer.name}
are replaced with the agent secret and name respectively.For Windows containers the args
Start-Sleep 999999
are reasonable choices to go withpowershell
.Type:String
command
(optional)-
Override the image entrypoint with a different one.
For Windows containers
powershell
is a good default.Type:String
envVars
(optional)-
The environment variables to pass to the container.
Array/List:
- Nested choice of objects
-
containerEnvVar
-
key
-
The environment variable key.
Type:String
value
-
The environment variable value.
Type:String
envVar
-
key
-
The environment variable key.
Type:String
value
-
The environment variable value.
Type:String
podEnvVar
-
key
-
The environment variable key.
Type:String
value
-
The environment variable value.
Type:String
secretEnvVar
-
key
-
The environment variable key.
Type:String
secretName
-
Name of secret to lookup from Kubernetes.
Type:String
secretKey
-
Key of secret to lookup from Kubernetes.
Type:String
optional
-
Whether this secret is optional.
Type:boolean
livenessProbe
(optional)-
-
execArgs
-
Command executed by the liveness probe.
Type:String
timeoutSeconds
-
Number of seconds after which the probe times out. Defaults to 1 second. Minimum value is 1.
Type:int
initialDelaySeconds
-
Number of seconds after the container has started before liveness or readiness probes are initiated. Defaults to 0 seconds. Minimum value is 0.
Type:int
failureThreshold
-
When a Pod starts and the probe fails, Kubernetes will try failureThreshold times before giving up.
Giving up in case of liveness probe means restarting the container.
In case of readiness probe the Pod will be marked Unready. Defaults to 3. Minimum value is 1.Type:int
periodSeconds
-
How often (in seconds) to perform the probe. Default to 10 seconds. Minimum value is 1.
Type:int
successThreshold
-
Minimum consecutive successes for the probe to be considered successful after having failed. Defaults to 1. Must be 1 for liveness. Minimum value is 1.
Type:int
containerLivenessProbe
-
ports
(optional)-
Array/List:
-
name
(optional)-
The name of the port
Type:String
containerPort
(optional)-
Port to expose into the pod
Type:int
hostPort
(optional)-
Port to expose onto the host
Type:int
portMapping
-
privileged
(optional)-
Flag to mark the container as privileged.
Type:boolean
resourceLimitCpu
(optional)-
Kubernetes Resources Limit of CPU
This value can be set to control the CPU resource limit passed when creating the Jenkins agent Docker container in
Kubernetes. Unlike a resource request, this is the upper limit of resources used by your Jenkins Agent container.
When left blank, the defaults of your Kubernetes cluster will be used. For more info, see the
Kubernetes docs.
e.g. `500m`.Type:String
resourceLimitEphemeralStorage
(optional)-
Type:String
resourceLimitMemory
(optional)-
Kubernetes Resources Limit of Memory
This value can be set to control the memory resource limit passed when creating the Jenkins agent Docker container in
Kubernetes. Unlike a resource request, this is the upper limit of resources used by your Jenkins Agent container.
When left blank, the defaults of your Kubernetes cluster will be used. For more info, see the
Kubernetes docs.
e.g. `250Mi`.Type:String
resourceRequestCpu
(optional)-
Kubernetes Resources Request of CPU
This value can be set to control the CPU resources requested when creating the Jenkins agent Docker container in
Kubernetes. When left blank, the defaults of your Kubernetes cluster will be used. For more info, see the
Kubernetes docs.
e.g. `500m`.Type:String
resourceRequestEphemeralStorage
(optional)-
Type:String
resourceRequestMemory
(optional)-
Kubernetes Resources Request of Memory
This value can be set to control the memory resources requested when creating the Jenkins agent Docker container in
Kubernetes. When left blank, the defaults of your Kubernetes cluster will be used. For more info, see the
Kubernetes docs.
e.g. `250Mi`.Type:String
runAsGroup
(optional)-
Specify the gid to run as.
Type:String
runAsUser
(optional)-
Specify the uid to run as.
Type:String
shell
(optional)-
Type:String
ttyEnabled
(optional)-
Whether this container should allocate a TTY for itself.
Type:boolean
workingDir
(optional)-
Path to the root of the workspace from the view point of this container, such as /home/jenkins/agent.
Type:String
containerTemplate
-
envVars
(optional)-
Array/List:
- Nested choice of objects
-
containerEnvVar
-
key
-
The environment variable key.
Type:String
value
-
The environment variable value.
Type:String
envVar
-
key
-
The environment variable key.
Type:String
value
-
The environment variable value.
Type:String
podEnvVar
-
key
-
The environment variable key.
Type:String
value
-
The environment variable value.
Type:String
secretEnvVar
-
key
-
The environment variable key.
Type:String
secretName
-
Name of secret to lookup from Kubernetes.
Type:String
secretKey
-
Key of secret to lookup from Kubernetes.
Type:String
optional
-
Whether this secret is optional.
Type:boolean
hostNetwork
(optional)-
Type:boolean
idleMinutes
(optional)-
Type:int
imagePullSecrets
(optional)inheritFrom
(optional)-
Type:String
instanceCap
(optional)-
Type:int
label
(optional)-
Jenkins node label to bind.
If left blank, one will be generated for you,
and inside the step it will be bound to the variablePOD_LABEL
so you can use this as the argument to thenode
step.Example:
podTemplate(...) { node(POD_LABEL) { // some steps } }
Type:String
name
(optional)-
Type:String
namespace
(optional)-
Type:String
nodeSelector
(optional)-
Type:String
nodeUsageMode
(optional)-
Type:String
podRetention
(optional)-
- Nested choice of objects
-
always
-
default
-
never
-
onFailure
-
runAsGroup
(optional)-
Type:String
runAsUser
(optional)-
Type:String
schedulerName
(optional)-
Type:String
serviceAccount
(optional)-
Type:String
showRawYaml
(optional)-
Type:boolean
slaveConnectTimeout
(optional)-
Type:int
supplementalGroups
(optional)-
Type:String
volumes
(optional)-
Array/List:
- Nested choice of objects
-
configMapVolume
-
mountPath
-
Path to mount this volume inside the pod.
Type:String
configMapName
-
The name of the Kubernetes Config Map to mount into the pod.
Type:String
optional
-
Whether this configmap needs to exist.
Type:boolean
subPath
(optional)-
SubPath to mount this volume inside the pod.
Type:String
dynamicPVC
-
accessModes
(optional)-
A PersistentVolume can be mounted on a host in any way supported by the resource provider.
Providers will have different capabilities and each PV’s access modes are set to the specific modes supported by that particular volume.
For example, NFS can support multiple read/write clients, but a specific NFS PV might be exported on the server as read-only.
Each PV gets its own set of access modes describing that specific PV’s capabilities.
Defaults to ReadWriteOnce.Type:String
mountPath
(optional)-
Path to mount this volume inside the pod.
Type:String
requestsSize
(optional)-
Claims, like pods, can request specific quantities of a resource. In this case, the request is for storage. The same resource model applies to both volumes and claims. Defaults to 10Gi.
Type:String
storageClassName
(optional)-
A StorageClass provides a way for administrators to describe the “classes” of storage they offer. Different classes might map to quality-of-service levels, or to backup policies, or to arbitrary policies determined by the cluster administrators. Kubernetes itself is unopinionated about what classes represent. This concept is sometimes called “profiles” in other storage systems.
Type:String
emptyDirVolume
-
mountPath
-
Path to mount this volume inside the pod.
Type:String
memory
-
Flag for in-memory volume.
Type:boolean
hostPathVolume
-
hostPath
-
File or directory on the host node’s filesystem to mount into the pod.
Type:String
mountPath
-
Path to mount this volume inside the pod.
Type:String
nfsVolume
-
serverAddress
-
NFS Server Address.
Type:String
serverPath
-
NFS Server Path.
Type:String
readOnly
-
Type:boolean
mountPath
-
Path to mount this volume inside the pod.
Type:String
persistentVolumeClaim
-
mountPath
-
Path to mount this volume inside the pod.
Type:String
claimName
-
The claim name.
Type:String
readOnly
-
Flag for read-only volume.
Type:boolean
secretVolume
-
mountPath
-
Path to mount this volume inside the pod.
Type:String
secretName
-
The name of the Kubernetes Secret to mount into the pod.
Type:String
defaultMode
-
The file permissions for the secret volume. Does not support Octal notation.
Type:String
optional
-
Whether the secret needs to exist.
Type:boolean
workingDir
(optional)-
Type:String
workspaceVolume
(optional)-
- Nested choice of objects
-
dynamicPVC
-
accessModes
(optional)-
A PersistentVolume can be mounted on a host in any way supported by the resource provider.
Providers will have different capabilities and each PV’s access modes are set to the specific modes supported by that particular volume.
For example, NFS can support multiple read/write clients, but a specific NFS PV might be exported on the server as read-only.
Each PV gets its own set of access modes describing that specific PV’s capabilities.
Defaults to ReadWriteOnce.Type:String
requestsSize
(optional)-
Claims, like pods, can request specific quantities of a resource. In this case, the request is for storage. The same resource model applies to both volumes and claims. Defaults to 10Gi.
Type:String
storageClassName
(optional)-
A StorageClass provides a way for administrators to describe the “classes” of storage they offer. Different classes might map to quality-of-service levels, or to backup policies, or to arbitrary policies determined by the cluster administrators. Kubernetes itself is unopinionated about what classes represent. This concept is sometimes called “profiles” in other storage systems.
Type:String
emptyDirWorkspaceVolume
-
memory
-
Flag for in-memory volume.
Type:boolean
hostPathWorkspaceVolume
-
hostPath
-
File or directory on the host node’s filesystem to mount into the pod.
Type:String
nfsWorkspaceVolume
-
serverAddress
-
NFS Server Address.
Type:String
serverPath
-
NFS Server Path.
Type:String
readOnly
-
Type:boolean
persistentVolumeClaimWorkspaceVolume
-
claimName
-
The claim name.
Type:String
readOnly
-
Flag for read-only volume.
Type:boolean
yaml
(optional)-
Type:String
yamlMergeStrategy
(optional)-
- Nested choice of objects
-
merge
-
override
-
powershell
: Windows PowerShell Scriptscript
-
Type:String
encoding
(optional)-
Encoding of process output.
In the case ofreturnStdout
, applies to the return value of this step;
otherwise, or always for standard error, controls how text is copied to the build log.
If unspecified, uses the system default encoding of the node on which the step is run.
If there is any expectation that process output might include non-ASCII characters,
it is best to specify the encoding explicitly.
For example, if you have specific knowledge that a given process is going to be producing UTF-8
yet will be running on a node with a different system encoding
(typically Windows, since every Linux distribution has defaulted to UTF-8 for a long time),
you can ensure correct output by specifying:encoding: 'UTF-8'
Type:String
label
(optional)-
Label to be displayed in the pipeline step view and blue ocean details for the step instead of the step type.
So the view is more meaningful and domain specific instead of technical.Type:String
returnStatus
(optional)-
Normally, a script which exits with a nonzero status code will cause the step to fail with an exception.
If this option is checked, the return value of the step will instead be the status code.
You may then compare it to zero, for example.Type:boolean
returnStdout
(optional)-
If checked, standard output from the task is returned as the step value as a
String
,
rather than being printed to the build log.
(Standard error, if any, will still be printed to the log.)
You will often want to call.trim()
on the result to strip off a trailing newline.Type:boolean
prependToFile
: Create a file (if not already exist) in the workspace, and prepend given content to that file.Creates a file if it does not already exist, and prepends given content to it.
file
-
The path to the file that will be prepended.
Type:String
content
-
The content to prepend.
Type:String
properties
: Set job properties
Updates the properties of the job which runs this step.
Mainly useful from multibranch Pipelines, so that Jenkinsfile
itself can encode what would otherwise be static job configuration.
Existing properties set through the Jenkins UI for non-multibranch Pipelines will be preserved.
properties
-
Array/List:
- Nested choice of objects
-
authorizationMatrix
-
permissions
inheritanceStrategy
(optional)-
- Nested choice of objects
-
inheritingGlobal
-
inheriting
-
nonInheriting
-
buildDiscarder
-
This determines when, if ever, build records for this project should be
discarded. Build records include the console output, archived artifacts, and
any other metadata related to a particular build.Keeping fewer builds means less disk space will be used in the Build Record
Root Directory, which is specified on the Configure System screen.Jenkins offers two options for determining when builds should be discarded:
-
Build age: discard builds when they reach a certain age; for example, seven
days old. -
Build count: discard the oldest build when a certain number of builds
already exist.
These two options can be active at the same time, so you can keep builds for
14 days, but only up to a limit of 50 builds, for example. If either limit is
exceeded, then any builds beyond that limit will be discarded.You can also ensure that important builds are kept forever, regardless of the
setting here — click the Keep this build forever button on the
build page.
The last stable and last successful build are also excluded from these rules.
In the Advanced section, the same options can be specified, but
specifically for build artifacts. If enabled, build artifacts will be
discarded for any builds which exceed the defined limits. The builds
themselves will still be kept; only the associated artifacts, if any, will be
deleted.For example, if a project builds some software and produces a large installer,
which is archived, you may wish to always keep the console log and information
about which source control commit was built, while for disk space reasons, you
may want to keep only the last three installers that were built.
This can make sense for projects where you can easily recreate the same
artifacts later by building the same source control commit again.
Note that Jenkins does not discard items immediately when this configuration
is updated, or as soon as any of the configured values are exceeded; these
rules are evaluated each time a build of this project completes.strategy
-
- Nested choice of objects
-
logRotator
-
daysToKeepStr
-
Type:String
numToKeepStr
-
Type:String
artifactDaysToKeepStr
-
Type:String
artifactNumToKeepStr
-
Type:String
-
Build age: discard builds when they reach a certain age; for example, seven
disableConcurrentBuilds
-
abortPrevious
(optional)-
By default, disabling concurrent builds means that new builds will queue up and wait for a running build to complete.
With this option, scheduling a new build immediately aborts any running build.
This is handy for example if you have an expensive pull request testing procedure
and do not wish to waste any time completing tests on an outdated commit.Type:boolean
disableResume
-
durabilityHint
-
This setting allows users to change the default durability mode for running Pipelines. In most cases this is a
trade-off between performance and the ability for running pipelines to resume after unplanned Jenkins outages.What does this do?
- Previously, running pipelines wrote data constantly, so that they could resume even if Jenkins fails.
This setting gives the user the ability to adjust this write behavior. - Higher-performance/lower-durability modes write data to disk much less often for running pipelines.
- Writing data less often can massively reduce build times for Pipelines with many steps or complex logic.
For pipelines which spend most of their time waiting for a shell/batch script to run, the difference will be less visible. - Running pipelines with lower durability settings may lose data if they do not finish and Jenkins is not shut down gracefully:
- A «graceful» shutdown where Jenkins goes through a full shutdown process, such as visiting
http://[jenkins-server]/exit
- A «dirty» shutdown, such as using
kill -9
to terminate the Jenkins process, may prevent incomplete pipelines from persisting data - Pipelines that cannot persist data may not be able to resume or displayed in Blue Ocean/Stage View/etc.
- Pipelines will generally write log data regardless of durability settings.
- Some modes use an «atomic write» option — this helps ensure that pipeline build files aren’t overwritten or left partially written if something fails.
- Atomic writes may place more stress on filesystems, so especially with networked storage it may be faster not to use them.
Note: defaults also be set globally under Manage Jenkins > Configure System.
hint
-
Values:
PERFORMANCE_OPTIMIZED
SURVIVABLE_NONATOMIC
MAX_SURVIVABILITY
- Previously, running pipelines wrote data constantly, so that they could resume even if Jenkins fails.
githubProjectProperty
-
projectUrlStr
-
Enter the URL for the GitHub hosted project (without the tree/master or tree/branch part).
For example:
https://github.com/rails/rails
for the Rails project.Type:String
displayName
(optional)-
This value will be used as context name for
commit status if status builder or
status publisher is defined for this project. It should be small and clear.If you leave it empty, job name will be used for builder and publisher.
Type:String
overrideIndexTriggers
-
Allows overriding default treatment of branch indexing triggers.
If branch indexing triggers are disabled at the multibranch or organization label, selecting this will enable them for this job only.
Otherwise, leaving the checkbox unselected will disable branch indexing triggers for this job only.
enableTriggers
-
Type:boolean
parameters
-
Parameters allow you to prompt users for one or more inputs that will be
passed into a build. For example, you might have a project that runs tests on
demand by allowing users to upload a zip file with binaries to be tested.
This could be done by adding a File Parameter here.
Or you might have a project that releases some software, and you want users to
enter release notes that will be uploaded along with the software. This could
be done by adding a Multi-line String Parameter here.Each parameter has a Name and some sort of Value, depending on
the parameter type. These name-value pairs will be exported as environment
variables when the build starts, allowing subsequent parts of the build
configuration (such as build steps) to access those values, e.g. by using the
${PARAMETER_NAME}
syntax (or%PARAMETER_NAME%
on Windows).
This also implies that each parameter defined here should have a unique
Name.When a project is parameterized, the usual Build Now link will be
replaced with a Build with Parameters link, where users will be
prompted to specify values for each of the defined parameters. If they choose
not to enter anything, the build will start with the default value for each
parameter.If a build is started automatically, for example if started by an SCM trigger,
the default values for each parameter will be used.When a parameterized build is in the queue, attempting to start another build
of the same project will only succeed if the parameter values are different,
or if the Execute concurrent builds if necessary option is enabled.See the Parameterized Builds documentation for more information about
this feature.parameterDefinitions
-
Array/List:
- Nested choice of objects
-
booleanParam
-
name
-
Type:String
defaultValue
(optional)-
Type:boolean
description
(optional)-
Type:String
choice
-
name
-
Type:String
description
(optional)-
Type:String
choices
(optional)-
- Nested choice of objects
- (not enumerable)
credentials
-
Defines a credentials parameter, which you can use during a build.
For security reasons, the credential is NOT directly exposed, the ID of the credential is exposed.
However, the selected credential is available through variable substitution in some other parts of the configuration.
The string value will be the ID of the credential. A supporting plugin can thus use the ID to retrieve
the selected credential and expose it to the build in an appropriate way.name
-
Type:String
defaultValue
-
The default credentials to use.
Type:String
credentialType
-
Type:String
required
-
When this option is selected, the credentials selection drop down will not provide the empty selection as one of
the options. This will not prevent a build without a value if there are no credentials available, for example
if the job does not have access to any credentials of the correct type or there is no default value and the
user starting the build either does not have any credentials of the correct type in their personal credentials
store or they do not have permissions on the job to use credentials from their personal store.Type:boolean
description
(optional)-
Type:String
file
-
name
-
Type:String
description
(optional)-
Type:String
$class: 'ListSubversionTagsParameterDefinition'
-
When used, this parameter will display a field at build-time so that the user
is able to select a Subversion tag from which to create the working copy for
this project.Once the two fields Name and Repository URL
are set, you must- ensure the job uses Subversion and
- set the Repository URL field of Subversion
by concatenating the two fields of this parameter.
For instance, if Name is set to
SVN_TAG
and
Repository URL is set tohttps://svn.jenkins-ci.org/tags
,
then Subversion‘s Repository URL must be set to
https://svn.jenkins-ci.org/tags/$SVN_TAG
.Notice that you can set the Repository URL field to a Subversion
repository root rather than just pointing to atags
dir (ie, you
can set it tohttps://svn.jenkins-ci.org
rather than
https://svn.jenkins-ci.org/tags
). In that case, if this repository
root contains thetrunk
,branches
andtags
folders, then the dropdown will allow the user to pick the trunk, or a
branch, or a tag.name
-
Type:String
tagsDir
-
Specify the Subversion repository URL which contains the tags to be listed
when triggering a new build.You can also specify the root of a Subversion repository: If this root contains
thetrunk
,branches
andtags
folders,
then the dropdown will displaytrunk
, all the branches and all the
tags. If the root does not contain these three folders, then all its subfolders
are listed in the dropdown.When you enter the URL, Jenkins automatically checks if it can connect to it.
If access requires authentication, you’ll be prompted for the necessary
credential. If you already have a working credential but would like to change
it for some other reasons, you can manage credentials and specify a different credential.Type:String
credentialsId
-
Type:String
tagsFilter
-
Specify a
regular expression which will be used to filter the tags which are actually
displayed when triggering a new build.Type:String
defaultValue
-
For features such as SVN polling a default value is required. If job will only
be started manually, this field is not necessary.Type:String
maxTags
-
The maximum number of tags to display in the dropdown. Any non-number value
will default to all.Type:String
reverseByDate
-
Check this option so that tags are sorted from the newest to the oldest.
If this option is checked, the Sort Z to A one won’t be taken into
account.Type:boolean
reverseByName
-
Check this option so that tags are displayed in reverse order (sorted Z to A).
Notice that if Sort newest first is checked, this option won’t be taken
into account.Type:boolean
description
(optional)-
Type:String
password
-
Pass a password to your build.
The password entered here is made available to the build in plain text as an environment variable like a string parameter would be.
The value will be stored encrypted on the Jenkins controller, similar to passwords in Jenkins configuration.name
-
Type:String
defaultValueAsSecret
-
org.kohsuke.stapler.NoStaplerConstructorException: There's no @DataBoundConstructor on any constructor of class hudson.util.Secret
description
(optional)-
Type:String
$class: 'PromotedBuildParameterDefinition'
-
name
-
Type:String
jobName
-
Type:String
process
-
Type:String
description
(optional)-
Type:String
run
-
name
-
Type:String
projectName
-
Type:String
filter
-
Values:
ALL
STABLE
SUCCESSFUL
COMPLETED
description
(optional)-
Type:String
string
-
name
-
Type:String
defaultValue
(optional)-
Type:String
description
(optional)-
Type:String
trim
(optional)-
Strip whitespace from the beginning and end of the string.
Type:boolean
text
-
name
-
Type:String
defaultValue
(optional)-
Type:String
description
(optional)-
Type:String
trim
(optional)-
Strip whitespace from the beginning and end of the string.
Type:boolean
pipelineTriggers
-
triggers
-
Array/List:
- Nested choice of objects
-
githubPush
-
When Jenkins receives a GitHub push hook, GitHub Plugin checks to see
whether the hook came from a GitHub repository which matches the Git repository defined in SCM/Git section of this job.
If they match and this option is enabled, GitHub Plugin triggers a one-time polling on GITScm.
When GITScm polls GitHub, it finds that there is a change and initiates a build.
The last sentence describes the behavior of Git plugin,
thus the polling and initiating the build is not a part of GitHub plugin. $class: 'PeriodicFolderTrigger'
-
Some kinds of folders are reindexed automatically and immediately upon receipt of an external event.
For example, a multi-branch project will recheck its SCM repository for new or removed or modified branches when it receives an SCM change notification.
(Push notification may be configured as per the SCM plugin used for each respective branch source.)
Such notifications can occasionally be unreliable, however, or Jenkins might not even be running to receive them.
In some cases no immediate notification is even possible, for example because Jenkins is behind a firewall and can only poll an external system.This trigger allows for a periodic fallback, but when necessary.
If no indexing has been performed in the specified interval, then an indexing will be scheduled.
For example, in the case of a multi-branch project, if the source control system is not configured for push notification, set a short interval (most people will pick between 15 minutes and 1 hour).
If the source control system is configured for push notification, set an interval that corresponds to the maximum acceptable delay in the event of a lost push notification as the last commit of the day.
(Subsequent commits should trigger indexing anyway and result in the commit being picked up, so most people will pick between 4 hours and 1 day.)interval
-
The maximum amount of time since the last indexing that is allowed to elapse before an indexing is triggered.
For example: interval(‘5m’) // or ‘2h’, ‘7d’, ‘5000ms’, ’60s’Type:String
$class: 'PromotionTrigger'
-
jobName
-
Type:String
process
-
Type:String
upstream
-
Set up a trigger so that when some other projects finish building,
a new build is scheduled for this project. This is convenient for running
an extensive test after a build is complete, for example.This configuration complements the «Build other projects» section
in the «Post-build Actions» of an upstream project, but is preferable when you want to configure the downstream project.upstreamProjects
-
Type:String
threshold
(optional)-
Type:String
pollSCM
-
Configure Jenkins to poll changes in SCM.
Note that this is going to be an expensive operation for CVS, as every polling
requires Jenkins to scan the entire workspace and verify it with the server.
Consider setting up a «push» trigger to avoid this overhead, as described in
this documentscmpoll_spec
-
Type:String
ignorePostCommitHooks
(optional)-
Ignore changes notified by SCM post-commit hooks.
This can be useful if you want to prevent some long-running jobs (e.g. reports) starting because of every commit, but still want to
run them periodic if SCM changes have occurred.Note that this option needs to be supported by the SCM plugin, too! The subversion-plugin supports this since version 1.44.
Type:boolean
cron
-
Provides a cron-like feature
to periodically execute this project.This feature is primarily for using Jenkins as a cron replacement,
and it is not ideal for continuously building software projects.When people first start continuous integration, they are often so used to
the idea of regularly scheduled builds like nightly/weekly that they use
this feature. However, the point of continuous integration is to start
a build as soon as a change is made, to provide a quick feedback to the change.
To do that you need to
hook up SCM change notification to Jenkins.So, before using this feature, stop and ask yourself if this is really what you want.
spec
-
Type:String
preserveStashes
-
Preserve the
stash
es from the most recent completed builds of this project.
This allows a restarted Declarative Pipeline to reuse astash
from the build it was restarted from.buildCount
(optional)-
Type:int
$class: 'RequiredResourcesProperty'
-
resourceNames
-
When a build is scheduled, it will attempt to lock the specified resources. If
some (or all) the resources are already locked by another build, the build will
be queued until they are released. It is possible to specify an amount for
requested resources below.Type:String
resourceNamesVar
-
Name for the Jenkins variable to store the reserved resources in. Leave empty
to disable.Type:String
resourceNumber
-
Number of resources to request, empty value or 0 means all.
This is useful, if you have a pool of similar resources, from which you want
one or more to be reserved.Type:String
labelName
-
If you have created a pool of resources, i.e. a label, you can take it into use
here. The build will select the resource(s) from the pool that includes all
resources sharing the given label.
Only one of Label, Groovy Expression or Resources fields may be specified.Type:String
resourceMatchScript
-
You can specify a groovy expression to be evaluated each time a resource is checked
to be appropriate for a build. The expression must result into a boolean value. The
following variables are available, in addition to optional arguments of the currently
evaluated build:- resourceName
- as per resource configuration
- resourceDescription
- as per resource configuration
- resourceLabels
java.util.List<String>
of labels as per resource configuration
For matrix jobs, axis names and axis values can be referenced as well. Examples:
resourceLabels.contains("hardcoded")
resourceLabels.contains(axisName)
resourceName == axisName
The script’s contents need to pass approval by the Script Security Plugin.
- Nested object
-
script
-
Type:String
sandbox
-
If checked, run this Groovy script in a sandbox with limited abilities.
If unchecked, and you are not a Jenkins administrator, you will need to wait for an administrator to approve the script.Type:boolean
classpath
-
Additional classpath entries accessible from the script.
Array/List:
- Nested object
-
path
-
A path or URL to a JAR file.
This path should be approved by an administrator or a user with the RUN_SCRIPT permission, or the script fails.
If the file or files are once approved, they are treated approved even located in another path.Type:String
oldPath
(optional)-
Type:String
shouldBeApproved
(optional)-
Type:boolean
oldScript
(optional)-
Type:String
throttleJobProperty
-
Note that the Throttle Concurrent Builds configuration here does not work for Pipeline jobs.
For that, use the
throttle
step.maxConcurrentPerNode
-
The maximum number of concurrent builds of this project (or category) to be allowed to run per node.
Type:int
maxConcurrentTotal
-
The maximum number of concurrent builds of this project (or category) to be allowed to run at any one time, across all nodes.
Type:int
categories
-
Categories can be used to throttle multiple projects.
Categories can be optionally configured with pairs of throttled Jenkins node labels.
Pairs can make each maximum applicable to nodes with matching labels only.
That is achieved by adding such Maximum Per Labeled Node pair(s) to any category.
Category’s Maximum Concurrent Builds Per Node is superseded by matching-pair’s maximum. throttleEnabled
-
Type:boolean
throttleOption
-
Type:String
limitOneJobWithMatchingParams
-
If this box is checked, only one instance of the job with matching parameter values will be allowed to run at a given time.
Other instances of this job with different parameter values will be allowed to run concurrently.Optionally, provide a comma- or whitespace-separated list of parameters to use when comparing jobs. If blank, all parameters
must match for a job to be limited to one running instance.Type:boolean
paramsToUseForLimit
-
Type:String
matrixOptions
-
- Nested object
-
throttleMatrixBuilds
-
Type:boolean
throttleMatrixConfigurations
-
Type:boolean
rateLimitBuilds
-
throttle
-
Enforces a minimum time between builds based on the desired maximum rate.
Note: this does
not enforce an «average» rate, it only looks at the time since last build.- Nested object
-
count
-
Type:int
durationName
-
Type:String
userBoost
-
Type:boolean
publishChecks
: Publish customized checks to SCM platformsactions
(optional)-
Array/List:
- Nested object
-
label
-
The label to be displayed on the checks report for this action.
Type:String
identifier
-
The unique identifier for the action. Since for SCM platforms like GitHub, this is the only field that would be
sent back to your Jenkins instance when an action is requested, so you may need to use this field to have more
information besides the basic type of the action.Type:String
description
(optional)-
Detailed description of the action’s purpose, functionality, and so on.
Type:String
annotations
(optional)-
Array/List:
- Nested object
-
path
-
Path to the file to be annotated, started from the project root directory.
Type:String
startLine
-
Start line of code to be annotated.
Type:int
endLine
-
End line of code to be annotated.
Type:int
message
-
A digest message of the annotation.
Type:String
annotationLevel
(optional)-
Severity level of the annotation, can be one of can be «NOTICE», «WARNING», or «FAILURE»; by default, «WARNING» will
be used.Values:
NONE
NOTICE
WARNING
FAILURE
endColumn
(optional)-
End column of code to be annotated.
Type:int
rawDetails
(optional)-
Raw details of the annotation.
Type:String
startColumn
(optional)-
Start column of code to be annotated.
Type:int
title
(optional)-
Type:String
conclusion
(optional)-
The conclusion of the check, can be «ACTION_REQUIRED», «SKIPPED», «CANCELED», «TIME_OUT», «FAILURE», «NEUTRAL»,
«SUCCESS» or «NONE». By default, «SUCCESS» will be used. When providing the conclusion other than «NONE», please
make sure the status is «COMPLETED».Values:
NONE
ACTION_REQUIRED
SKIPPED
CANCELED
TIME_OUT
FAILURE
NEUTRAL
SUCCESS
detailsURL
(optional)-
The URL of the site where full details can be found. When providing this parameter, make sure it is http or https
scheme.Type:String
name
(optional)-
Name or identifier of the check.
Type:String
status
(optional)-
The status of the check, can be «QUEUED», «IN_PROGRESS», or «COMPLETED». By default, «COMPLETED» will be used.
Values:
NONE
QUEUED
IN_PROGRESS
COMPLETED
summary
(optional)-
The summary of the check run. This field supports Markdown.
Type:String
text
(optional)-
The details of the check. This parameter supports Markdown.
Type:String
title
(optional)-
The title of the check run.
Type:String
publishHTML
: Publish HTML reportstarget
-
- Nested object
-
reportName
-
The name of the report to display for the build/project, such as «Code Coverage»
Type:String
reportDir
-
The path to the HTML report directory relative to the workspace.
Type:String
reportFiles
-
The file(s) to provide links inside the report directory
Type:String
keepAll
-
If checked, archive reports for all successful builds, otherwise only the most recent
Type:boolean
alwaysLinkToLastBuild
-
If this control and «Keep past HTML reports» are checked,
publish the link on project level even if build failed.Type:boolean
allowMissing
-
If checked, will allow report to be missing and build will not fail on missing report
Type:boolean
escapeUnderscores
(optional)-
If checked, underscores in the report title will be escaped to ‘_5f’ when stored on disk. If unchecked, they will not be escaped.
Type:boolean
includes
(optional)-
Type:String
reportTitles
(optional)-
The optional title(s) for the report files, which will be used as the tab names. If this is not provided, file names will be used instead.
Type:String
publishIssues
: Publish issues created by a static analysis scanissues
-
Array/List:
org.kohsuke.stapler.NoStaplerConstructorException: There's no @DataBoundConstructor on any constructor of class io.jenkins.plugins.analysis.core.steps.AnnotatedReport
failOnError
(optional)-
If there are errors while scanning the console log or files for issues (e.g., file pattern matches no files, source files
could not be copied, etc.) then the warning plugin will show these errors in a separate view but does not alter
the build state. If you would rather like to fail the build on such errors, please tick this checkbox.Type:boolean
failedNewAll
(optional)-
Type:int
failedNewHigh
(optional)-
Type:int
failedNewLow
(optional)-
Type:int
failedNewNormal
(optional)-
Type:int
failedTotalAll
(optional)-
Type:int
failedTotalHigh
(optional)-
Type:int
failedTotalLow
(optional)-
Type:int
failedTotalNormal
(optional)-
Type:int
healthy
(optional)-
The healthy threshold defines the limit of warnings for a healthy result: A build is considered as 100% healthy
when the number of issues is less than the specified threshold. Values less or equal zero are ignored.
So if you want to have a healthy build (i.e. 100%) only for zero warnings, then set this field to 1.Type:int
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expressionp{Alnum}[p{Alnum}-_]*
).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
ignoreFailedBuilds
(optional)-
This option determines if failed builds should be selected as baseline or not.
It is enabled by default, since analysis results might be inaccurate if the build failed.
If unchecked, every build that contains a static analysis result is considered, even if the build failed.Type:boolean
ignoreQualityGate
(optional)-
If this option is set, only those issues are marked as new, that have been introduced in the current build.
Previously new issues in older builds will be converted to outstanding issues. I.e. if someone starts a new
build manually (without source code changes), then no new issues will be in the job anymore.By default, this option is disabled: then a build is selected as reference that passed all quality gates.
As soon as a build fails a quality gate, the reference will be frozen until all new issues
will be resolved again. That means, that new issues will be aggregated from build to build until the
original reason for the failure and all those additional new issues have been resolved. This helps much more
to keep your project clean: as soon as there are issues, Jenkins will mark all builds as unstable until
the issues have been resolved.Type:boolean
minimumSeverity
(optional)-
Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
publishAllIssues
(optional)-
Type:boolean
qualityGates
(optional)-
Array/List:
- Nested object
-
threshold
-
The threshold defines the minimum number of warnings that will fail a build. Values less or equal zero are ignored.
So if you want to fail a build that has one warning, set this field to 1.Type:int
type
-
In order to simplify the user interface you can select the property that will be compared with the specified
threshold. Basically, three different properties are available:- Total
- Selects the total number of issues in the current build.
- New
- Selects the total number of new issues in the current build with respect to the reference build.
New issues will be calculated by a sophisticated algorithm,
that tries to track issues from build to build, even if the source code has been modified. Note that this
algorithm sometimes detects outstanding warnings as new, e.g., if a source file has been refactored heavily. - Delta
- Selects the difference of the total number of issues of the current build subtracted by the total
number of issues in the reference build. This is a simple subtraction, so if you have a build that
adds a new warning and removes a completely different warning, then the result will be zero.
Additionally, you can select to choose all issues, or issues of a given severity only (error, high, normal or low).
Values:
TOTAL
TOTAL_ERROR
TOTAL_HIGH
TOTAL_NORMAL
TOTAL_LOW
NEW
NEW_ERROR
NEW_HIGH
NEW_NORMAL
NEW_LOW
DELTA
DELTA_ERROR
DELTA_HIGH
DELTA_NORMAL
DELTA_LOW
unstable
-
Type:boolean
referenceBuildId
(optional)-
Type:String
referenceJobName
(optional)-
Type:String
skipPublishingChecks
(optional)-
If this option is unchecked, then the plugin automatically publishes the issues to corresponding SCM hosting platforms.
For example, if you are using this feature for a GitHub organization project, the warnings will be published to
GitHub through the Checks API. If this operation slows down your build or you don’t want to publish the warnings to
SCM platforms, you can use this option to deactivate this feature.Type:boolean
sourceCodeEncoding
(optional)-
In order to correctly show all your affected source code files in the detail views,
the plugin must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
trendChartType
(optional)-
If there is more than one static analysis result available then an aggregation trend chart will be shown
on the project page that shows the analysis results in a single trend chart. You can choose the position of
this aggregation trend:- AGGREGATION_TOOLS
- The aggregation trend is shown before all other analysis tool trend charts.
- TOOLS_AGGREGATION
- The aggregation trend is shown after all other analysis tool trend charts.
- TOOLS_ONLY
- The aggregation trend is not shown, only the analysis tool trend charts are shown.
- AGGREGATION_ONLY
- The aggregation trend is only shown, no other analysis tool trend charts are shown.
- NONE
- Neither the aggregation trend nor analysis tool trend charts are shown.
Values:
AGGREGATION_TOOLS
TOOLS_AGGREGATION
TOOLS_ONLY
AGGREGATION_ONLY
NONE
unhealthy
(optional)-
The unhealthy threshold defines the limit of warnings for an unhealthy result: A build is considered as unhealthy
(i.e. 0% health) when the number of issues is greater than the specified threshold. Values less or equal zero are ignored.
So if you want to have a build health of 0% starting with 10 issues, then set this field to 9.Type:int
unstableNewAll
(optional)-
Type:int
unstableNewHigh
(optional)-
Type:int
unstableNewLow
(optional)-
Type:int
unstableNewNormal
(optional)-
Type:int
unstableTotalAll
(optional)-
Type:int
unstableTotalHigh
(optional)-
Type:int
unstableTotalLow
(optional)-
Type:int
unstableTotalNormal
(optional)-
Type:int
pwd
: Determine current directoryReturns the current directory path as a string.
tmp
(optional)-
If selected, return a temporary directory associated with the current directory path rather than the directory path itself.
The return value is different for each current directory. No two directories share the same temporary directory.
This is an appropriate place to put temporary files which should not clutter a source checkout;
local repositories or caches; etc. Defaults to false.Type:boolean
pwsh
: PowerShell Core Scriptscript
-
Type:String
encoding
(optional)-
Encoding of process output.
In the case ofreturnStdout
, applies to the return value of this step;
otherwise, or always for standard error, controls how text is copied to the build log.
If unspecified, uses the system default encoding of the node on which the step is run.
If there is any expectation that process output might include non-ASCII characters,
it is best to specify the encoding explicitly.
For example, if you have specific knowledge that a given process is going to be producing UTF-8
yet will be running on a node with a different system encoding
(typically Windows, since every Linux distribution has defaulted to UTF-8 for a long time),
you can ensure correct output by specifying:encoding: 'UTF-8'
Type:String
label
(optional)-
Label to be displayed in the pipeline step view and blue ocean details for the step instead of the step type.
So the view is more meaningful and domain specific instead of technical.Type:String
returnStatus
(optional)-
Normally, a script which exits with a nonzero status code will cause the step to fail with an exception.
If this option is checked, the return value of the step will instead be the status code.
You may then compare it to zero, for example.Type:boolean
returnStdout
(optional)-
If checked, standard output from the task is returned as the step value as a
String
,
rather than being printed to the build log.
(Standard error, if any, will still be printed to the log.)
You will often want to call.trim()
on the result to strip off a trailing newline.Type:boolean
readCSV
: Read content from a CSV file in the workspace.
Reads a file in the current working directory or a String as a plain text.
A List of CSVRecord instances is returned
Example:
def records = readCSV file: 'dir/input.csv'
assert records[0][0] == 'key'
assert records[1][1] == 'b'
def content = readCSV text: 'key,valuena,b'
assert records[0][0] == 'key'
assert records[1][1] == 'b'
Advanced Example:
def excelFormat = CSVFormat.EXCEL
def records = readCSV file: 'dir/input.csv', format: excelFormat
assert records[0][0] == 'key'
assert records[1][1] == 'b'
def content = readCSV text: 'key,valuena,b', format: CSVFormat.DEFAULT.withHeader()
assert records[1].get('key') == 'a'
assert records[1].get('value') == 'b'
file
(optional)-
Path to a file in the workspace from which to read the CSV data.
Data is accessed as a List of String Arrays.You can only specify
file
ortext
, not both in the same invocation.Type:String
format
(optional)-
org.kohsuke.stapler.NoStaplerConstructorException: There's no @DataBoundConstructor on any constructor of class org.apache.commons.csv.CSVFormat
text
(optional)-
A string containing the CSV formatted data.
Data is accessed as a List of String Arrays.You can only specify
file
ortext
, not both in the same invocation.Type:String
readFile
: Read file from workspaceReads a file from a relative path (with root in current directory, usually workspace) and returns its content as a plain string.
file
-
Relative (
/
-separated) path to file within a workspace to read.Type:String
encoding
(optional)-
The encoding to use when reading the file.
If left blank, the platform default encoding will be used.
Binary files can be read into a Base64-encoded string by specifying «Base64» as the encoding.Type:String
readJSON
: Read JSON from files in the workspace.
Reads a file in the current working directory or a String as a plain text
JSON file.
The returned object is a normal Map with String keys or a List of primitives or Map.
Example:
def props = readJSON file: 'dir/input.json'
assert props['attr1'] == 'One'
assert props.attr1 == 'One'
def props = readJSON text: '{ "key": "value" }'
assert props['key'] == 'value'
assert props.key == 'value'
def props = readJSON text: '[ "a", "b"]'
assert props[0] == 'a'
assert props[1] == 'b'
def props = readJSON text: '{ "key": null, "a": "b" }', returnPojo: true
assert props['key'] == null
props.each { key, value ->
echo "Walked through key $key and value $value"
}
file
(optional)-
Path to a file in the workspace from which to read the JSON data.
Data could be access as an array or a map.You can only specify
file
ortext
, not both in the same invocation.Type:String
returnPojo
(optional)-
Transforms the output into a POJO type (
LinkedHashMap
orArrayList
) before returning it.By default deactivated (
false
), and a JSON object (JSONObject
orJSONArray
from json-lib) is returned.Type:boolean
text
(optional)-
A string containing the JSON formatted data.
Data could be access as an array or a map.You can only specify
file
ortext
, not both in the same invocation.Type:String
readManifest
: Read a Jar Manifest
Reads a
Jar Manifest
file or text and parses it into a set of Maps.
The returned data structure has two properties: main
for the main attributes,
and entries
containing each individual section (except for main).
Example:
def man = readManifest file: 'target/my.jar'
assert man.main['Version'] == '6.15.8'
assert man.main['Application-Name'] == 'My App'
assert man.entries['Section1']['Key1'] == 'value1-1'
assert man.entries['Section2']['Key2'] == 'value2-2'
file
(optional)-
Optional path to a file to read.
It could be a plain text,.jar
,.war
or.ear
.
In the latter cases the manifest will be extracted from the archive and then read.You can only specify
file
ortext
, not both in the same invocation.Type:String
text
(optional)-
Optional text containing the manifest data.
You can only specify
file
ortext
, not both in the same invocation.Type:String
readMavenPom
: Read a maven project file.
Reads a
Maven project
file.
The returned object is a
Model .
Avoid using this step and writeMavenPom
.
It is better to use the sh
step to run mvn
goals.
For example:
def version = sh script: 'mvn help:evaluate -Dexpression=project.version -q -DforceStdout', returnStdout: true
file
(optional)-
Optional path to the file to read.
If left empty the step will try to readpom.xml
in the current working directory.Type:String
readProperties
: Read properties from files in the workspace or text.
Reads a file in the current working directory or a String as a plain text
Java Properties
file.
The returned object is a normal Map with String keys.
The map can also be pre loaded with default values before reading/parsing the data.
Fields:
-
file
:
Optional path to a file in the workspace to read the properties from.
These are added to the resulting map after the defaults and so will overwrite any key/value pairs already present. -
text
:
An Optional String containing properties formatted data.
These are added to the resulting map afterfile
and so will overwrite any key/value pairs already present. -
defaults
:
An Optional Map containing default key/values.
These are added to the resulting map first. -
interpolate
:
Flag to indicate if the properties should be interpolated or not.
In case of error or cycling dependencies, the original properties will be returned.
Example:
def d = [test: 'Default', something: 'Default', other: 'Default']
def props = readProperties defaults: d, file: 'dir/my.properties', text: 'other=Override'
assert props['test'] == 'One'
assert props['something'] == 'Default'
assert props.something == 'Default'
assert props.other == 'Override'
Example with interpolation:
def props = readProperties interpolate: true, file: 'test.properties' assert props.url = 'http://localhost' assert props.resource = 'README.txt' // if fullUrl is defined to ${url}/${resource} then it should evaluate to http://localhost/README.txt assert props.fullUrl = 'http://localhost/README.txt'
defaults
(optional)-
java.lang.UnsupportedOperationException: do not know how to categorize attributes of type java.util.Map<java.lang.Object, java.lang.Object>
file
(optional)-
Type:String
interpolate
(optional)-
Type:boolean
text
(optional)-
Type:String
readTrusted
: Read trusted file from SCM
From a multibranch Pipeline project, reads a file from the associated SCM and returns its contents.
Unlike the readFile
step, no workspace is required.
If the associated branch is not trusted, yet the file has been modified from its trusted version, an error is thrown.
Thus this step is useful for loading scripts or other files which might otherwise be used to run malicious commands.
Like checkout scm
, as a convenience it may also be used from a standalone project configured with Pipeline from SCM,
in which case there is no security aspect.
path
-
Relative (slash-separated) path to the file from the SCM root.
ThusreadTrusted 'subdir/file'
is similar tonode {checkout scm; readFile 'subdir/file'}
.Type:String
readYaml
: Read yaml from files in the workspace or text.
Reads a file in the current working directory or a String as a plain text YAML file.
It uses SnakeYAML as YAML processor.
The returned objects are standard Java objects like List, Long, String, …:
bool: [true, false, on, off]
int: 42
float: 3.14159
list: [‘LITE’, ‘RES_ACID’, ‘SUS_DEXT’]
map: {hp: 13, sp: 5}
Fields:
-
file
:
Optional path to a file in the workspace to read the YAML datas from. -
text
:
An Optional String containing YAML formatted datas.
These are added to the resulting object afterfile
and so will overwrite any value already present if not a new YAML document
Examples:
With only one YAML document :
def datas = readYaml text: """
something: 'my datas'
size: 3
isEmpty: false
"""
assert datas.something == 'my datas'
assert datas.size == 3
assert datas.isEmpty == false
With several YAML documents :
def datas = readYaml text: """ --- something: 'my first document' --- something: 'my second document' """ assert datas.size() == 2 assert datas[0].something == 'my first document' assert datas[1].something == 'my second document'
With file dir/my.yml containing something: 'my datas'
:
def datas = readYaml file: 'dir/my.yml', text: "something: 'Override'" assert datas.something == 'Override'
file
(optional)-
Type:String
text
(optional)-
Type:String
recordIssues
: Record compiler warnings and static analysis resultsaggregatingResults
(optional)-
By default, each static analysis result will be recorded as a separate result
that is presented as an individual Jenkins Action with separate UI and dashboard. If you rather prefer aggregation
of the results into a single result (i.e., single Jenkins Action), then activate this check box. You still can
see the distribution of issues grouped by static analysis tool in the UI.Type:boolean
blameDisabled
(optional)-
If this option is unchecked, then the plugin automatically shows what revision and author (name and email)
last modified the lines of the affected files that contain issues. If this operation slows down your build or
you don’t want to publish sensitive user data, you can use this option to deactivate this feature.Type:boolean
enabledForFailure
(optional)-
By default, static analysis results are only recorded for stable or unstable builds, but not for failed builds:
analysis results might be inaccurate if the build failed. If recording should be enabled for failed builds as well
then activate this check box.Type:boolean
failOnError
(optional)-
If there are errors while scanning the console log or files for issues (e.g., file pattern matches no files, source files
could not be copied, etc.) then the warning plugin will show these errors in a separate view but does not alter
the build state. If you would rather like to fail the build on such errors, please tick this checkbox.Type:boolean
failedNewAll
(optional)-
Type:int
failedNewHigh
(optional)-
Type:int
failedNewLow
(optional)-
Type:int
failedNewNormal
(optional)-
Type:int
failedTotalAll
(optional)-
Type:int
failedTotalHigh
(optional)-
Type:int
failedTotalLow
(optional)-
Type:int
failedTotalNormal
(optional)-
Type:int
filters
(optional)-
The created report of issues can be filtered afterwards. You can specify an arbitrary number of include or exclude
filters. Currently, there is support for filtering issues by module name, package or namespace name, file name,
category or type. Include filters will be combined withor
, exclude filters withand
.
If no filter is defined, then all issues will be published. Filters with empty regular expression will be ignored.Array/List:
- Nested choice of objects
-
excludeCategory
-
pattern
-
Type:String
excludeFile
-
pattern
-
Type:String
excludeMessage
-
pattern
-
Type:String
excludeModule
-
pattern
-
Type:String
excludePackage
-
pattern
-
Type:String
excludeType
-
pattern
-
Type:String
includeCategory
-
pattern
-
Type:String
includeFile
-
pattern
-
Type:String
includeMessage
-
pattern
-
Type:String
includeModule
-
pattern
-
Type:String
includePackage
-
pattern
-
Type:String
includeType
-
pattern
-
Type:String
forensicsDisabled
(optional)-
Type:boolean
healthy
(optional)-
The healthy threshold defines the limit of warnings for a healthy result: A build is considered as 100% healthy
when the number of issues is less than the specified threshold. Values less or equal zero are ignored.
So if you want to have a healthy build (i.e. 100%) only for zero warnings, then set this field to 1.Type:int
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expressionp{Alnum}[p{Alnum}-_]*
).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
ignoreFailedBuilds
(optional)-
This option determines if failed builds should be selected as baseline or not.
It is enabled by default, since analysis results might be inaccurate if the build failed.
If unchecked, every build that contains a static analysis result is considered, even if the build failed.Type:boolean
ignoreQualityGate
(optional)-
If this option is set, only those issues are marked as new, that have been introduced in the current build.
Previously new issues in older builds will be converted to outstanding issues. I.e. if someone starts a new
build manually (without source code changes), then no new issues will be in the job anymore.By default, this option is disabled: then a build is selected as reference that passed all quality gates.
As soon as a build fails a quality gate, the reference will be frozen until all new issues
will be resolved again. That means, that new issues will be aggregated from build to build until the
original reason for the failure and all those additional new issues have been resolved. This helps much more
to keep your project clean: as soon as there are issues, Jenkins will mark all builds as unstable until
the issues have been resolved.Type:boolean
minimumSeverity
(optional)-
Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
publishAllIssues
(optional)-
Type:boolean
qualityGates
(optional)-
Array/List:
- Nested object
-
threshold
-
The threshold defines the minimum number of warnings that will fail a build. Values less or equal zero are ignored.
So if you want to fail a build that has one warning, set this field to 1.Type:int
type
-
In order to simplify the user interface you can select the property that will be compared with the specified
threshold. Basically, three different properties are available:- Total
- Selects the total number of issues in the current build.
- New
- Selects the total number of new issues in the current build with respect to the reference build.
New issues will be calculated by a sophisticated algorithm,
that tries to track issues from build to build, even if the source code has been modified. Note that this
algorithm sometimes detects outstanding warnings as new, e.g., if a source file has been refactored heavily. - Delta
- Selects the difference of the total number of issues of the current build subtracted by the total
number of issues in the reference build. This is a simple subtraction, so if you have a build that
adds a new warning and removes a completely different warning, then the result will be zero.
Additionally, you can select to choose all issues, or issues of a given severity only (error, high, normal or low).
Values:
TOTAL
TOTAL_ERROR
TOTAL_HIGH
TOTAL_NORMAL
TOTAL_LOW
NEW
NEW_ERROR
NEW_HIGH
NEW_NORMAL
NEW_LOW
DELTA
DELTA_ERROR
DELTA_HIGH
DELTA_NORMAL
DELTA_LOW
unstable
-
Type:boolean
referenceBuildId
(optional)-
Type:String
referenceJobName
(optional)-
Type:String
scm
(optional)-
Type:String
skipBlames
(optional)-
Type:boolean
skipPublishingChecks
(optional)-
If this option is unchecked, then the plugin automatically publishes the issues to corresponding SCM hosting platforms.
For example, if you are using this feature for a GitHub organization project, the warnings will be published to
GitHub through the Checks API. If this operation slows down your build or you don’t want to publish the warnings to
SCM platforms, you can use this option to deactivate this feature.Type:boolean
sourceCodeEncoding
(optional)-
In order to correctly show all your affected source code files in the detail views,
the plugin must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
sourceDirectories
(optional)-
Some plugins copy source code files to Jenkins’ build folder so that these files can be rendered in the user
interface together with build results (coverage, warnings, etc.). If these files are not part of the workspace
of a build then Jenkins will not show them by default: otherwise sensitive files could be shown by accident.
You can provide a list of additional source code directories that are allowed to be shown in Jenkins user interface
here. Note, that such a directory must be an absolute path on the agent that executes the build.Array/List:
- Nested object
-
path
-
This plugin copies source code files to Jenkins’ build folder so that these files can be rendered in the user
interface together with the plugin results. If these files are referenced with relative paths then they cannot
be found by the plugin. In these cases you need to specify one or more relative paths within the workspace where
the plugin can locate them. Alternatively, you can also specify absolute paths if the source code files are stored
outside the workspace (in a directory on the agent). All absolute paths must be additionally approved by an
administrator in Jenkins’ global configuration page.Type:String
sourceDirectory
(optional)-
Type:String
tool
(optional)-
For each static analysis tool a dedicated parser or scanner will be used to read report files or produce issues in
any other way. If your tool is not yet supported you can define a new Groovy based parser in Jenkins
system configuration. You can reference this new parser afterwards when you select the tool ‘Groovy Parser’.
Additionally, you provide a new parser within a new small plug-in. If the parser is useful for other teams
as well please share it and provide pull requests for the
Warnings Next Generation Plug-in and
the Analysis Parsers Library.- Nested choice of objects
-
acuCobol
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
ajc
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
androidLintParser
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
ansibleLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
aquaScanner
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
armCc
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
axivionSuite
-
basedir
(optional)-
Type:String
credentialsId
(optional)-
Type:String
id
(optional)-
Type:String
name
(optional)-
Type:String
namedFilter
(optional)-
Type:String
projectUrl
(optional)-
Type:String
bluepearl
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
brakeman
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
buckminster
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
cadence
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
cargo
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
ccm
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
checkStyle
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
clair
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
clang
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
clangAnalyzer
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
clangTidy
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
cmake
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
codeAnalysis
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
codeChecker
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
codeNarc
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
coolflux
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
cpd
-
highThreshold
(optional)-
Type:int
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
normalThreshold
(optional)-
Type:int
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
cppCheck
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
cppLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
cssLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
dscanner
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
dart
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
detekt
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
diabC
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
docFx
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
dockerLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
doxygen
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
drMemory
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
dupFinder
-
highThreshold
(optional)-
Type:int
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
normalThreshold
(optional)-
Type:int
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
eclipse
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
erlc
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
errorProne
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
esLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
findBugs
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
useRankAsPriority
(optional)-
Type:boolean
flake8
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
flawfinder
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
flexSdk
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
fxcop
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
gcc3
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
gcc
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
gendarme
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
ghsMulti
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
gnat
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
gnuFortran
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
goLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
goVet
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
groovyScript
-
parserId
-
Type:String
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
hadoLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
iar
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
iarCstat
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
ibLinter
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
ideaInspection
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
infer
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
intel
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
invalids
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
junitParser
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
java
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
javaDoc
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
jcReport
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
jsHint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
jsLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
klocWork
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
kotlin
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
ktLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
mavenConsole
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
modelsim
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
metrowerksCodeWarrior
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
msBuild
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
myPy
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
nagFortran
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
oelintAdv
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
otDockerLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
taskScanner
-
excludePattern
(optional)-
Type:String
highTags
(optional)-
Type:String
id
(optional)-
Type:String
ignoreCase
(optional)-
Type:boolean
includePattern
(optional)-
You can define multiple filesets using comma as a separator, e.g. ‘**/*.c, **/*.h’.
Basedir of the fileset is the workspace root.Type:String
isRegularExpression
(optional)-
Note that the regular expression must contain two capturing groups:
the first one is interpreted as tag name, the second one as message.
An example of such a regular expression would be^.*(TODO(?:[0-9]*))(.*)$
.Type:boolean
lowTags
(optional)-
Type:String
name
(optional)-
Type:String
normalTags
(optional)-
Type:String
owaspDependencyCheck
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
PVSStudio
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
pcLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
pep8
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
perforce
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
perlCritic
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
php
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
phpCodeSniffer
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
phpStan
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
pit
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
pmdParser
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
prefast
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
protoLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
puppetLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
pyDocStyle
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
pyLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
qacSourceCodeAnalyser
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
qtTranslation
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
analysisParser
-
analysisModelId
-
Type:String
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
resharperInspectCode
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
revApi
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
rfLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
robocopy
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
ruboCop
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
sarif
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
scala
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
simian
-
highThreshold
(optional)-
Type:int
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
normalThreshold
(optional)-
Type:int
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
sonarQube
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
sphinxBuild
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
spotBugs
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
useRankAsPriority
(optional)-
Type:boolean
styleCop
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
styleLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
sunC
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
swiftLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
tagList
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
taskingVx
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
tiCss
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
tnsdl
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
trivy
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
tsLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
veracodePipelineScanner
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
issues
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
xlc
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
xmlLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
yamlLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
yuiCompressor
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
zptLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
toolProxies
(optional)-
For each static analysis tool a dedicated parser or scanner will be used to read report files or produce issues in
any other way. If your tool is not yet supported you can define a new Groovy based parser in Jenkins
system configuration. You can reference this new parser afterwards when you select the tool ‘Groovy Parser’.
Additionally, you provide a new parser within a new small plug-in. If the parser is useful for other teams
as well please share it and provide pull requests for the
Warnings Next Generation Plug-in and
the Analysis Parsers Library.Array/List:
- Nested object
-
tool
-
For each static analysis tool a dedicated parser or scanner will be used to read report files or produce issues in
any other way. If your tool is not yet supported you can define a new Groovy based parser in Jenkins
system configuration. You can reference this new parser afterwards when you select the tool ‘Groovy Parser’.
Additionally, you provide a new parser within a new small plug-in. If the parser is useful for other teams
as well please share it and provide pull requests for the
Warnings Next Generation Plug-in and
the Analysis Parsers Library.- Nested choice of objects
-
acuCobol
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
ajc
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
androidLintParser
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
ansibleLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
aquaScanner
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
armCc
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
axivionSuite
-
basedir
(optional)-
Type:String
credentialsId
(optional)-
Type:String
id
(optional)-
Type:String
name
(optional)-
Type:String
namedFilter
(optional)-
Type:String
projectUrl
(optional)-
Type:String
bluepearl
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
brakeman
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
buckminster
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
cadence
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
cargo
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
ccm
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
checkStyle
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
clair
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
clang
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
clangAnalyzer
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
clangTidy
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
cmake
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
codeAnalysis
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
codeChecker
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
codeNarc
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
coolflux
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
cpd
-
highThreshold
(optional)-
Type:int
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
normalThreshold
(optional)-
Type:int
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
cppCheck
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
cppLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
cssLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
dscanner
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
dart
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
detekt
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
diabC
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
docFx
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
dockerLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
doxygen
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
drMemory
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
dupFinder
-
highThreshold
(optional)-
Type:int
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
normalThreshold
(optional)-
Type:int
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
eclipse
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
erlc
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
errorProne
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
esLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
findBugs
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
useRankAsPriority
(optional)-
Type:boolean
flake8
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
flawfinder
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
flexSdk
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
fxcop
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
gcc3
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
gcc
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
gendarme
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
ghsMulti
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
gnat
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
gnuFortran
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
goLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
goVet
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
groovyScript
-
parserId
-
Type:String
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
hadoLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
iar
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
iarCstat
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
ibLinter
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
ideaInspection
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
infer
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
intel
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
invalids
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
junitParser
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
java
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
javaDoc
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
jcReport
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
jsHint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
jsLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
klocWork
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
kotlin
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
ktLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
mavenConsole
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
modelsim
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
metrowerksCodeWarrior
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
msBuild
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
myPy
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
nagFortran
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
oelintAdv
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
otDockerLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
taskScanner
-
excludePattern
(optional)-
Type:String
highTags
(optional)-
Type:String
id
(optional)-
Type:String
ignoreCase
(optional)-
Type:boolean
includePattern
(optional)-
You can define multiple filesets using comma as a separator, e.g. ‘**/*.c, **/*.h’.
Basedir of the fileset is the workspace root.Type:String
isRegularExpression
(optional)-
Note that the regular expression must contain two capturing groups:
the first one is interpreted as tag name, the second one as message.
An example of such a regular expression would be^.*(TODO(?:[0-9]*))(.*)$
.Type:boolean
lowTags
(optional)-
Type:String
name
(optional)-
Type:String
normalTags
(optional)-
Type:String
owaspDependencyCheck
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
PVSStudio
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
pcLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
pep8
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
perforce
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
perlCritic
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
php
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
phpCodeSniffer
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
phpStan
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
pit
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
pmdParser
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
prefast
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
protoLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
puppetLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
pyDocStyle
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
pyLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
qacSourceCodeAnalyser
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
qtTranslation
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
analysisParser
-
analysisModelId
-
Type:String
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
resharperInspectCode
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
revApi
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
rfLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
robocopy
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
ruboCop
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
sarif
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
scala
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
simian
-
highThreshold
(optional)-
Type:int
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
normalThreshold
(optional)-
Type:int
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
sonarQube
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
sphinxBuild
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
spotBugs
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
useRankAsPriority
(optional)-
Type:boolean
styleCop
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
styleLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
sunC
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
swiftLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
tagList
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
taskingVx
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
tiCss
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
tnsdl
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
trivy
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
tsLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
veracodePipelineScanner
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
issues
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
xlc
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
xmlLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
yamlLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
yuiCompressor
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
zptLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
tools
(optional)-
Array/List:
- Nested choice of objects
-
acuCobol
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
ajc
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
androidLintParser
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
ansibleLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
aquaScanner
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
armCc
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
axivionSuite
-
basedir
(optional)-
Type:String
credentialsId
(optional)-
Type:String
id
(optional)-
Type:String
name
(optional)-
Type:String
namedFilter
(optional)-
Type:String
projectUrl
(optional)-
Type:String
bluepearl
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
brakeman
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
buckminster
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
cadence
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
cargo
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
ccm
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
checkStyle
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
clair
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
clang
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
clangAnalyzer
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
clangTidy
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
cmake
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
codeAnalysis
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
codeChecker
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
codeNarc
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
coolflux
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
cpd
-
highThreshold
(optional)-
Type:int
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
normalThreshold
(optional)-
Type:int
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
cppCheck
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
cppLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
cssLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
dscanner
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
dart
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
detekt
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
diabC
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
docFx
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
dockerLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
doxygen
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
drMemory
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
dupFinder
-
highThreshold
(optional)-
Type:int
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
normalThreshold
(optional)-
Type:int
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
eclipse
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
erlc
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
errorProne
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
esLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
findBugs
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
useRankAsPriority
(optional)-
Type:boolean
flake8
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
flawfinder
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
flexSdk
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
fxcop
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
gcc3
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
gcc
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
gendarme
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
ghsMulti
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
gnat
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
gnuFortran
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
goLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
goVet
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
groovyScript
-
parserId
-
Type:String
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
hadoLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
iar
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
iarCstat
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
ibLinter
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
ideaInspection
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
infer
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
intel
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
invalids
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
junitParser
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
java
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
javaDoc
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
jcReport
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
jsHint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
jsLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
klocWork
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
kotlin
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
ktLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
mavenConsole
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
modelsim
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
metrowerksCodeWarrior
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
msBuild
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
myPy
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
nagFortran
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
oelintAdv
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
otDockerLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
taskScanner
-
excludePattern
(optional)-
Type:String
highTags
(optional)-
Type:String
id
(optional)-
Type:String
ignoreCase
(optional)-
Type:boolean
includePattern
(optional)-
You can define multiple filesets using comma as a separator, e.g. ‘**/*.c, **/*.h’.
Basedir of the fileset is the workspace root.Type:String
isRegularExpression
(optional)-
Note that the regular expression must contain two capturing groups:
the first one is interpreted as tag name, the second one as message.
An example of such a regular expression would be^.*(TODO(?:[0-9]*))(.*)$
.Type:boolean
lowTags
(optional)-
Type:String
name
(optional)-
Type:String
normalTags
(optional)-
Type:String
owaspDependencyCheck
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
PVSStudio
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
pcLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
pep8
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
perforce
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
perlCritic
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
php
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
phpCodeSniffer
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
phpStan
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
pit
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
pmdParser
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
prefast
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
protoLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
puppetLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
pyDocStyle
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
pyLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
qacSourceCodeAnalyser
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
qtTranslation
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
analysisParser
-
analysisModelId
-
Type:String
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
resharperInspectCode
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
revApi
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
rfLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
robocopy
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
ruboCop
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
sarif
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
scala
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
simian
-
highThreshold
(optional)-
Type:int
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
normalThreshold
(optional)-
Type:int
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
sonarQube
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
sphinxBuild
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
spotBugs
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
useRankAsPriority
(optional)-
Type:boolean
styleCop
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
styleLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
sunC
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
swiftLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
tagList
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
taskingVx
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
tiCss
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
tnsdl
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
trivy
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
tsLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
veracodePipelineScanner
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
issues
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
xlc
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
xmlLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
yamlLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
yuiCompressor
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
zptLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
trendChartType
(optional)-
If there is more than one static analysis result available then an aggregation trend chart will be shown
on the project page that shows the analysis results in a single trend chart. You can choose the position of
this aggregation trend:- AGGREGATION_TOOLS
- The aggregation trend is shown before all other analysis tool trend charts.
- TOOLS_AGGREGATION
- The aggregation trend is shown after all other analysis tool trend charts.
- TOOLS_ONLY
- The aggregation trend is not shown, only the analysis tool trend charts are shown.
- AGGREGATION_ONLY
- The aggregation trend is only shown, no other analysis tool trend charts are shown.
- NONE
- Neither the aggregation trend nor analysis tool trend charts are shown.
Values:
AGGREGATION_TOOLS
TOOLS_AGGREGATION
TOOLS_ONLY
AGGREGATION_ONLY
NONE
unhealthy
(optional)-
The unhealthy threshold defines the limit of warnings for an unhealthy result: A build is considered as unhealthy
(i.e. 0% health) when the number of issues is greater than the specified threshold. Values less or equal zero are ignored.
So if you want to have a build health of 0% starting with 10 issues, then set this field to 9.Type:int
unstableNewAll
(optional)-
Type:int
unstableNewHigh
(optional)-
Type:int
unstableNewLow
(optional)-
Type:int
unstableNewNormal
(optional)-
Type:int
unstableTotalAll
(optional)-
Type:int
unstableTotalHigh
(optional)-
Type:int
unstableTotalLow
(optional)-
Type:int
unstableTotalNormal
(optional)-
Type:int
resolveScm
: Resolves an SCM from an SCM Source and a list of candidate target branch names
When you have a multi-branch pipeline that checks out other sibling repositories, you may want to check out the
matching branch from that sibling repository (assuming it exists) but fall back to the main branch if there is no
matching branch.
This step lets you create a branch in the primary repository and then when you need downstream / upstream changes in
the sibling repository you can just create a matching branch and it will be resolved automatically.
For example:
// checkout the main source dir('main'){ // this will checkout the source repository that is driving the multi-branch pipeline checkout scm } // now checkout the tests dir('tests'){ // this will check if there is a branch with the same name as the current branch in // https://example.com/example.git and use that for the checkout, but if there is no // branch with the same name it will fall back to the master branch checkout resolveScm(source: git('https://example.com/example.git'), targets: [BRANCH_NAME,'master'] } // rest of pipeline
The return value is the resolved SCM instance (or null
if ignoring errors).
Where the SCM implementation supports it, the SCM instance will be pinned to the current head revision of
the resolved branch. This can be useful if, for example, you want to check out the resolved branch on
multiple nodes because all the nodes will get the same revision.
source
-
The source repository from which to resolve the target branches.
- Nested choice of objects
-
bitbucket
-
Discovers branches and/or pull requests from a specific repository in either Bitbucket Cloud or a Bitbucket Server
instance.repoOwner
-
Specify the name of the Bitbucket Team or Bitbucket User Account.
It could be a Bitbucket Project also, if using Bitbucket Server.
In this case (Bitbucket Server):- Use the project key, not the project name.
- If using a user account instead of a project, add a «~» character before the username, i.e. «~joe».
Type:String
repository
-
Type:String
autoRegisterHook
(optional)-
Type:boolean
bitbucketServerUrl
(optional)-
Type:String
checkoutCredentialsId
(optional)-
Type:String
credentialsId
(optional)-
Credentials used to scan branches (also the default credentials to use when checking out sources).
For security reasons most credentials are only available when HTTPS is used.
Type:String
excludes
(optional)-
Type:String
id
(optional)-
Type:String
includes
(optional)-
Type:String
serverUrl
(optional)-
The server to connect to.
The list of servers is configured in the Manage Jenkins » Configure Jenkins › Bitbucket Endpoints screen.
The list of servers can include both Bitbucket Cloud and Bitbucket Server instances.Type:String
traits
(optional)-
The behaviours control what is discovered from the Bitbucket repository. The behaviours are grouped into a number
of categories:- Within repository
- These behaviours determine what gets discovered. If you do not configure at least one discovery
behaviour then nothing will be found! - General
- These behaviours affect the configuration of each discovered branch / pull request.
- Git
- These behaviours affect the configuration of each discovered branch / pull request
and are specific to Git semantics.
Array/List:
- Nested choice of objects
-
$class: 'AuthorInChangelogTrait'
-
bitbucketBuildStatusNotifications
-
Configure the Bitbucket notifications.
disableNotificationForNotBuildJobs
(optional)-
Type:boolean
sendSuccessNotificationForUnstableBuild
(optional)-
Type:boolean
$class: 'CheckoutOptionTrait'
-
extension
-
- Nested object
-
timeout
-
Specify a timeout (in minutes) for checkout.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
$class: 'CleanAfterCheckoutTrait'
-
extension
-
- Nested object
-
Clean up the workspace after every checkout by deleting all untracked files and directories,
including those which are specified in.gitignore
.
It also resets all tracked files to their versioned state.
This ensures that the workspace is
in the same state as if you cloned and checked out in a brand-new empty directory, and ensures
that your build is not affected by the files generated by the previous build.deleteUntrackedNestedRepositories
(optional)-
Deletes untracked submodules and any other subdirectories which contain
.git
directories.Type:boolean
$class: 'CleanBeforeCheckoutTrait'
-
extension
-
- Nested object
-
Clean up the workspace before every checkout by deleting all untracked files and directories,
including those which are specified in.gitignore
.
It also resets all tracked files to their versioned state.
This ensures that the workspace is
in the same state as if you cloned and checked out in a brand-new empty directory, and ensures
that your build is not affected by the files generated by the previous build.deleteUntrackedNestedRepositories
(optional)-
Deletes untracked submodules and any other subdirectories which contain
.git
directories.Type:boolean
$class: 'CleanMercurialSCMSourceTrait'
-
When this behaviour is present, each build will wipe any local modifications
or untracked files in the repository checkout.
This is often a convenient way to ensure that a build is not
using any artifacts from earlier builds. $class: 'CloneOptionTrait'
-
extension
-
- Nested object
-
shallow
-
Perform shallow clone, so that git will not download the history of the project,
saving time and disk space when you just want to access the latest version of a repository.Type:boolean
noTags
-
Deselect this to perform a clone without tags, saving time and disk space when you just want to access
what is specified by the refspec.Type:boolean
reference
-
Specify a folder containing a repository that will be used by Git as a reference during clone operations.
This option will be ignored if the folder is not available on the controller or agent where the clone is being executed.Type:String
timeout
-
Specify a timeout (in minutes) for clone and fetch operations.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
depth
(optional)-
Set shallow clone depth, so that git will only download recent history of the project,
saving time and disk space when you just want to access the latest commits of a repository.Type:int
honorRefspec
(optional)-
Perform initial clone using the refspec defined for the repository.
This can save time, data transfer and disk space when you only need
to access the references specified by the refspec.Type:boolean
$class: 'DiscoverOtherRefsTrait'
-
Discovers other specified refs on the repository.
ref
-
The pattern under /refs on the remote repository to discover, can contain a wildcard.
Example: test/*/mergedType:String
nameMapping
(optional)-
Mapping for how the ref can be named in for example the
@Library
.
Example: test-@{1}
Where @{1} replaces the first wildcard in the ref when discovered.By default it will be «namespace_before_wildcard-@{1}». E.g. if ref is «test/*/merged» the default mapping would be
«test-@{1}».Type:String
$class: 'GitBrowserSCMSourceTrait'
-
browser
-
- Nested choice of objects
-
$class: 'AssemblaWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://www.assembla.com/code/PROJECT/git/).
Type:String
bitbucketServer
-
repoUrl
-
Specify the Bitbucket Server root URL for this repository (such as https://bitbucket:7990/OWNER/REPO/).
Type:String
$class: 'BitbucketWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://bitbucket.org/OWNER/REPO/).
Type:String
$class: 'CGit'
-
repoUrl
-
Specify the root URL serving this repository (such as http://cgit.example.com:port/group/REPO/).
Type:String
$class: 'FisheyeGitRepositoryBrowser'
-
repoUrl
-
Specify the URL of this repository in FishEye (such as http://fisheye6.cenqua.com/browse/ant/).
Type:String
$class: 'GitBlitRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository.
Type:String
projectName
-
Specify the name of the project in GitBlit.
Type:String
$class: 'GitLab'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gitlabserver:port/group/REPO/).
Type:String
version
(optional)-
Specify the major and minor version of GitLab you use (such as 9.1). If you
don’t specify a version, a modern version of GitLab (>= 8.0) is assumed.Type:String
$class: 'GitList'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gitlistserver:port/REPO/).
Type:String
$class: 'GitWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://github.com/jenkinsci/jenkins.git).
Type:String
$class: 'GithubWeb'
-
repoUrl
-
Specify the HTTP URL for this repository’s GitHub page (such as https://github.com/jquery/jquery).
Type:String
$class: 'Gitiles'
-
repoUrl
-
Specify the root URL serving this repository (such as https://gwt.googlesource.com/gwt/).
Type:String
$class: 'GitoriousWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://gitorious.org/gitorious/mainline).
Type:String
$class: 'GogsGit'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gogs.example.com:port/username/some-repo-url.git).
Type:String
$class: 'KilnGit'
-
repoUrl
-
Specify the root URL serving this repository (such as https://khanacademy.kilnhg.com/Code/Website/Group/webapp).
Type:String
$class: 'Phabricator'
-
repoUrl
-
Specify the phabricator instance root URL (such as http://phabricator.example.com).
Type:String
repo
-
Specify the repository name in phabricator (such as the foo part of phabricator.example.com/diffusion/foo/browse).
Type:String
$class: 'RedmineWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as http://SERVER/PATH/projects/PROJECT/repository).
Type:String
$class: 'RhodeCode'
-
repoUrl
-
Specify the HTTP URL for this repository’s RhodeCode page (such as http://rhodecode.mydomain.com:5000/projects/PROJECT/repos/REPO/).
Type:String
$class: 'ScmManagerGitRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository (such as https://scm-manager.org/scm/repo/namespace/name).
Type:String
$class: 'Stash'
-
repoUrl
-
Specify the HTTP URL for this repository’s Stash page (such as http://stash.mydomain.com:7990/projects/PROJECT/repos/REPO/).
Type:String
$class: 'TFS2013GitRepositoryBrowser'
-
repoUrl
-
Either the name of the remote whose URL should be used, or the URL of this
module in TFS (such as http://fisheye6.cenqua.com/tfs/PROJECT/_git/REPO/).
If empty (default), the URL of the «origin» repository is used.If TFS is also used as the repository server, this can usually be left blank.
Type:String
$class: 'ViewGitWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as http://code.fealdia.org/viewgit/).
Type:String
projectName
-
Specify the name of the project in ViewGit (e.g. scripts, scuttle etc. from http://code.fealdia.org/viewgit/).
Type:String
$class: 'GitLFSPullTrait'
-
$class: 'GitToolSCMSourceTrait'
-
gitTool
-
Type:String
gitHubIgnoreDraftPullRequestFilter
-
$class: 'IgnoreOnPushNotificationTrait'
-
$class: 'LocalBranchTrait'
-
$class: 'MercurialBrowserSCMSourceTrait'
-
browser
-
- Nested choice of objects
-
$class: 'FishEye'
-
url
-
Specify the root URL serving this repository, such as: http://www.example.org/browse/hg/
Type:String
$class: 'GoogleCode'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'HgWeb'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'Kallithea'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'KilnHG'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'RhodeCode'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'RhodeCodeLegacy'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'ScmManager'
-
url
-
Specify the root URL serving this repository (such as
http://YOURSCMMANAGER/scm/repo/NAMESPACE/NAME/
).Type:String
$class: 'MercurialInstallationSCMSourceTrait'
-
installation
-
Type:String
$class: 'PruneStaleBranchTrait'
-
$class: 'PruneStaleTagTrait'
-
bitbucketPublicRepoPullRequestFilter
-
If the repository being scanned is a public repository, this behaviour will exclude all pull requests.
(Note: This behaviour is not especially useful if scanning a single repository as you could just not include the
pull request discovery behaviours in the first place) $class: 'PullRequestDiscoveryTrait'
-
excludeBranchesWithPRs
-
Exclude branches for which there is an open pull request
Type:boolean
$class: 'RefSpecsSCMSourceTrait'
-
templates
-
Array/List:
- Nested object
-
value
-
A ref spec to fetch. Any occurrences of
@{remote}
will be replaced by the remote name
(which defaults toorigin
) before use.Type:String
headRegexFilter
-
regex
-
A Java regular expression to
restrict the names. Names that do not match the supplied regular expression will be ignored.
NOTE: this filter will be applied to all branch like things, including change requestsType:String
$class: 'RemoteNameSCMSourceTrait'
-
remoteName
-
Type:String
$class: 'SparseCheckoutPathsTrait'
-
extension
-
- Nested object
-
Specify the paths that you’d like to sparse checkout. This may be used for saving space (Think about a reference repository).
Be sure to use a recent version of Git, at least above 1.7.10sparseCheckoutPaths
-
Array/List:
- Nested object
-
path
-
Type:String
$class: 'SubmoduleOptionTrait'
-
extension
-
- Nested object
-
disableSubmodules
-
By disabling support for submodules you can still keep using basic
git plugin functionality and just have Jenkins to ignore submodules
completely as if they didn’t exist.Type:boolean
recursiveSubmodules
-
Retrieve all submodules recursively
(uses ‘—recursive’ option which requires git>=1.6.5)
Type:boolean
trackingSubmodules
-
Retrieve the tip of the configured branch in .gitmodules
(Uses ‘—remote’ option which requires git>=1.8.2)
Type:boolean
reference
-
Specify a folder containing a repository that will be used by Git as a reference during clone operations.
This option will be ignored if the folder is not available on the controller or agent where the clone is being executed.
To prepare a reference folder with multiple subprojects, create a bare git repository and add all the remote urls then perform a fetch:git init --bare git remote add SubProject1 https://gitrepo.com/subproject1 git remote add SubProject2 https://gitrepo.com/subproject2 git fetch --all
Type:String
timeout
-
Specify a timeout (in minutes) for submodules operations.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
parentCredentials
-
Use credentials from the default remote of the parent project.
Type:boolean
depth
(optional)-
Set shallow clone depth, so that git will only download recent history of the project,
saving time and disk space when you just want to access the latest commits of a repository.Type:int
shallow
(optional)-
Perform shallow clone, so that git will not download the history of the project,
saving time and disk space when you just want to access the latest version of a repository.Type:boolean
threads
(optional)-
Specify the number of threads that will be used to update submodules.
If unspecified, the command line git default thread count is used.Type:int
$class: 'UserIdentityTrait'
-
extension
-
- Nested object
-
name
-
If given, «GIT_COMMITTER_NAME=[this]» and «GIT_AUTHOR_NAME=[this]» are set for builds. This overrides whatever is in the global settings.
Type:String
email
-
If given, «GIT_COMMITTER_EMAIL=[this]» and «GIT_AUTHOR_EMAIL=[this]» are set for builds. This overrides whatever is in the global settings.
Type:String
bitbucketWebhookConfiguration
-
Sets the value for committersToIgnore in the Bitbucket Webhook. Value should be a comma separated string.
committerToIgnore is used to prevent triggering Jenkins builds when commits by certain users
are made.committersToIgnore
-
Type:String
bitbucketWebhookRegistration
-
Overrides the defaults for webhook management.
Webhooks are used to inform Jenkins about changes to repositories. There are two ways webhooks can be
configured:- Manual webhook configuration requires the user to configure Bitbucket with the Jenkins URL in order
to ensure that Bitbucket will send the events to Jenkins after every change. - Automatic webhook configuration requires that Jenkins has credentials with sufficient permission to
configure webhooks and also that Jenkins knows the URL that Bitbucket can connect to.
The Manage Jenkins » Configure Jenkins › Bitbucket Endpoints allows defining the list of
servers. Each server
can be associated with credentials. If credentials are defined then the default behaviour is to use those
credentials to automatically manage the webhooks of all repositories that Jenkins is interested in. If no
credentials are defined then the default behaviour is to require the user to manually configure webhooks.mode
-
There are two available modes:
- Disable hook management
- Disables hook management irrespective of the global defaults.
- Use item credentials for hook management
- Enabled hook management but uses the selected credentials to manage the hooks rather than those defined in
Manage Jenkins » Configure Jenkins › Bitbucket Endpoints
Type:String
- Manual webhook configuration requires the user to configure Bitbucket with the Jenkins URL in order
headWildcardFilter
-
includes
-
Space-separated list of name patterns to consider.
You may use*
as a wildcard; for example:master release*
NOTE: this filter will be applied to all branch like things, including change requestsType:String
excludes
-
Space-separated list of name patterns to ignore even if matched by the includes list.
For example:release alpha-* beta-*
NOTE: this filter will be applied to all branch like things, including change requestsType:String
$class: 'WipeWorkspaceTrait'
-
bitbucketBranchDiscovery
-
Discovers branches on the repository.
strategyId
-
Determines which branches are discovered.
- Exclude branches that are also filed as PRs
-
If you are discovering origin pull requests, it may not make sense to discover the same changes both as a
pull request and as a branch. - Only branches that are also filed as PRs
-
Discovers branches that have PR’s associated with them. This may make sense if you have a
notification sent to the team at the end of a triggered build or limited Jenkins resources. - All branches
-
Ignores whether the branch is also filed as a pull request and instead discovers all branches on the
origin repository.
Type:int
bitbucketForkDiscovery
-
Discovers pull requests where the origin repository is a fork of the target repository.
strategyId
-
Determines how pull requests are discovered.
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging
Type:int
trust
-
One of the great powers of pull requests is that anyone with read access to a repository can fork it, commit
some changes to their fork and then create a pull request against the original repository with their changes.
There are some files stored in source control that are important. For example, aJenkinsfile
may contain configuration details to sandbox pull requests in order to mitigate against malicious pull requests.
In order to protect against a malicious pull request itself modifying theJenkinsfile
to remove
the protections, you can define the trust policy for pull requests from forks.Other plugins can extend the available trust policies. The default policies are:
- Nobody
-
Pull requests from forks will all be treated as untrusted. This means that where Jenkins requires a
trusted file (e.g.Jenkinsfile
) the contents of that file will be retrieved from the
target branch on the origin repository and not from the pull request branch on the fork repository. - Forks in the same account
-
Bitbucket allows for a repository to be forked into a «sibling» repository in the same account but using
a different name. This strategy will trust any pull requests from forks that are in the same account as
the target repository on the basis that users have to have been granted write permission to account in
order create such a fork. - Everyone
-
All pull requests from forks will be treated as trusted. NOTE: this option can be dangerous
if used on a public repository hosted on Bitbucket Cloud.
java.lang.UnsupportedOperationException: do not know how to categorize attributes of type jenkins.scm.api.trait.SCMHeadAuthority<? super com.cloudbees.jenkins.plugins.bitbucket.BitbucketSCMSourceRequest, ? extends jenkins.scm.api.mixin.ChangeRequestSCMHead2, ? extends jenkins.scm.api.SCMRevision>
bitbucketPullRequestDiscovery
-
Discovers pull requests where the origin repository is the same as the target repository.
strategyId
-
Determines how pull requests are discovered.
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging
Type:int
bitbucketSshCheckout
-
By default the discovered branches / pull requests will all use the same credentials
that were used for discovery when checking out sources. This means that the checkout will be using the
https://
protocol for the Git repository.This behaviour allows you to select the SSH private key to be used for checking out sources, which will
consequently force the checkout to use thessh://
protocol.credentialsId
-
Credentials used to check out sources.
It must be a SSH key based credential.
Type:String
bitbucketTagDiscovery
-
Discovers tags on the repository.
$class: 'com.cloudogu.scmmanager.scm.BranchDiscoveryTrait'
-
$class: 'com.cloudogu.scmmanager.scm.TagDiscoveryTrait'
-
gitBranchDiscovery
-
Discovers branches on the repository.
gitTagDiscovery
-
Discovers tags on the repository.
gitHubBranchDiscovery
-
Discovers branches on the repository.
strategyId
-
Determines which branches are discovered.
- Exclude branches that are also filed as PRs
-
If you are discovering origin pull requests, you may not want to also build the source branches
for those pull requests. - Only branches that are also filed as PRs
-
Similar to discovering origin pull requests, but discovers the branch rather than the pull request.
This meansenv.GIT_BRANCH
will be set to the branch name rather thanPR-#
.
Also, status notifications for these builds will only be applied to the commit and not to the pull request. - All branches
-
Ignores whether the branch is also filed as a pull request and instead discovers all branches on the
origin repository.
Type:int
gitHubForkDiscovery
-
Discovers pull requests where the origin repository is a fork of the target repository.
strategyId
-
Determines how pull requests are discovered:
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch. - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging. - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging.
Type:int
trust
-
One of the great powers of pull requests is that anyone with read access to a repository can fork it, commit
some changes to their fork and then create a pull request against the original repository with their changes.
There are some files stored in source control that are important. For example, aJenkinsfile
may contain configuration details to sandbox pull requests in order to mitigate against malicious pull requests.
In order to protect against a malicious pull request itself modifying theJenkinsfile
to remove
the protections, you can define the trust policy for pull requests from forks.Other plugins can extend the available trust policies. The default policies are:
- Nobody
-
Pull requests from forks will all be treated as untrusted. This means that where Jenkins requires a
trusted file (e.g.Jenkinsfile
) the contents of that file will be retrieved from the
target branch on the origin repository and not from the pull request branch on the fork repository. - Collaborators
-
Pull requests from collaborators
to the origin repository will be treated as trusted, all other pull requests from fork repositories
will be treated as untrusted.
Note that if credentials used by Jenkins for scanning the repository does not have permission to
query the list of collaborators to the origin repository then only the origin account will be treated
as trusted — i.e. this will fall back toNobody
.
NOTE: all collaborators are trusted, even if they are only members of a team with read permission. - Everyone
-
All pull requests from forks will be treated as trusted. NOTE: this option can be dangerous
if used on a public repository hosted on GitHub. - From users with Admin or Write permission
-
Pull requests forks will be treated as trusted if and only if the fork owner has either Admin or Write
permissions on the origin repository.
This is the recommended policy.
Note that this strategy requires the
Review
a user’s permission level API, as a result on GitHub Enterprise Server versions before 2.12 this
is the same as trusting Nobody.
java.lang.UnsupportedOperationException: do not know how to categorize attributes of type jenkins.scm.api.trait.SCMHeadAuthority<? super org.jenkinsci.plugins.github_branch_source.GitHubSCMSourceRequest, ? extends jenkins.scm.api.mixin.ChangeRequestSCMHead2, ? extends jenkins.scm.api.SCMRevision>
gitHubPullRequestDiscovery
-
Discovers pull requests where the origin repository is the same as the target repository.
strategyId
-
Determines how pull requests are discovered:
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch. - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging. - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging.
Type:int
gitHubSshCheckout
-
By default the discovered branches / pull requests will all use the same username / password credentials
that were used for discovery when checking out sources. This means that the checkout will be using the
https://
protocol for the Git repository.This behaviour allows you to select the SSH private key to be used for checking out sources, which will
consequently force the checkout to use thessh://
protocol.credentialsId
-
Credentials used to check out sources. Must be a SSH key based credential.
Type:String
gitHubTagDiscovery
-
Discovers tags on the repository.
github
-
repoOwner
-
Specify the name of the GitHub Organization or GitHub User Account.
Type:String
repository
-
Type:String
repositoryUrl
-
Specify the HTTPS URL of the GitHub Organization / User Account and repository.
GitHub examples:
- https://github.com/jenkinsci/github-branch-source-plugin
- https://github.com/jenkinsci/github-branch-source-plugin.git
GitHub Enterprise examples:
- https://myccompany.github.com/jenkinsci/github-branch-source-plugin
- https://myccompany.github.com/jenkinsci/github-branch-source-plugin.git
Type:String
configuredByUrl
-
Type:boolean
apiUri
(optional)-
The server to connect to. The list of servers is configured in the Manage Jenkins » Configure
System » GitHub Enterprise Servers screen.Type:String
buildForkPRHead
(optional)-
Type:boolean
buildForkPRMerge
(optional)-
Type:boolean
buildOriginBranch
(optional)-
Type:boolean
buildOriginBranchWithPR
(optional)-
Type:boolean
buildOriginPRHead
(optional)-
Type:boolean
buildOriginPRMerge
(optional)-
Type:boolean
credentialsId
(optional)-
Credentials used to scan branches and pull requests,
check out sources and mark commit statuses.Note that only «username with password» credentials are supported.
Existing credentials of other kinds will be filtered out. This is because Jenkins
uses the GitHub API, which does not support other ways of authentication.If none is given, only the public repositories will be scanned, and commit status
will not be set on GitHub.If your organization contains private repositories, then you need to specify
a credential from a user who has access to those repositories. This is done
by creating a «username with password» credential where the password is
GitHub personal access tokens.
The necessary scope is «repo».Type:String
excludes
(optional)-
Type:String
id
(optional)-
Type:String
includes
(optional)-
Type:String
traits
(optional)-
The behaviours control what is discovered from the GitHub repository. The behaviours are grouped into a number
of categories:- Within repository
- These behaviours determine what gets discovered. If you do not configure at least one discovery
behaviour then nothing will be found! - General
- These behaviours affect the configuration of each discovered branch / pull request.
Array/List:
- Nested choice of objects
-
$class: 'AuthorInChangelogTrait'
-
bitbucketBuildStatusNotifications
-
Configure the Bitbucket notifications.
disableNotificationForNotBuildJobs
(optional)-
Type:boolean
sendSuccessNotificationForUnstableBuild
(optional)-
Type:boolean
$class: 'CheckoutOptionTrait'
-
extension
-
- Nested object
-
timeout
-
Specify a timeout (in minutes) for checkout.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
$class: 'CleanAfterCheckoutTrait'
-
extension
-
- Nested object
-
Clean up the workspace after every checkout by deleting all untracked files and directories,
including those which are specified in.gitignore
.
It also resets all tracked files to their versioned state.
This ensures that the workspace is
in the same state as if you cloned and checked out in a brand-new empty directory, and ensures
that your build is not affected by the files generated by the previous build.deleteUntrackedNestedRepositories
(optional)-
Deletes untracked submodules and any other subdirectories which contain
.git
directories.Type:boolean
$class: 'CleanBeforeCheckoutTrait'
-
extension
-
- Nested object
-
Clean up the workspace before every checkout by deleting all untracked files and directories,
including those which are specified in.gitignore
.
It also resets all tracked files to their versioned state.
This ensures that the workspace is
in the same state as if you cloned and checked out in a brand-new empty directory, and ensures
that your build is not affected by the files generated by the previous build.deleteUntrackedNestedRepositories
(optional)-
Deletes untracked submodules and any other subdirectories which contain
.git
directories.Type:boolean
$class: 'CleanMercurialSCMSourceTrait'
-
When this behaviour is present, each build will wipe any local modifications
or untracked files in the repository checkout.
This is often a convenient way to ensure that a build is not
using any artifacts from earlier builds. $class: 'CloneOptionTrait'
-
extension
-
- Nested object
-
shallow
-
Perform shallow clone, so that git will not download the history of the project,
saving time and disk space when you just want to access the latest version of a repository.Type:boolean
noTags
-
Deselect this to perform a clone without tags, saving time and disk space when you just want to access
what is specified by the refspec.Type:boolean
reference
-
Specify a folder containing a repository that will be used by Git as a reference during clone operations.
This option will be ignored if the folder is not available on the controller or agent where the clone is being executed.Type:String
timeout
-
Specify a timeout (in minutes) for clone and fetch operations.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
depth
(optional)-
Set shallow clone depth, so that git will only download recent history of the project,
saving time and disk space when you just want to access the latest commits of a repository.Type:int
honorRefspec
(optional)-
Perform initial clone using the refspec defined for the repository.
This can save time, data transfer and disk space when you only need
to access the references specified by the refspec.Type:boolean
$class: 'DiscoverOtherRefsTrait'
-
Discovers other specified refs on the repository.
ref
-
The pattern under /refs on the remote repository to discover, can contain a wildcard.
Example: test/*/mergedType:String
nameMapping
(optional)-
Mapping for how the ref can be named in for example the
@Library
.
Example: test-@{1}
Where @{1} replaces the first wildcard in the ref when discovered.By default it will be «namespace_before_wildcard-@{1}». E.g. if ref is «test/*/merged» the default mapping would be
«test-@{1}».Type:String
$class: 'GitBrowserSCMSourceTrait'
-
browser
-
- Nested choice of objects
-
$class: 'AssemblaWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://www.assembla.com/code/PROJECT/git/).
Type:String
bitbucketServer
-
repoUrl
-
Specify the Bitbucket Server root URL for this repository (such as https://bitbucket:7990/OWNER/REPO/).
Type:String
$class: 'BitbucketWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://bitbucket.org/OWNER/REPO/).
Type:String
$class: 'CGit'
-
repoUrl
-
Specify the root URL serving this repository (such as http://cgit.example.com:port/group/REPO/).
Type:String
$class: 'FisheyeGitRepositoryBrowser'
-
repoUrl
-
Specify the URL of this repository in FishEye (such as http://fisheye6.cenqua.com/browse/ant/).
Type:String
$class: 'GitBlitRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository.
Type:String
projectName
-
Specify the name of the project in GitBlit.
Type:String
$class: 'GitLab'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gitlabserver:port/group/REPO/).
Type:String
version
(optional)-
Specify the major and minor version of GitLab you use (such as 9.1). If you
don’t specify a version, a modern version of GitLab (>= 8.0) is assumed.Type:String
$class: 'GitList'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gitlistserver:port/REPO/).
Type:String
$class: 'GitWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://github.com/jenkinsci/jenkins.git).
Type:String
$class: 'GithubWeb'
-
repoUrl
-
Specify the HTTP URL for this repository’s GitHub page (such as https://github.com/jquery/jquery).
Type:String
$class: 'Gitiles'
-
repoUrl
-
Specify the root URL serving this repository (such as https://gwt.googlesource.com/gwt/).
Type:String
$class: 'GitoriousWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://gitorious.org/gitorious/mainline).
Type:String
$class: 'GogsGit'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gogs.example.com:port/username/some-repo-url.git).
Type:String
$class: 'KilnGit'
-
repoUrl
-
Specify the root URL serving this repository (such as https://khanacademy.kilnhg.com/Code/Website/Group/webapp).
Type:String
$class: 'Phabricator'
-
repoUrl
-
Specify the phabricator instance root URL (such as http://phabricator.example.com).
Type:String
repo
-
Specify the repository name in phabricator (such as the foo part of phabricator.example.com/diffusion/foo/browse).
Type:String
$class: 'RedmineWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as http://SERVER/PATH/projects/PROJECT/repository).
Type:String
$class: 'RhodeCode'
-
repoUrl
-
Specify the HTTP URL for this repository’s RhodeCode page (such as http://rhodecode.mydomain.com:5000/projects/PROJECT/repos/REPO/).
Type:String
$class: 'ScmManagerGitRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository (such as https://scm-manager.org/scm/repo/namespace/name).
Type:String
$class: 'Stash'
-
repoUrl
-
Specify the HTTP URL for this repository’s Stash page (such as http://stash.mydomain.com:7990/projects/PROJECT/repos/REPO/).
Type:String
$class: 'TFS2013GitRepositoryBrowser'
-
repoUrl
-
Either the name of the remote whose URL should be used, or the URL of this
module in TFS (such as http://fisheye6.cenqua.com/tfs/PROJECT/_git/REPO/).
If empty (default), the URL of the «origin» repository is used.If TFS is also used as the repository server, this can usually be left blank.
Type:String
$class: 'ViewGitWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as http://code.fealdia.org/viewgit/).
Type:String
projectName
-
Specify the name of the project in ViewGit (e.g. scripts, scuttle etc. from http://code.fealdia.org/viewgit/).
Type:String
$class: 'GitLFSPullTrait'
-
$class: 'GitToolSCMSourceTrait'
-
gitTool
-
Type:String
gitHubIgnoreDraftPullRequestFilter
-
$class: 'IgnoreOnPushNotificationTrait'
-
$class: 'LocalBranchTrait'
-
$class: 'MercurialBrowserSCMSourceTrait'
-
browser
-
- Nested choice of objects
-
$class: 'FishEye'
-
url
-
Specify the root URL serving this repository, such as: http://www.example.org/browse/hg/
Type:String
$class: 'GoogleCode'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'HgWeb'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'Kallithea'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'KilnHG'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'RhodeCode'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'RhodeCodeLegacy'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'ScmManager'
-
url
-
Specify the root URL serving this repository (such as
http://YOURSCMMANAGER/scm/repo/NAMESPACE/NAME/
).Type:String
$class: 'MercurialInstallationSCMSourceTrait'
-
installation
-
Type:String
$class: 'PruneStaleBranchTrait'
-
$class: 'PruneStaleTagTrait'
-
bitbucketPublicRepoPullRequestFilter
-
If the repository being scanned is a public repository, this behaviour will exclude all pull requests.
(Note: This behaviour is not especially useful if scanning a single repository as you could just not include the
pull request discovery behaviours in the first place) $class: 'PullRequestDiscoveryTrait'
-
excludeBranchesWithPRs
-
Exclude branches for which there is an open pull request
Type:boolean
$class: 'RefSpecsSCMSourceTrait'
-
templates
-
Array/List:
- Nested object
-
value
-
A ref spec to fetch. Any occurrences of
@{remote}
will be replaced by the remote name
(which defaults toorigin
) before use.Type:String
headRegexFilter
-
regex
-
A Java regular expression to
restrict the names. Names that do not match the supplied regular expression will be ignored.
NOTE: this filter will be applied to all branch like things, including change requestsType:String
$class: 'RemoteNameSCMSourceTrait'
-
remoteName
-
Type:String
$class: 'SparseCheckoutPathsTrait'
-
extension
-
- Nested object
-
Specify the paths that you’d like to sparse checkout. This may be used for saving space (Think about a reference repository).
Be sure to use a recent version of Git, at least above 1.7.10sparseCheckoutPaths
-
Array/List:
- Nested object
-
path
-
Type:String
$class: 'SubmoduleOptionTrait'
-
extension
-
- Nested object
-
disableSubmodules
-
By disabling support for submodules you can still keep using basic
git plugin functionality and just have Jenkins to ignore submodules
completely as if they didn’t exist.Type:boolean
recursiveSubmodules
-
Retrieve all submodules recursively
(uses ‘—recursive’ option which requires git>=1.6.5)
Type:boolean
trackingSubmodules
-
Retrieve the tip of the configured branch in .gitmodules
(Uses ‘—remote’ option which requires git>=1.8.2)
Type:boolean
reference
-
Specify a folder containing a repository that will be used by Git as a reference during clone operations.
This option will be ignored if the folder is not available on the controller or agent where the clone is being executed.
To prepare a reference folder with multiple subprojects, create a bare git repository and add all the remote urls then perform a fetch:git init --bare git remote add SubProject1 https://gitrepo.com/subproject1 git remote add SubProject2 https://gitrepo.com/subproject2 git fetch --all
Type:String
timeout
-
Specify a timeout (in minutes) for submodules operations.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
parentCredentials
-
Use credentials from the default remote of the parent project.
Type:boolean
depth
(optional)-
Set shallow clone depth, so that git will only download recent history of the project,
saving time and disk space when you just want to access the latest commits of a repository.Type:int
shallow
(optional)-
Perform shallow clone, so that git will not download the history of the project,
saving time and disk space when you just want to access the latest version of a repository.Type:boolean
threads
(optional)-
Specify the number of threads that will be used to update submodules.
If unspecified, the command line git default thread count is used.Type:int
$class: 'UserIdentityTrait'
-
extension
-
- Nested object
-
name
-
If given, «GIT_COMMITTER_NAME=[this]» and «GIT_AUTHOR_NAME=[this]» are set for builds. This overrides whatever is in the global settings.
Type:String
email
-
If given, «GIT_COMMITTER_EMAIL=[this]» and «GIT_AUTHOR_EMAIL=[this]» are set for builds. This overrides whatever is in the global settings.
Type:String
bitbucketWebhookConfiguration
-
Sets the value for committersToIgnore in the Bitbucket Webhook. Value should be a comma separated string.
committerToIgnore is used to prevent triggering Jenkins builds when commits by certain users
are made.committersToIgnore
-
Type:String
bitbucketWebhookRegistration
-
Overrides the defaults for webhook management.
Webhooks are used to inform Jenkins about changes to repositories. There are two ways webhooks can be
configured:- Manual webhook configuration requires the user to configure Bitbucket with the Jenkins URL in order
to ensure that Bitbucket will send the events to Jenkins after every change. - Automatic webhook configuration requires that Jenkins has credentials with sufficient permission to
configure webhooks and also that Jenkins knows the URL that Bitbucket can connect to.
The Manage Jenkins » Configure Jenkins › Bitbucket Endpoints allows defining the list of
servers. Each server
can be associated with credentials. If credentials are defined then the default behaviour is to use those
credentials to automatically manage the webhooks of all repositories that Jenkins is interested in. If no
credentials are defined then the default behaviour is to require the user to manually configure webhooks.mode
-
There are two available modes:
- Disable hook management
- Disables hook management irrespective of the global defaults.
- Use item credentials for hook management
- Enabled hook management but uses the selected credentials to manage the hooks rather than those defined in
Manage Jenkins » Configure Jenkins › Bitbucket Endpoints
Type:String
- Manual webhook configuration requires the user to configure Bitbucket with the Jenkins URL in order
headWildcardFilter
-
includes
-
Space-separated list of name patterns to consider.
You may use*
as a wildcard; for example:master release*
NOTE: this filter will be applied to all branch like things, including change requestsType:String
excludes
-
Space-separated list of name patterns to ignore even if matched by the includes list.
For example:release alpha-* beta-*
NOTE: this filter will be applied to all branch like things, including change requestsType:String
$class: 'WipeWorkspaceTrait'
-
bitbucketBranchDiscovery
-
Discovers branches on the repository.
strategyId
-
Determines which branches are discovered.
- Exclude branches that are also filed as PRs
-
If you are discovering origin pull requests, it may not make sense to discover the same changes both as a
pull request and as a branch. - Only branches that are also filed as PRs
-
Discovers branches that have PR’s associated with them. This may make sense if you have a
notification sent to the team at the end of a triggered build or limited Jenkins resources. - All branches
-
Ignores whether the branch is also filed as a pull request and instead discovers all branches on the
origin repository.
Type:int
bitbucketForkDiscovery
-
Discovers pull requests where the origin repository is a fork of the target repository.
strategyId
-
Determines how pull requests are discovered.
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging
Type:int
trust
-
One of the great powers of pull requests is that anyone with read access to a repository can fork it, commit
some changes to their fork and then create a pull request against the original repository with their changes.
There are some files stored in source control that are important. For example, aJenkinsfile
may contain configuration details to sandbox pull requests in order to mitigate against malicious pull requests.
In order to protect against a malicious pull request itself modifying theJenkinsfile
to remove
the protections, you can define the trust policy for pull requests from forks.Other plugins can extend the available trust policies. The default policies are:
- Nobody
-
Pull requests from forks will all be treated as untrusted. This means that where Jenkins requires a
trusted file (e.g.Jenkinsfile
) the contents of that file will be retrieved from the
target branch on the origin repository and not from the pull request branch on the fork repository. - Forks in the same account
-
Bitbucket allows for a repository to be forked into a «sibling» repository in the same account but using
a different name. This strategy will trust any pull requests from forks that are in the same account as
the target repository on the basis that users have to have been granted write permission to account in
order create such a fork. - Everyone
-
All pull requests from forks will be treated as trusted. NOTE: this option can be dangerous
if used on a public repository hosted on Bitbucket Cloud.
java.lang.UnsupportedOperationException: do not know how to categorize attributes of type jenkins.scm.api.trait.SCMHeadAuthority<? super com.cloudbees.jenkins.plugins.bitbucket.BitbucketSCMSourceRequest, ? extends jenkins.scm.api.mixin.ChangeRequestSCMHead2, ? extends jenkins.scm.api.SCMRevision>
bitbucketPullRequestDiscovery
-
Discovers pull requests where the origin repository is the same as the target repository.
strategyId
-
Determines how pull requests are discovered.
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging
Type:int
bitbucketSshCheckout
-
By default the discovered branches / pull requests will all use the same credentials
that were used for discovery when checking out sources. This means that the checkout will be using the
https://
protocol for the Git repository.This behaviour allows you to select the SSH private key to be used for checking out sources, which will
consequently force the checkout to use thessh://
protocol.credentialsId
-
Credentials used to check out sources.
It must be a SSH key based credential.
Type:String
bitbucketTagDiscovery
-
Discovers tags on the repository.
$class: 'com.cloudogu.scmmanager.scm.BranchDiscoveryTrait'
-
$class: 'com.cloudogu.scmmanager.scm.TagDiscoveryTrait'
-
gitBranchDiscovery
-
Discovers branches on the repository.
gitTagDiscovery
-
Discovers tags on the repository.
gitHubBranchDiscovery
-
Discovers branches on the repository.
strategyId
-
Determines which branches are discovered.
- Exclude branches that are also filed as PRs
-
If you are discovering origin pull requests, you may not want to also build the source branches
for those pull requests. - Only branches that are also filed as PRs
-
Similar to discovering origin pull requests, but discovers the branch rather than the pull request.
This meansenv.GIT_BRANCH
will be set to the branch name rather thanPR-#
.
Also, status notifications for these builds will only be applied to the commit and not to the pull request. - All branches
-
Ignores whether the branch is also filed as a pull request and instead discovers all branches on the
origin repository.
Type:int
gitHubForkDiscovery
-
Discovers pull requests where the origin repository is a fork of the target repository.
strategyId
-
Determines how pull requests are discovered:
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch. - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging. - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging.
Type:int
trust
-
One of the great powers of pull requests is that anyone with read access to a repository can fork it, commit
some changes to their fork and then create a pull request against the original repository with their changes.
There are some files stored in source control that are important. For example, aJenkinsfile
may contain configuration details to sandbox pull requests in order to mitigate against malicious pull requests.
In order to protect against a malicious pull request itself modifying theJenkinsfile
to remove
the protections, you can define the trust policy for pull requests from forks.Other plugins can extend the available trust policies. The default policies are:
- Nobody
-
Pull requests from forks will all be treated as untrusted. This means that where Jenkins requires a
trusted file (e.g.Jenkinsfile
) the contents of that file will be retrieved from the
target branch on the origin repository and not from the pull request branch on the fork repository. - Collaborators
-
Pull requests from collaborators
to the origin repository will be treated as trusted, all other pull requests from fork repositories
will be treated as untrusted.
Note that if credentials used by Jenkins for scanning the repository does not have permission to
query the list of collaborators to the origin repository then only the origin account will be treated
as trusted — i.e. this will fall back toNobody
.
NOTE: all collaborators are trusted, even if they are only members of a team with read permission. - Everyone
-
All pull requests from forks will be treated as trusted. NOTE: this option can be dangerous
if used on a public repository hosted on GitHub. - From users with Admin or Write permission
-
Pull requests forks will be treated as trusted if and only if the fork owner has either Admin or Write
permissions on the origin repository.
This is the recommended policy.
Note that this strategy requires the
Review
a user’s permission level API, as a result on GitHub Enterprise Server versions before 2.12 this
is the same as trusting Nobody.
java.lang.UnsupportedOperationException: do not know how to categorize attributes of type jenkins.scm.api.trait.SCMHeadAuthority<? super org.jenkinsci.plugins.github_branch_source.GitHubSCMSourceRequest, ? extends jenkins.scm.api.mixin.ChangeRequestSCMHead2, ? extends jenkins.scm.api.SCMRevision>
gitHubPullRequestDiscovery
-
Discovers pull requests where the origin repository is the same as the target repository.
strategyId
-
Determines how pull requests are discovered:
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch. - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging. - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging.
Type:int
gitHubSshCheckout
-
By default the discovered branches / pull requests will all use the same username / password credentials
that were used for discovery when checking out sources. This means that the checkout will be using the
https://
protocol for the Git repository.This behaviour allows you to select the SSH private key to be used for checking out sources, which will
consequently force the checkout to use thessh://
protocol.credentialsId
-
Credentials used to check out sources. Must be a SSH key based credential.
Type:String
gitHubTagDiscovery
-
Discovers tags on the repository.
git
-
remote
-
Specify the URL of this remote repository. This uses the same syntax as your
git clone
command.Type:String
browser
(optional)-
- Nested choice of objects
-
$class: 'AssemblaWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://www.assembla.com/code/PROJECT/git/).
Type:String
bitbucketServer
-
repoUrl
-
Specify the Bitbucket Server root URL for this repository (such as https://bitbucket:7990/OWNER/REPO/).
Type:String
$class: 'BitbucketWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://bitbucket.org/OWNER/REPO/).
Type:String
$class: 'CGit'
-
repoUrl
-
Specify the root URL serving this repository (such as http://cgit.example.com:port/group/REPO/).
Type:String
$class: 'FisheyeGitRepositoryBrowser'
-
repoUrl
-
Specify the URL of this repository in FishEye (such as http://fisheye6.cenqua.com/browse/ant/).
Type:String
$class: 'GitBlitRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository.
Type:String
projectName
-
Specify the name of the project in GitBlit.
Type:String
$class: 'GitLab'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gitlabserver:port/group/REPO/).
Type:String
version
(optional)-
Specify the major and minor version of GitLab you use (such as 9.1). If you
don’t specify a version, a modern version of GitLab (>= 8.0) is assumed.Type:String
$class: 'GitList'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gitlistserver:port/REPO/).
Type:String
$class: 'GitWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://github.com/jenkinsci/jenkins.git).
Type:String
$class: 'GithubWeb'
-
repoUrl
-
Specify the HTTP URL for this repository’s GitHub page (such as https://github.com/jquery/jquery).
Type:String
$class: 'Gitiles'
-
repoUrl
-
Specify the root URL serving this repository (such as https://gwt.googlesource.com/gwt/).
Type:String
$class: 'GitoriousWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://gitorious.org/gitorious/mainline).
Type:String
$class: 'GogsGit'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gogs.example.com:port/username/some-repo-url.git).
Type:String
$class: 'KilnGit'
-
repoUrl
-
Specify the root URL serving this repository (such as https://khanacademy.kilnhg.com/Code/Website/Group/webapp).
Type:String
$class: 'Phabricator'
-
repoUrl
-
Specify the phabricator instance root URL (such as http://phabricator.example.com).
Type:String
repo
-
Specify the repository name in phabricator (such as the foo part of phabricator.example.com/diffusion/foo/browse).
Type:String
$class: 'RedmineWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as http://SERVER/PATH/projects/PROJECT/repository).
Type:String
$class: 'RhodeCode'
-
repoUrl
-
Specify the HTTP URL for this repository’s RhodeCode page (such as http://rhodecode.mydomain.com:5000/projects/PROJECT/repos/REPO/).
Type:String
$class: 'ScmManagerGitRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository (such as https://scm-manager.org/scm/repo/namespace/name).
Type:String
$class: 'Stash'
-
repoUrl
-
Specify the HTTP URL for this repository’s Stash page (such as http://stash.mydomain.com:7990/projects/PROJECT/repos/REPO/).
Type:String
$class: 'TFS2013GitRepositoryBrowser'
-
repoUrl
-
Either the name of the remote whose URL should be used, or the URL of this
module in TFS (such as http://fisheye6.cenqua.com/tfs/PROJECT/_git/REPO/).
If empty (default), the URL of the «origin» repository is used.If TFS is also used as the repository server, this can usually be left blank.
Type:String
$class: 'ViewGitWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as http://code.fealdia.org/viewgit/).
Type:String
projectName
-
Specify the name of the project in ViewGit (e.g. scripts, scuttle etc. from http://code.fealdia.org/viewgit/).
Type:String
credentialsId
(optional)-
Credentials used to scan branches and check out sources.
Type:String
extensions
(optional)-
Array/List:
- Nested choice of objects
-
$class: 'AuthorInChangelog'
-
The default behavior is to use the Git commit’s «Committer» value in Jenkins’ build changesets.
If this option is selected, the Git commit’s «Author» value would be used instead. $class: 'BuildChooserSetting'
-
When you are interested in using a job to build multiple heads (most typically multiple branches),
you can choose how Jenkins choose what branches to build in what order.This extension point in Jenkins is used by many other plugins to control the job to build
specific commits. When you activate those plugins, you may see them installing a custom strategy
here.buildChooser
-
- Nested choice of objects
-
$class: 'AncestryBuildChooser'
-
maximumAgeInDays
-
Type:int
ancestorCommitSha1
-
Type:String
$class: 'DefaultBuildChooser'
-
$class: 'InverseBuildChooser'
-
$class: 'BuildSingleRevisionOnly'
-
Disable scheduling for multiple candidate revisions.
If we have 3 branches:
—-A—.—.— B
——C
jenkins would try to build (B) and (C).
This behaviour disables this and only builds one of them.
It is helpful to reduce the load of the Jenkins infrastructure when the
SCM system like Bitbucket or GitHub should decide what commits to build. $class: 'ChangelogToBranch'
-
This method calculates the changelog against the specified branch.
options
-
- Nested object
-
compareRemote
-
Name of the repository, such as
origin
, that contains the branch you specify below.Type:String
compareTarget
-
The name of the branch within the named repository to compare against.
Type:String
$class: 'CheckoutOption'
-
timeout
-
Specify a timeout (in minutes) for checkout.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
$class: 'CleanBeforeCheckout'
-
Clean up the workspace before every checkout by deleting all untracked files and directories,
including those which are specified in.gitignore
.
It also resets all tracked files to their versioned state.
This ensures that the workspace is
in the same state as if you cloned and checked out in a brand-new empty directory, and ensures
that your build is not affected by the files generated by the previous build.deleteUntrackedNestedRepositories
(optional)-
Deletes untracked submodules and any other subdirectories which contain
.git
directories.Type:boolean
$class: 'CleanCheckout'
-
Clean up the workspace after every checkout by deleting all untracked files and directories,
including those which are specified in.gitignore
.
It also resets all tracked files to their versioned state.
This ensures that the workspace is
in the same state as if you cloned and checked out in a brand-new empty directory, and ensures
that your build is not affected by the files generated by the previous build.deleteUntrackedNestedRepositories
(optional)-
Deletes untracked submodules and any other subdirectories which contain
.git
directories.Type:boolean
$class: 'CloneOption'
-
shallow
-
Perform shallow clone, so that git will not download the history of the project,
saving time and disk space when you just want to access the latest version of a repository.Type:boolean
noTags
-
Deselect this to perform a clone without tags, saving time and disk space when you just want to access
what is specified by the refspec.Type:boolean
reference
-
Specify a folder containing a repository that will be used by Git as a reference during clone operations.
This option will be ignored if the folder is not available on the controller or agent where the clone is being executed.Type:String
timeout
-
Specify a timeout (in minutes) for clone and fetch operations.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
depth
(optional)-
Set shallow clone depth, so that git will only download recent history of the project,
saving time and disk space when you just want to access the latest commits of a repository.Type:int
honorRefspec
(optional)-
Perform initial clone using the refspec defined for the repository.
This can save time, data transfer and disk space when you only need
to access the references specified by the refspec.Type:boolean
$class: 'DisableRemotePoll'
-
Git plugin uses git ls-remote polling mechanism by default when configured with a single branch (no wildcards!).
This compare the latest built commit SHA with the remote branch without cloning a local copy of the repo.If you don’t want to / can’t use this.
If this option is selected, polling will require a workspace and might trigger unwanted builds (see JENKINS-10131).
$class: 'GitLFSPull'
-
Enable git large file support for the workspace by pulling large files after the checkout completes.
Requires that the controller and each agent performing an LFS checkout have installed `git lfs`. $class: 'IgnoreNotifyCommit'
-
If checked, this repository will be ignored when the notifyCommit-URL is accessed regardless of if the repository
matches or not. $class: 'LocalBranch'
-
If given, checkout the revision to build as HEAD on this branch.
If selected, and its value is an empty string or «**», then the branch
name is computed from the remote branch without the origin. In that
case, a remote branch origin/master will be checked out to a local
branch named master, and a remote branch origin/develop/new-feature
will be checked out to a local branch named develop/newfeature.Please note that this has not been tested with submodules.
localBranch
-
Type:String
$class: 'MessageExclusion'
-
excludedMessage
-
If set, and Jenkins is set to poll for changes, Jenkins will ignore any revisions committed with message matched to
Pattern when determining
if a build needs to be triggered. This can be used to exclude commits done by the build itself from triggering another build,
assuming the build server commits the change with a distinct message.Exclusion uses Pattern
matching.*[maven-release-plugin].*
The example above illustrates that if only revisions with «[maven-release-plugin]» message in first comment line
have been committed to the SCM a build will not occur.You can create more complex patterns using embedded flag expressions.
(?s).*FOO.*
This example will search FOO message in all comment lines.
Type:String
$class: 'PathRestriction'
-
If set, and Jenkins is set to poll for changes, Jenkins will pay attention to included and/or excluded files and/or
folders when determining if a build needs to be triggered.Using this behaviour will preclude the faster git ls-remote polling mechanism, forcing polling to require a workspace thus sometimes triggering unwanted builds, as if you had selected the Force polling using workspace extension as well.
includedRegions
-
Each inclusion uses java regular expression pattern matching,
and must be separated by a new line.
An empty list implies that everything is included.myapp/src/main/web/.*.html myapp/src/main/web/.*.jpeg myapp/src/main/web/.*.gif
The example above illustrates that a build will only occur, if html/jpeg/gif files
have been committed to the SCM. Exclusions take precedence over inclusions, if there is
an overlap between included and excluded regions.Type:String
excludedRegions
-
Each exclusion uses java regular expression pattern matching,
and must be separated by a new line.myapp/src/main/web/.*.html myapp/src/main/web/.*.jpeg myapp/src/main/web/.*.gif
The example above illustrates that if only html/jpeg/gif files have been committed to
the SCM a build will not occur.Type:String
$class: 'PerBuildTag'
-
Create a tag in the workspace for every build to unambiguously mark the commit that was built.
You can combine this with Git publisher to push the tags to the remote repository. $class: 'PreBuildMerge'
-
These options allow you to perform a merge to a particular branch before building.
For example, you could specify an integration branch to be built, and to merge to master.
In this scenario, on every change of integration, Jenkins will perform a merge with the master branch,
and try to perform a build if the merge is successful.
It then may push the merge back to the remote repository if the Git Push post-build action is selected.options
-
- Nested object
-
mergeTarget
-
The name of the branch within the named repository to merge to, such as
master
.Type:String
fastForwardMode
(optional)-
Merge fast-forward mode selection.
The default, —ff, gracefully falls back to a merge commit when required.
For more information, see the Git Merge Documentation mergeRemote
(optional)-
Name of the repository, such as
origin
, that contains the branch you specify below. If left blank,
it’ll default to the name of the first repository configured above.Type:String
mergeStrategy
(optional)-
Merge strategy selection.
This feature is not fully implemented in JGIT.Values:
DEFAULT
RESOLVE
RECURSIVE
OCTOPUS
OURS
SUBTREE
RECURSIVE_THEIRS
$class: 'PruneStaleBranch'
-
Run «git remote prune» for each remote, to prune obsolete local branches.
pruneTags
-
pruneTags
-
Type:boolean
$class: 'RelativeTargetDirectory'
-
relativeTargetDir
-
Specify a local directory (relative to the workspace root)
where the Git repository will be checked out. If left empty, the workspace root itself
will be used.This extension should not be used in Jenkins Pipeline (either declarative or scripted).
Jenkins Pipeline already provides standard techniques for checkout to a subdirectory.
Use ws and
dir
in Jenkins Pipeline rather than this extension.Type:String
$class: 'ScmName'
-
Unique name for this SCM. Needed when using Git within the Multi SCM plugin.
name
-
Type:String
$class: 'SparseCheckoutPaths'
-
Specify the paths that you’d like to sparse checkout. This may be used for saving space (Think about a reference repository).
Be sure to use a recent version of Git, at least above 1.7.10sparseCheckoutPaths
-
Array/List:
- Nested object
-
path
-
Type:String
$class: 'SubmoduleOption'
-
disableSubmodules
-
By disabling support for submodules you can still keep using basic
git plugin functionality and just have Jenkins to ignore submodules
completely as if they didn’t exist.Type:boolean
recursiveSubmodules
-
Retrieve all submodules recursively
(uses ‘—recursive’ option which requires git>=1.6.5)
Type:boolean
trackingSubmodules
-
Retrieve the tip of the configured branch in .gitmodules
(Uses ‘—remote’ option which requires git>=1.8.2)
Type:boolean
reference
-
Specify a folder containing a repository that will be used by Git as a reference during clone operations.
This option will be ignored if the folder is not available on the controller or agent where the clone is being executed.
To prepare a reference folder with multiple subprojects, create a bare git repository and add all the remote urls then perform a fetch:git init --bare git remote add SubProject1 https://gitrepo.com/subproject1 git remote add SubProject2 https://gitrepo.com/subproject2 git fetch --all
Type:String
timeout
-
Specify a timeout (in minutes) for submodules operations.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
parentCredentials
-
Use credentials from the default remote of the parent project.
Type:boolean
depth
(optional)-
Set shallow clone depth, so that git will only download recent history of the project,
saving time and disk space when you just want to access the latest commits of a repository.Type:int
shallow
(optional)-
Perform shallow clone, so that git will not download the history of the project,
saving time and disk space when you just want to access the latest version of a repository.Type:boolean
threads
(optional)-
Specify the number of threads that will be used to update submodules.
If unspecified, the command line git default thread count is used.Type:int
$class: 'UserExclusion'
-
excludedUsers
-
If set, and Jenkins is set to poll for changes, Jenkins will ignore any revisions committed by users in this list when determining if a build needs to be triggered. This can be used to exclude commits done by the build itself from triggering another build, assuming the build server commits the change with a distinct SCM user.
Using this behaviour will preclude the faster git ls-remote polling mechanism, forcing polling to require a workspace thus sometimes triggering unwanted builds, as if you had selected the Force polling using workspace extension as well.
Each exclusion uses exact string comparison and must be separated by a new line.
User names are only excluded if they exactly match one of the names in this list.auto_build_user
The example above illustrates that if only revisions by «auto_build_user» have been committed to the SCM a build will not occur.
Type:String
$class: 'UserIdentity'
-
name
-
If given, «GIT_COMMITTER_NAME=[this]» and «GIT_AUTHOR_NAME=[this]» are set for builds. This overrides whatever is in the global settings.
Type:String
email
-
If given, «GIT_COMMITTER_EMAIL=[this]» and «GIT_AUTHOR_EMAIL=[this]» are set for builds. This overrides whatever is in the global settings.
Type:String
$class: 'WipeWorkspace'
-
Delete the contents of the workspace before building, ensuring a fully fresh workspace.
gitTool
(optional)-
Type:String
id
(optional)-
Type:String
traits
(optional)-
Array/List:
- Nested choice of objects
-
$class: 'AuthorInChangelogTrait'
-
bitbucketBuildStatusNotifications
-
Configure the Bitbucket notifications.
disableNotificationForNotBuildJobs
(optional)-
Type:boolean
sendSuccessNotificationForUnstableBuild
(optional)-
Type:boolean
$class: 'CheckoutOptionTrait'
-
extension
-
- Nested object
-
timeout
-
Specify a timeout (in minutes) for checkout.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
$class: 'CleanAfterCheckoutTrait'
-
extension
-
- Nested object
-
Clean up the workspace after every checkout by deleting all untracked files and directories,
including those which are specified in.gitignore
.
It also resets all tracked files to their versioned state.
This ensures that the workspace is
in the same state as if you cloned and checked out in a brand-new empty directory, and ensures
that your build is not affected by the files generated by the previous build.deleteUntrackedNestedRepositories
(optional)-
Deletes untracked submodules and any other subdirectories which contain
.git
directories.Type:boolean
$class: 'CleanBeforeCheckoutTrait'
-
extension
-
- Nested object
-
Clean up the workspace before every checkout by deleting all untracked files and directories,
including those which are specified in.gitignore
.
It also resets all tracked files to their versioned state.
This ensures that the workspace is
in the same state as if you cloned and checked out in a brand-new empty directory, and ensures
that your build is not affected by the files generated by the previous build.deleteUntrackedNestedRepositories
(optional)-
Deletes untracked submodules and any other subdirectories which contain
.git
directories.Type:boolean
$class: 'CleanMercurialSCMSourceTrait'
-
When this behaviour is present, each build will wipe any local modifications
or untracked files in the repository checkout.
This is often a convenient way to ensure that a build is not
using any artifacts from earlier builds. $class: 'CloneOptionTrait'
-
extension
-
- Nested object
-
shallow
-
Perform shallow clone, so that git will not download the history of the project,
saving time and disk space when you just want to access the latest version of a repository.Type:boolean
noTags
-
Deselect this to perform a clone without tags, saving time and disk space when you just want to access
what is specified by the refspec.Type:boolean
reference
-
Specify a folder containing a repository that will be used by Git as a reference during clone operations.
This option will be ignored if the folder is not available on the controller or agent where the clone is being executed.Type:String
timeout
-
Specify a timeout (in minutes) for clone and fetch operations.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
depth
(optional)-
Set shallow clone depth, so that git will only download recent history of the project,
saving time and disk space when you just want to access the latest commits of a repository.Type:int
honorRefspec
(optional)-
Perform initial clone using the refspec defined for the repository.
This can save time, data transfer and disk space when you only need
to access the references specified by the refspec.Type:boolean
$class: 'DiscoverOtherRefsTrait'
-
Discovers other specified refs on the repository.
ref
-
The pattern under /refs on the remote repository to discover, can contain a wildcard.
Example: test/*/mergedType:String
nameMapping
(optional)-
Mapping for how the ref can be named in for example the
@Library
.
Example: test-@{1}
Where @{1} replaces the first wildcard in the ref when discovered.By default it will be «namespace_before_wildcard-@{1}». E.g. if ref is «test/*/merged» the default mapping would be
«test-@{1}».Type:String
$class: 'GitBrowserSCMSourceTrait'
-
browser
-
- Nested choice of objects
-
$class: 'AssemblaWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://www.assembla.com/code/PROJECT/git/).
Type:String
bitbucketServer
-
repoUrl
-
Specify the Bitbucket Server root URL for this repository (such as https://bitbucket:7990/OWNER/REPO/).
Type:String
$class: 'BitbucketWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://bitbucket.org/OWNER/REPO/).
Type:String
$class: 'CGit'
-
repoUrl
-
Specify the root URL serving this repository (such as http://cgit.example.com:port/group/REPO/).
Type:String
$class: 'FisheyeGitRepositoryBrowser'
-
repoUrl
-
Specify the URL of this repository in FishEye (such as http://fisheye6.cenqua.com/browse/ant/).
Type:String
$class: 'GitBlitRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository.
Type:String
projectName
-
Specify the name of the project in GitBlit.
Type:String
$class: 'GitLab'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gitlabserver:port/group/REPO/).
Type:String
version
(optional)-
Specify the major and minor version of GitLab you use (such as 9.1). If you
don’t specify a version, a modern version of GitLab (>= 8.0) is assumed.Type:String
$class: 'GitList'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gitlistserver:port/REPO/).
Type:String
$class: 'GitWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://github.com/jenkinsci/jenkins.git).
Type:String
$class: 'GithubWeb'
-
repoUrl
-
Specify the HTTP URL for this repository’s GitHub page (such as https://github.com/jquery/jquery).
Type:String
$class: 'Gitiles'
-
repoUrl
-
Specify the root URL serving this repository (such as https://gwt.googlesource.com/gwt/).
Type:String
$class: 'GitoriousWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://gitorious.org/gitorious/mainline).
Type:String
$class: 'GogsGit'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gogs.example.com:port/username/some-repo-url.git).
Type:String
$class: 'KilnGit'
-
repoUrl
-
Specify the root URL serving this repository (such as https://khanacademy.kilnhg.com/Code/Website/Group/webapp).
Type:String
$class: 'Phabricator'
-
repoUrl
-
Specify the phabricator instance root URL (such as http://phabricator.example.com).
Type:String
repo
-
Specify the repository name in phabricator (such as the foo part of phabricator.example.com/diffusion/foo/browse).
Type:String
$class: 'RedmineWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as http://SERVER/PATH/projects/PROJECT/repository).
Type:String
$class: 'RhodeCode'
-
repoUrl
-
Specify the HTTP URL for this repository’s RhodeCode page (such as http://rhodecode.mydomain.com:5000/projects/PROJECT/repos/REPO/).
Type:String
$class: 'ScmManagerGitRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository (such as https://scm-manager.org/scm/repo/namespace/name).
Type:String
$class: 'Stash'
-
repoUrl
-
Specify the HTTP URL for this repository’s Stash page (such as http://stash.mydomain.com:7990/projects/PROJECT/repos/REPO/).
Type:String
$class: 'TFS2013GitRepositoryBrowser'
-
repoUrl
-
Either the name of the remote whose URL should be used, or the URL of this
module in TFS (such as http://fisheye6.cenqua.com/tfs/PROJECT/_git/REPO/).
If empty (default), the URL of the «origin» repository is used.If TFS is also used as the repository server, this can usually be left blank.
Type:String
$class: 'ViewGitWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as http://code.fealdia.org/viewgit/).
Type:String
projectName
-
Specify the name of the project in ViewGit (e.g. scripts, scuttle etc. from http://code.fealdia.org/viewgit/).
Type:String
$class: 'GitLFSPullTrait'
-
$class: 'GitToolSCMSourceTrait'
-
gitTool
-
Type:String
gitHubIgnoreDraftPullRequestFilter
-
$class: 'IgnoreOnPushNotificationTrait'
-
$class: 'LocalBranchTrait'
-
$class: 'MercurialBrowserSCMSourceTrait'
-
browser
-
- Nested choice of objects
-
$class: 'FishEye'
-
url
-
Specify the root URL serving this repository, such as: http://www.example.org/browse/hg/
Type:String
$class: 'GoogleCode'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'HgWeb'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'Kallithea'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'KilnHG'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'RhodeCode'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'RhodeCodeLegacy'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'ScmManager'
-
url
-
Specify the root URL serving this repository (such as
http://YOURSCMMANAGER/scm/repo/NAMESPACE/NAME/
).Type:String
$class: 'MercurialInstallationSCMSourceTrait'
-
installation
-
Type:String
$class: 'PruneStaleBranchTrait'
-
$class: 'PruneStaleTagTrait'
-
bitbucketPublicRepoPullRequestFilter
-
If the repository being scanned is a public repository, this behaviour will exclude all pull requests.
(Note: This behaviour is not especially useful if scanning a single repository as you could just not include the
pull request discovery behaviours in the first place) $class: 'PullRequestDiscoveryTrait'
-
excludeBranchesWithPRs
-
Exclude branches for which there is an open pull request
Type:boolean
$class: 'RefSpecsSCMSourceTrait'
-
templates
-
Array/List:
- Nested object
-
value
-
A ref spec to fetch. Any occurrences of
@{remote}
will be replaced by the remote name
(which defaults toorigin
) before use.Type:String
headRegexFilter
-
regex
-
A Java regular expression to
restrict the names. Names that do not match the supplied regular expression will be ignored.
NOTE: this filter will be applied to all branch like things, including change requestsType:String
$class: 'RemoteNameSCMSourceTrait'
-
remoteName
-
Type:String
$class: 'SparseCheckoutPathsTrait'
-
extension
-
- Nested object
-
Specify the paths that you’d like to sparse checkout. This may be used for saving space (Think about a reference repository).
Be sure to use a recent version of Git, at least above 1.7.10sparseCheckoutPaths
-
Array/List:
- Nested object
-
path
-
Type:String
$class: 'SubmoduleOptionTrait'
-
extension
-
- Nested object
-
disableSubmodules
-
By disabling support for submodules you can still keep using basic
git plugin functionality and just have Jenkins to ignore submodules
completely as if they didn’t exist.Type:boolean
recursiveSubmodules
-
Retrieve all submodules recursively
(uses ‘—recursive’ option which requires git>=1.6.5)
Type:boolean
trackingSubmodules
-
Retrieve the tip of the configured branch in .gitmodules
(Uses ‘—remote’ option which requires git>=1.8.2)
Type:boolean
reference
-
Specify a folder containing a repository that will be used by Git as a reference during clone operations.
This option will be ignored if the folder is not available on the controller or agent where the clone is being executed.
To prepare a reference folder with multiple subprojects, create a bare git repository and add all the remote urls then perform a fetch:git init --bare git remote add SubProject1 https://gitrepo.com/subproject1 git remote add SubProject2 https://gitrepo.com/subproject2 git fetch --all
Type:String
timeout
-
Specify a timeout (in minutes) for submodules operations.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
parentCredentials
-
Use credentials from the default remote of the parent project.
Type:boolean
depth
(optional)-
Set shallow clone depth, so that git will only download recent history of the project,
saving time and disk space when you just want to access the latest commits of a repository.Type:int
shallow
(optional)-
Perform shallow clone, so that git will not download the history of the project,
saving time and disk space when you just want to access the latest version of a repository.Type:boolean
threads
(optional)-
Specify the number of threads that will be used to update submodules.
If unspecified, the command line git default thread count is used.Type:int
$class: 'UserIdentityTrait'
-
extension
-
- Nested object
-
name
-
If given, «GIT_COMMITTER_NAME=[this]» and «GIT_AUTHOR_NAME=[this]» are set for builds. This overrides whatever is in the global settings.
Type:String
email
-
If given, «GIT_COMMITTER_EMAIL=[this]» and «GIT_AUTHOR_EMAIL=[this]» are set for builds. This overrides whatever is in the global settings.
Type:String
bitbucketWebhookConfiguration
-
Sets the value for committersToIgnore in the Bitbucket Webhook. Value should be a comma separated string.
committerToIgnore is used to prevent triggering Jenkins builds when commits by certain users
are made.committersToIgnore
-
Type:String
bitbucketWebhookRegistration
-
Overrides the defaults for webhook management.
Webhooks are used to inform Jenkins about changes to repositories. There are two ways webhooks can be
configured:- Manual webhook configuration requires the user to configure Bitbucket with the Jenkins URL in order
to ensure that Bitbucket will send the events to Jenkins after every change. - Automatic webhook configuration requires that Jenkins has credentials with sufficient permission to
configure webhooks and also that Jenkins knows the URL that Bitbucket can connect to.
The Manage Jenkins » Configure Jenkins › Bitbucket Endpoints allows defining the list of
servers. Each server
can be associated with credentials. If credentials are defined then the default behaviour is to use those
credentials to automatically manage the webhooks of all repositories that Jenkins is interested in. If no
credentials are defined then the default behaviour is to require the user to manually configure webhooks.mode
-
There are two available modes:
- Disable hook management
- Disables hook management irrespective of the global defaults.
- Use item credentials for hook management
- Enabled hook management but uses the selected credentials to manage the hooks rather than those defined in
Manage Jenkins » Configure Jenkins › Bitbucket Endpoints
Type:String
- Manual webhook configuration requires the user to configure Bitbucket with the Jenkins URL in order
headWildcardFilter
-
includes
-
Space-separated list of name patterns to consider.
You may use*
as a wildcard; for example:master release*
NOTE: this filter will be applied to all branch like things, including change requestsType:String
excludes
-
Space-separated list of name patterns to ignore even if matched by the includes list.
For example:release alpha-* beta-*
NOTE: this filter will be applied to all branch like things, including change requestsType:String
$class: 'WipeWorkspaceTrait'
-
bitbucketBranchDiscovery
-
Discovers branches on the repository.
strategyId
-
Determines which branches are discovered.
- Exclude branches that are also filed as PRs
-
If you are discovering origin pull requests, it may not make sense to discover the same changes both as a
pull request and as a branch. - Only branches that are also filed as PRs
-
Discovers branches that have PR’s associated with them. This may make sense if you have a
notification sent to the team at the end of a triggered build or limited Jenkins resources. - All branches
-
Ignores whether the branch is also filed as a pull request and instead discovers all branches on the
origin repository.
Type:int
bitbucketForkDiscovery
-
Discovers pull requests where the origin repository is a fork of the target repository.
strategyId
-
Determines how pull requests are discovered.
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging
Type:int
trust
-
One of the great powers of pull requests is that anyone with read access to a repository can fork it, commit
some changes to their fork and then create a pull request against the original repository with their changes.
There are some files stored in source control that are important. For example, aJenkinsfile
may contain configuration details to sandbox pull requests in order to mitigate against malicious pull requests.
In order to protect against a malicious pull request itself modifying theJenkinsfile
to remove
the protections, you can define the trust policy for pull requests from forks.Other plugins can extend the available trust policies. The default policies are:
- Nobody
-
Pull requests from forks will all be treated as untrusted. This means that where Jenkins requires a
trusted file (e.g.Jenkinsfile
) the contents of that file will be retrieved from the
target branch on the origin repository and not from the pull request branch on the fork repository. - Forks in the same account
-
Bitbucket allows for a repository to be forked into a «sibling» repository in the same account but using
a different name. This strategy will trust any pull requests from forks that are in the same account as
the target repository on the basis that users have to have been granted write permission to account in
order create such a fork. - Everyone
-
All pull requests from forks will be treated as trusted. NOTE: this option can be dangerous
if used on a public repository hosted on Bitbucket Cloud.
java.lang.UnsupportedOperationException: do not know how to categorize attributes of type jenkins.scm.api.trait.SCMHeadAuthority<? super com.cloudbees.jenkins.plugins.bitbucket.BitbucketSCMSourceRequest, ? extends jenkins.scm.api.mixin.ChangeRequestSCMHead2, ? extends jenkins.scm.api.SCMRevision>
bitbucketPullRequestDiscovery
-
Discovers pull requests where the origin repository is the same as the target repository.
strategyId
-
Determines how pull requests are discovered.
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging
Type:int
bitbucketSshCheckout
-
By default the discovered branches / pull requests will all use the same credentials
that were used for discovery when checking out sources. This means that the checkout will be using the
https://
protocol for the Git repository.This behaviour allows you to select the SSH private key to be used for checking out sources, which will
consequently force the checkout to use thessh://
protocol.credentialsId
-
Credentials used to check out sources.
It must be a SSH key based credential.
Type:String
bitbucketTagDiscovery
-
Discovers tags on the repository.
$class: 'com.cloudogu.scmmanager.scm.BranchDiscoveryTrait'
-
$class: 'com.cloudogu.scmmanager.scm.TagDiscoveryTrait'
-
gitBranchDiscovery
-
Discovers branches on the repository.
gitTagDiscovery
-
Discovers tags on the repository.
gitHubBranchDiscovery
-
Discovers branches on the repository.
strategyId
-
Determines which branches are discovered.
- Exclude branches that are also filed as PRs
-
If you are discovering origin pull requests, you may not want to also build the source branches
for those pull requests. - Only branches that are also filed as PRs
-
Similar to discovering origin pull requests, but discovers the branch rather than the pull request.
This meansenv.GIT_BRANCH
will be set to the branch name rather thanPR-#
.
Also, status notifications for these builds will only be applied to the commit and not to the pull request. - All branches
-
Ignores whether the branch is also filed as a pull request and instead discovers all branches on the
origin repository.
Type:int
gitHubForkDiscovery
-
Discovers pull requests where the origin repository is a fork of the target repository.
strategyId
-
Determines how pull requests are discovered:
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch. - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging. - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging.
Type:int
trust
-
One of the great powers of pull requests is that anyone with read access to a repository can fork it, commit
some changes to their fork and then create a pull request against the original repository with their changes.
There are some files stored in source control that are important. For example, aJenkinsfile
may contain configuration details to sandbox pull requests in order to mitigate against malicious pull requests.
In order to protect against a malicious pull request itself modifying theJenkinsfile
to remove
the protections, you can define the trust policy for pull requests from forks.Other plugins can extend the available trust policies. The default policies are:
- Nobody
-
Pull requests from forks will all be treated as untrusted. This means that where Jenkins requires a
trusted file (e.g.Jenkinsfile
) the contents of that file will be retrieved from the
target branch on the origin repository and not from the pull request branch on the fork repository. - Collaborators
-
Pull requests from collaborators
to the origin repository will be treated as trusted, all other pull requests from fork repositories
will be treated as untrusted.
Note that if credentials used by Jenkins for scanning the repository does not have permission to
query the list of collaborators to the origin repository then only the origin account will be treated
as trusted — i.e. this will fall back toNobody
.
NOTE: all collaborators are trusted, even if they are only members of a team with read permission. - Everyone
-
All pull requests from forks will be treated as trusted. NOTE: this option can be dangerous
if used on a public repository hosted on GitHub. - From users with Admin or Write permission
-
Pull requests forks will be treated as trusted if and only if the fork owner has either Admin or Write
permissions on the origin repository.
This is the recommended policy.
Note that this strategy requires the
Review
a user’s permission level API, as a result on GitHub Enterprise Server versions before 2.12 this
is the same as trusting Nobody.
java.lang.UnsupportedOperationException: do not know how to categorize attributes of type jenkins.scm.api.trait.SCMHeadAuthority<? super org.jenkinsci.plugins.github_branch_source.GitHubSCMSourceRequest, ? extends jenkins.scm.api.mixin.ChangeRequestSCMHead2, ? extends jenkins.scm.api.SCMRevision>
gitHubPullRequestDiscovery
-
Discovers pull requests where the origin repository is the same as the target repository.
strategyId
-
Determines how pull requests are discovered:
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch. - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging. - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging.
Type:int
gitHubSshCheckout
-
By default the discovered branches / pull requests will all use the same username / password credentials
that were used for discovery when checking out sources. This means that the checkout will be using the
https://
protocol for the Git repository.This behaviour allows you to select the SSH private key to be used for checking out sources, which will
consequently force the checkout to use thessh://
protocol.credentialsId
-
Credentials used to check out sources. Must be a SSH key based credential.
Type:String
gitHubTagDiscovery
-
Discovers tags on the repository.
$class: 'MercurialSCMSource'
-
source
-
Specify the repository to track. This can be URL or a local file path.
If you are specifying HTTP credentials, do not include a username in the URL.Type:String
credentialsId
(optional)-
Optional credentials to use when cloning or pulling from the remote repository.
Supports username/password with HTTP(S) URLs, and SSH private key with SSH URLs.Type:String
id
(optional)-
Type:String
traits
(optional)-
Array/List:
- Nested choice of objects
-
$class: 'AuthorInChangelogTrait'
-
bitbucketBuildStatusNotifications
-
Configure the Bitbucket notifications.
disableNotificationForNotBuildJobs
(optional)-
Type:boolean
sendSuccessNotificationForUnstableBuild
(optional)-
Type:boolean
$class: 'CheckoutOptionTrait'
-
extension
-
- Nested object
-
timeout
-
Specify a timeout (in minutes) for checkout.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
$class: 'CleanAfterCheckoutTrait'
-
extension
-
- Nested object
-
Clean up the workspace after every checkout by deleting all untracked files and directories,
including those which are specified in.gitignore
.
It also resets all tracked files to their versioned state.
This ensures that the workspace is
in the same state as if you cloned and checked out in a brand-new empty directory, and ensures
that your build is not affected by the files generated by the previous build.deleteUntrackedNestedRepositories
(optional)-
Deletes untracked submodules and any other subdirectories which contain
.git
directories.Type:boolean
$class: 'CleanBeforeCheckoutTrait'
-
extension
-
- Nested object
-
Clean up the workspace before every checkout by deleting all untracked files and directories,
including those which are specified in.gitignore
.
It also resets all tracked files to their versioned state.
This ensures that the workspace is
in the same state as if you cloned and checked out in a brand-new empty directory, and ensures
that your build is not affected by the files generated by the previous build.deleteUntrackedNestedRepositories
(optional)-
Deletes untracked submodules and any other subdirectories which contain
.git
directories.Type:boolean
$class: 'CleanMercurialSCMSourceTrait'
-
When this behaviour is present, each build will wipe any local modifications
or untracked files in the repository checkout.
This is often a convenient way to ensure that a build is not
using any artifacts from earlier builds. $class: 'CloneOptionTrait'
-
extension
-
- Nested object
-
shallow
-
Perform shallow clone, so that git will not download the history of the project,
saving time and disk space when you just want to access the latest version of a repository.Type:boolean
noTags
-
Deselect this to perform a clone without tags, saving time and disk space when you just want to access
what is specified by the refspec.Type:boolean
reference
-
Specify a folder containing a repository that will be used by Git as a reference during clone operations.
This option will be ignored if the folder is not available on the controller or agent where the clone is being executed.Type:String
timeout
-
Specify a timeout (in minutes) for clone and fetch operations.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
depth
(optional)-
Set shallow clone depth, so that git will only download recent history of the project,
saving time and disk space when you just want to access the latest commits of a repository.Type:int
honorRefspec
(optional)-
Perform initial clone using the refspec defined for the repository.
This can save time, data transfer and disk space when you only need
to access the references specified by the refspec.Type:boolean
$class: 'DiscoverOtherRefsTrait'
-
Discovers other specified refs on the repository.
ref
-
The pattern under /refs on the remote repository to discover, can contain a wildcard.
Example: test/*/mergedType:String
nameMapping
(optional)-
Mapping for how the ref can be named in for example the
@Library
.
Example: test-@{1}
Where @{1} replaces the first wildcard in the ref when discovered.By default it will be «namespace_before_wildcard-@{1}». E.g. if ref is «test/*/merged» the default mapping would be
«test-@{1}».Type:String
$class: 'GitBrowserSCMSourceTrait'
-
browser
-
- Nested choice of objects
-
$class: 'AssemblaWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://www.assembla.com/code/PROJECT/git/).
Type:String
bitbucketServer
-
repoUrl
-
Specify the Bitbucket Server root URL for this repository (such as https://bitbucket:7990/OWNER/REPO/).
Type:String
$class: 'BitbucketWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://bitbucket.org/OWNER/REPO/).
Type:String
$class: 'CGit'
-
repoUrl
-
Specify the root URL serving this repository (such as http://cgit.example.com:port/group/REPO/).
Type:String
$class: 'FisheyeGitRepositoryBrowser'
-
repoUrl
-
Specify the URL of this repository in FishEye (such as http://fisheye6.cenqua.com/browse/ant/).
Type:String
$class: 'GitBlitRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository.
Type:String
projectName
-
Specify the name of the project in GitBlit.
Type:String
$class: 'GitLab'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gitlabserver:port/group/REPO/).
Type:String
version
(optional)-
Specify the major and minor version of GitLab you use (such as 9.1). If you
don’t specify a version, a modern version of GitLab (>= 8.0) is assumed.Type:String
$class: 'GitList'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gitlistserver:port/REPO/).
Type:String
$class: 'GitWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://github.com/jenkinsci/jenkins.git).
Type:String
$class: 'GithubWeb'
-
repoUrl
-
Specify the HTTP URL for this repository’s GitHub page (such as https://github.com/jquery/jquery).
Type:String
$class: 'Gitiles'
-
repoUrl
-
Specify the root URL serving this repository (such as https://gwt.googlesource.com/gwt/).
Type:String
$class: 'GitoriousWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://gitorious.org/gitorious/mainline).
Type:String
$class: 'GogsGit'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gogs.example.com:port/username/some-repo-url.git).
Type:String
$class: 'KilnGit'
-
repoUrl
-
Specify the root URL serving this repository (such as https://khanacademy.kilnhg.com/Code/Website/Group/webapp).
Type:String
$class: 'Phabricator'
-
repoUrl
-
Specify the phabricator instance root URL (such as http://phabricator.example.com).
Type:String
repo
-
Specify the repository name in phabricator (such as the foo part of phabricator.example.com/diffusion/foo/browse).
Type:String
$class: 'RedmineWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as http://SERVER/PATH/projects/PROJECT/repository).
Type:String
$class: 'RhodeCode'
-
repoUrl
-
Specify the HTTP URL for this repository’s RhodeCode page (such as http://rhodecode.mydomain.com:5000/projects/PROJECT/repos/REPO/).
Type:String
$class: 'ScmManagerGitRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository (such as https://scm-manager.org/scm/repo/namespace/name).
Type:String
$class: 'Stash'
-
repoUrl
-
Specify the HTTP URL for this repository’s Stash page (such as http://stash.mydomain.com:7990/projects/PROJECT/repos/REPO/).
Type:String
$class: 'TFS2013GitRepositoryBrowser'
-
repoUrl
-
Either the name of the remote whose URL should be used, or the URL of this
module in TFS (such as http://fisheye6.cenqua.com/tfs/PROJECT/_git/REPO/).
If empty (default), the URL of the «origin» repository is used.If TFS is also used as the repository server, this can usually be left blank.
Type:String
$class: 'ViewGitWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as http://code.fealdia.org/viewgit/).
Type:String
projectName
-
Specify the name of the project in ViewGit (e.g. scripts, scuttle etc. from http://code.fealdia.org/viewgit/).
Type:String
$class: 'GitLFSPullTrait'
-
$class: 'GitToolSCMSourceTrait'
-
gitTool
-
Type:String
gitHubIgnoreDraftPullRequestFilter
-
$class: 'IgnoreOnPushNotificationTrait'
-
$class: 'LocalBranchTrait'
-
$class: 'MercurialBrowserSCMSourceTrait'
-
browser
-
- Nested choice of objects
-
$class: 'FishEye'
-
url
-
Specify the root URL serving this repository, such as: http://www.example.org/browse/hg/
Type:String
$class: 'GoogleCode'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'HgWeb'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'Kallithea'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'KilnHG'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'RhodeCode'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'RhodeCodeLegacy'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'ScmManager'
-
url
-
Specify the root URL serving this repository (such as
http://YOURSCMMANAGER/scm/repo/NAMESPACE/NAME/
).Type:String
$class: 'MercurialInstallationSCMSourceTrait'
-
installation
-
Type:String
$class: 'PruneStaleBranchTrait'
-
$class: 'PruneStaleTagTrait'
-
bitbucketPublicRepoPullRequestFilter
-
If the repository being scanned is a public repository, this behaviour will exclude all pull requests.
(Note: This behaviour is not especially useful if scanning a single repository as you could just not include the
pull request discovery behaviours in the first place) $class: 'PullRequestDiscoveryTrait'
-
excludeBranchesWithPRs
-
Exclude branches for which there is an open pull request
Type:boolean
$class: 'RefSpecsSCMSourceTrait'
-
templates
-
Array/List:
- Nested object
-
value
-
A ref spec to fetch. Any occurrences of
@{remote}
will be replaced by the remote name
(which defaults toorigin
) before use.Type:String
headRegexFilter
-
regex
-
A Java regular expression to
restrict the names. Names that do not match the supplied regular expression will be ignored.
NOTE: this filter will be applied to all branch like things, including change requestsType:String
$class: 'RemoteNameSCMSourceTrait'
-
remoteName
-
Type:String
$class: 'SparseCheckoutPathsTrait'
-
extension
-
- Nested object
-
Specify the paths that you’d like to sparse checkout. This may be used for saving space (Think about a reference repository).
Be sure to use a recent version of Git, at least above 1.7.10sparseCheckoutPaths
-
Array/List:
- Nested object
-
path
-
Type:String
$class: 'SubmoduleOptionTrait'
-
extension
-
- Nested object
-
disableSubmodules
-
By disabling support for submodules you can still keep using basic
git plugin functionality and just have Jenkins to ignore submodules
completely as if they didn’t exist.Type:boolean
recursiveSubmodules
-
Retrieve all submodules recursively
(uses ‘—recursive’ option which requires git>=1.6.5)
Type:boolean
trackingSubmodules
-
Retrieve the tip of the configured branch in .gitmodules
(Uses ‘—remote’ option which requires git>=1.8.2)
Type:boolean
reference
-
Specify a folder containing a repository that will be used by Git as a reference during clone operations.
This option will be ignored if the folder is not available on the controller or agent where the clone is being executed.
To prepare a reference folder with multiple subprojects, create a bare git repository and add all the remote urls then perform a fetch:git init --bare git remote add SubProject1 https://gitrepo.com/subproject1 git remote add SubProject2 https://gitrepo.com/subproject2 git fetch --all
Type:String
timeout
-
Specify a timeout (in minutes) for submodules operations.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
parentCredentials
-
Use credentials from the default remote of the parent project.
Type:boolean
depth
(optional)-
Set shallow clone depth, so that git will only download recent history of the project,
saving time and disk space when you just want to access the latest commits of a repository.Type:int
shallow
(optional)-
Perform shallow clone, so that git will not download the history of the project,
saving time and disk space when you just want to access the latest version of a repository.Type:boolean
threads
(optional)-
Specify the number of threads that will be used to update submodules.
If unspecified, the command line git default thread count is used.Type:int
$class: 'UserIdentityTrait'
-
extension
-
- Nested object
-
name
-
If given, «GIT_COMMITTER_NAME=[this]» and «GIT_AUTHOR_NAME=[this]» are set for builds. This overrides whatever is in the global settings.
Type:String
email
-
If given, «GIT_COMMITTER_EMAIL=[this]» and «GIT_AUTHOR_EMAIL=[this]» are set for builds. This overrides whatever is in the global settings.
Type:String
bitbucketWebhookConfiguration
-
Sets the value for committersToIgnore in the Bitbucket Webhook. Value should be a comma separated string.
committerToIgnore is used to prevent triggering Jenkins builds when commits by certain users
are made.committersToIgnore
-
Type:String
bitbucketWebhookRegistration
-
Overrides the defaults for webhook management.
Webhooks are used to inform Jenkins about changes to repositories. There are two ways webhooks can be
configured:- Manual webhook configuration requires the user to configure Bitbucket with the Jenkins URL in order
to ensure that Bitbucket will send the events to Jenkins after every change. - Automatic webhook configuration requires that Jenkins has credentials with sufficient permission to
configure webhooks and also that Jenkins knows the URL that Bitbucket can connect to.
The Manage Jenkins » Configure Jenkins › Bitbucket Endpoints allows defining the list of
servers. Each server
can be associated with credentials. If credentials are defined then the default behaviour is to use those
credentials to automatically manage the webhooks of all repositories that Jenkins is interested in. If no
credentials are defined then the default behaviour is to require the user to manually configure webhooks.mode
-
There are two available modes:
- Disable hook management
- Disables hook management irrespective of the global defaults.
- Use item credentials for hook management
- Enabled hook management but uses the selected credentials to manage the hooks rather than those defined in
Manage Jenkins » Configure Jenkins › Bitbucket Endpoints
Type:String
- Manual webhook configuration requires the user to configure Bitbucket with the Jenkins URL in order
headWildcardFilter
-
includes
-
Space-separated list of name patterns to consider.
You may use*
as a wildcard; for example:master release*
NOTE: this filter will be applied to all branch like things, including change requestsType:String
excludes
-
Space-separated list of name patterns to ignore even if matched by the includes list.
For example:release alpha-* beta-*
NOTE: this filter will be applied to all branch like things, including change requestsType:String
$class: 'WipeWorkspaceTrait'
-
bitbucketBranchDiscovery
-
Discovers branches on the repository.
strategyId
-
Determines which branches are discovered.
- Exclude branches that are also filed as PRs
-
If you are discovering origin pull requests, it may not make sense to discover the same changes both as a
pull request and as a branch. - Only branches that are also filed as PRs
-
Discovers branches that have PR’s associated with them. This may make sense if you have a
notification sent to the team at the end of a triggered build or limited Jenkins resources. - All branches
-
Ignores whether the branch is also filed as a pull request and instead discovers all branches on the
origin repository.
Type:int
bitbucketForkDiscovery
-
Discovers pull requests where the origin repository is a fork of the target repository.
strategyId
-
Determines how pull requests are discovered.
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging
Type:int
trust
-
One of the great powers of pull requests is that anyone with read access to a repository can fork it, commit
some changes to their fork and then create a pull request against the original repository with their changes.
There are some files stored in source control that are important. For example, aJenkinsfile
may contain configuration details to sandbox pull requests in order to mitigate against malicious pull requests.
In order to protect against a malicious pull request itself modifying theJenkinsfile
to remove
the protections, you can define the trust policy for pull requests from forks.Other plugins can extend the available trust policies. The default policies are:
- Nobody
-
Pull requests from forks will all be treated as untrusted. This means that where Jenkins requires a
trusted file (e.g.Jenkinsfile
) the contents of that file will be retrieved from the
target branch on the origin repository and not from the pull request branch on the fork repository. - Forks in the same account
-
Bitbucket allows for a repository to be forked into a «sibling» repository in the same account but using
a different name. This strategy will trust any pull requests from forks that are in the same account as
the target repository on the basis that users have to have been granted write permission to account in
order create such a fork. - Everyone
-
All pull requests from forks will be treated as trusted. NOTE: this option can be dangerous
if used on a public repository hosted on Bitbucket Cloud.
java.lang.UnsupportedOperationException: do not know how to categorize attributes of type jenkins.scm.api.trait.SCMHeadAuthority<? super com.cloudbees.jenkins.plugins.bitbucket.BitbucketSCMSourceRequest, ? extends jenkins.scm.api.mixin.ChangeRequestSCMHead2, ? extends jenkins.scm.api.SCMRevision>
bitbucketPullRequestDiscovery
-
Discovers pull requests where the origin repository is the same as the target repository.
strategyId
-
Determines how pull requests are discovered.
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging
Type:int
bitbucketSshCheckout
-
By default the discovered branches / pull requests will all use the same credentials
that were used for discovery when checking out sources. This means that the checkout will be using the
https://
protocol for the Git repository.This behaviour allows you to select the SSH private key to be used for checking out sources, which will
consequently force the checkout to use thessh://
protocol.credentialsId
-
Credentials used to check out sources.
It must be a SSH key based credential.
Type:String
bitbucketTagDiscovery
-
Discovers tags on the repository.
$class: 'com.cloudogu.scmmanager.scm.BranchDiscoveryTrait'
-
$class: 'com.cloudogu.scmmanager.scm.TagDiscoveryTrait'
-
gitBranchDiscovery
-
Discovers branches on the repository.
gitTagDiscovery
-
Discovers tags on the repository.
gitHubBranchDiscovery
-
Discovers branches on the repository.
strategyId
-
Determines which branches are discovered.
- Exclude branches that are also filed as PRs
-
If you are discovering origin pull requests, you may not want to also build the source branches
for those pull requests. - Only branches that are also filed as PRs
-
Similar to discovering origin pull requests, but discovers the branch rather than the pull request.
This meansenv.GIT_BRANCH
will be set to the branch name rather thanPR-#
.
Also, status notifications for these builds will only be applied to the commit and not to the pull request. - All branches
-
Ignores whether the branch is also filed as a pull request and instead discovers all branches on the
origin repository.
Type:int
gitHubForkDiscovery
-
Discovers pull requests where the origin repository is a fork of the target repository.
strategyId
-
Determines how pull requests are discovered:
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch. - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging. - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging.
Type:int
trust
-
One of the great powers of pull requests is that anyone with read access to a repository can fork it, commit
some changes to their fork and then create a pull request against the original repository with their changes.
There are some files stored in source control that are important. For example, aJenkinsfile
may contain configuration details to sandbox pull requests in order to mitigate against malicious pull requests.
In order to protect against a malicious pull request itself modifying theJenkinsfile
to remove
the protections, you can define the trust policy for pull requests from forks.Other plugins can extend the available trust policies. The default policies are:
- Nobody
-
Pull requests from forks will all be treated as untrusted. This means that where Jenkins requires a
trusted file (e.g.Jenkinsfile
) the contents of that file will be retrieved from the
target branch on the origin repository and not from the pull request branch on the fork repository. - Collaborators
-
Pull requests from collaborators
to the origin repository will be treated as trusted, all other pull requests from fork repositories
will be treated as untrusted.
Note that if credentials used by Jenkins for scanning the repository does not have permission to
query the list of collaborators to the origin repository then only the origin account will be treated
as trusted — i.e. this will fall back toNobody
.
NOTE: all collaborators are trusted, even if they are only members of a team with read permission. - Everyone
-
All pull requests from forks will be treated as trusted. NOTE: this option can be dangerous
if used on a public repository hosted on GitHub. - From users with Admin or Write permission
-
Pull requests forks will be treated as trusted if and only if the fork owner has either Admin or Write
permissions on the origin repository.
This is the recommended policy.
Note that this strategy requires the
Review
a user’s permission level API, as a result on GitHub Enterprise Server versions before 2.12 this
is the same as trusting Nobody.
java.lang.UnsupportedOperationException: do not know how to categorize attributes of type jenkins.scm.api.trait.SCMHeadAuthority<? super org.jenkinsci.plugins.github_branch_source.GitHubSCMSourceRequest, ? extends jenkins.scm.api.mixin.ChangeRequestSCMHead2, ? extends jenkins.scm.api.SCMRevision>
gitHubPullRequestDiscovery
-
Discovers pull requests where the origin repository is the same as the target repository.
strategyId
-
Determines how pull requests are discovered:
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch. - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging. - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging.
Type:int
gitHubSshCheckout
-
By default the discovered branches / pull requests will all use the same username / password credentials
that were used for discovery when checking out sources. This means that the checkout will be using the
https://
protocol for the Git repository.This behaviour allows you to select the SSH private key to be used for checking out sources, which will
consequently force the checkout to use thessh://
protocol.credentialsId
-
Credentials used to check out sources. Must be a SSH key based credential.
Type:String
gitHubTagDiscovery
-
Discovers tags on the repository.
scmManager
-
serverUrl
-
Specify the root URL of the SCM-Manager instance including the context path (such as https://scm-manager.org/scm/)
or an ssh URL (such as ssh://scm-manager.com:2222/; this requires the
SSH plugin in SCM-Manager).Type:String
repository
-
Select an existing repository from the SCM-Manager instance.
Type:String
credentialsId
-
Select valid credentials for the specified SCM-Manager instance.
Type:String
id
(optional)-
Type:String
traits
(optional)-
Array/List:
- Nested choice of objects
-
$class: 'AuthorInChangelogTrait'
-
bitbucketBuildStatusNotifications
-
Configure the Bitbucket notifications.
disableNotificationForNotBuildJobs
(optional)-
Type:boolean
sendSuccessNotificationForUnstableBuild
(optional)-
Type:boolean
$class: 'CheckoutOptionTrait'
-
extension
-
- Nested object
-
timeout
-
Specify a timeout (in minutes) for checkout.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
$class: 'CleanAfterCheckoutTrait'
-
extension
-
- Nested object
-
Clean up the workspace after every checkout by deleting all untracked files and directories,
including those which are specified in.gitignore
.
It also resets all tracked files to their versioned state.
This ensures that the workspace is
in the same state as if you cloned and checked out in a brand-new empty directory, and ensures
that your build is not affected by the files generated by the previous build.deleteUntrackedNestedRepositories
(optional)-
Deletes untracked submodules and any other subdirectories which contain
.git
directories.Type:boolean
$class: 'CleanBeforeCheckoutTrait'
-
extension
-
- Nested object
-
Clean up the workspace before every checkout by deleting all untracked files and directories,
including those which are specified in.gitignore
.
It also resets all tracked files to their versioned state.
This ensures that the workspace is
in the same state as if you cloned and checked out in a brand-new empty directory, and ensures
that your build is not affected by the files generated by the previous build.deleteUntrackedNestedRepositories
(optional)-
Deletes untracked submodules and any other subdirectories which contain
.git
directories.Type:boolean
$class: 'CleanMercurialSCMSourceTrait'
-
When this behaviour is present, each build will wipe any local modifications
or untracked files in the repository checkout.
This is often a convenient way to ensure that a build is not
using any artifacts from earlier builds. $class: 'CloneOptionTrait'
-
extension
-
- Nested object
-
shallow
-
Perform shallow clone, so that git will not download the history of the project,
saving time and disk space when you just want to access the latest version of a repository.Type:boolean
noTags
-
Deselect this to perform a clone without tags, saving time and disk space when you just want to access
what is specified by the refspec.Type:boolean
reference
-
Specify a folder containing a repository that will be used by Git as a reference during clone operations.
This option will be ignored if the folder is not available on the controller or agent where the clone is being executed.Type:String
timeout
-
Specify a timeout (in minutes) for clone and fetch operations.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
depth
(optional)-
Set shallow clone depth, so that git will only download recent history of the project,
saving time and disk space when you just want to access the latest commits of a repository.Type:int
honorRefspec
(optional)-
Perform initial clone using the refspec defined for the repository.
This can save time, data transfer and disk space when you only need
to access the references specified by the refspec.Type:boolean
$class: 'DiscoverOtherRefsTrait'
-
Discovers other specified refs on the repository.
ref
-
The pattern under /refs on the remote repository to discover, can contain a wildcard.
Example: test/*/mergedType:String
nameMapping
(optional)-
Mapping for how the ref can be named in for example the
@Library
.
Example: test-@{1}
Where @{1} replaces the first wildcard in the ref when discovered.By default it will be «namespace_before_wildcard-@{1}». E.g. if ref is «test/*/merged» the default mapping would be
«test-@{1}».Type:String
$class: 'GitBrowserSCMSourceTrait'
-
browser
-
- Nested choice of objects
-
$class: 'AssemblaWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://www.assembla.com/code/PROJECT/git/).
Type:String
bitbucketServer
-
repoUrl
-
Specify the Bitbucket Server root URL for this repository (such as https://bitbucket:7990/OWNER/REPO/).
Type:String
$class: 'BitbucketWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://bitbucket.org/OWNER/REPO/).
Type:String
$class: 'CGit'
-
repoUrl
-
Specify the root URL serving this repository (such as http://cgit.example.com:port/group/REPO/).
Type:String
$class: 'FisheyeGitRepositoryBrowser'
-
repoUrl
-
Specify the URL of this repository in FishEye (such as http://fisheye6.cenqua.com/browse/ant/).
Type:String
$class: 'GitBlitRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository.
Type:String
projectName
-
Specify the name of the project in GitBlit.
Type:String
$class: 'GitLab'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gitlabserver:port/group/REPO/).
Type:String
version
(optional)-
Specify the major and minor version of GitLab you use (such as 9.1). If you
don’t specify a version, a modern version of GitLab (>= 8.0) is assumed.Type:String
$class: 'GitList'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gitlistserver:port/REPO/).
Type:String
$class: 'GitWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://github.com/jenkinsci/jenkins.git).
Type:String
$class: 'GithubWeb'
-
repoUrl
-
Specify the HTTP URL for this repository’s GitHub page (such as https://github.com/jquery/jquery).
Type:String
$class: 'Gitiles'
-
repoUrl
-
Specify the root URL serving this repository (such as https://gwt.googlesource.com/gwt/).
Type:String
$class: 'GitoriousWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://gitorious.org/gitorious/mainline).
Type:String
$class: 'GogsGit'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gogs.example.com:port/username/some-repo-url.git).
Type:String
$class: 'KilnGit'
-
repoUrl
-
Specify the root URL serving this repository (such as https://khanacademy.kilnhg.com/Code/Website/Group/webapp).
Type:String
$class: 'Phabricator'
-
repoUrl
-
Specify the phabricator instance root URL (such as http://phabricator.example.com).
Type:String
repo
-
Specify the repository name in phabricator (such as the foo part of phabricator.example.com/diffusion/foo/browse).
Type:String
$class: 'RedmineWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as http://SERVER/PATH/projects/PROJECT/repository).
Type:String
$class: 'RhodeCode'
-
repoUrl
-
Specify the HTTP URL for this repository’s RhodeCode page (such as http://rhodecode.mydomain.com:5000/projects/PROJECT/repos/REPO/).
Type:String
$class: 'ScmManagerGitRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository (such as https://scm-manager.org/scm/repo/namespace/name).
Type:String
$class: 'Stash'
-
repoUrl
-
Specify the HTTP URL for this repository’s Stash page (such as http://stash.mydomain.com:7990/projects/PROJECT/repos/REPO/).
Type:String
$class: 'TFS2013GitRepositoryBrowser'
-
repoUrl
-
Either the name of the remote whose URL should be used, or the URL of this
module in TFS (such as http://fisheye6.cenqua.com/tfs/PROJECT/_git/REPO/).
If empty (default), the URL of the «origin» repository is used.If TFS is also used as the repository server, this can usually be left blank.
Type:String
$class: 'ViewGitWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as http://code.fealdia.org/viewgit/).
Type:String
projectName
-
Specify the name of the project in ViewGit (e.g. scripts, scuttle etc. from http://code.fealdia.org/viewgit/).
Type:String
$class: 'GitLFSPullTrait'
-
$class: 'GitToolSCMSourceTrait'
-
gitTool
-
Type:String
gitHubIgnoreDraftPullRequestFilter
-
$class: 'IgnoreOnPushNotificationTrait'
-
$class: 'LocalBranchTrait'
-
$class: 'MercurialBrowserSCMSourceTrait'
-
browser
-
- Nested choice of objects
-
$class: 'FishEye'
-
url
-
Specify the root URL serving this repository, such as: http://www.example.org/browse/hg/
Type:String
$class: 'GoogleCode'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'HgWeb'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'Kallithea'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'KilnHG'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'RhodeCode'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'RhodeCodeLegacy'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'ScmManager'
-
url
-
Specify the root URL serving this repository (such as
http://YOURSCMMANAGER/scm/repo/NAMESPACE/NAME/
).Type:String
$class: 'MercurialInstallationSCMSourceTrait'
-
installation
-
Type:String
$class: 'PruneStaleBranchTrait'
-
$class: 'PruneStaleTagTrait'
-
bitbucketPublicRepoPullRequestFilter
-
If the repository being scanned is a public repository, this behaviour will exclude all pull requests.
(Note: This behaviour is not especially useful if scanning a single repository as you could just not include the
pull request discovery behaviours in the first place) $class: 'PullRequestDiscoveryTrait'
-
excludeBranchesWithPRs
-
Exclude branches for which there is an open pull request
Type:boolean
$class: 'RefSpecsSCMSourceTrait'
-
templates
-
Array/List:
- Nested object
-
value
-
A ref spec to fetch. Any occurrences of
@{remote}
will be replaced by the remote name
(which defaults toorigin
) before use.Type:String
headRegexFilter
-
regex
-
A Java regular expression to
restrict the names. Names that do not match the supplied regular expression will be ignored.
NOTE: this filter will be applied to all branch like things, including change requestsType:String
$class: 'RemoteNameSCMSourceTrait'
-
remoteName
-
Type:String
$class: 'SparseCheckoutPathsTrait'
-
extension
-
- Nested object
-
Specify the paths that you’d like to sparse checkout. This may be used for saving space (Think about a reference repository).
Be sure to use a recent version of Git, at least above 1.7.10sparseCheckoutPaths
-
Array/List:
- Nested object
-
path
-
Type:String
$class: 'SubmoduleOptionTrait'
-
extension
-
- Nested object
-
disableSubmodules
-
By disabling support for submodules you can still keep using basic
git plugin functionality and just have Jenkins to ignore submodules
completely as if they didn’t exist.Type:boolean
recursiveSubmodules
-
Retrieve all submodules recursively
(uses ‘—recursive’ option which requires git>=1.6.5)
Type:boolean
trackingSubmodules
-
Retrieve the tip of the configured branch in .gitmodules
(Uses ‘—remote’ option which requires git>=1.8.2)
Type:boolean
reference
-
Specify a folder containing a repository that will be used by Git as a reference during clone operations.
This option will be ignored if the folder is not available on the controller or agent where the clone is being executed.
To prepare a reference folder with multiple subprojects, create a bare git repository and add all the remote urls then perform a fetch:git init --bare git remote add SubProject1 https://gitrepo.com/subproject1 git remote add SubProject2 https://gitrepo.com/subproject2 git fetch --all
Type:String
timeout
-
Specify a timeout (in minutes) for submodules operations.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
parentCredentials
-
Use credentials from the default remote of the parent project.
Type:boolean
depth
(optional)-
Set shallow clone depth, so that git will only download recent history of the project,
saving time and disk space when you just want to access the latest commits of a repository.Type:int
shallow
(optional)-
Perform shallow clone, so that git will not download the history of the project,
saving time and disk space when you just want to access the latest version of a repository.Type:boolean
threads
(optional)-
Specify the number of threads that will be used to update submodules.
If unspecified, the command line git default thread count is used.Type:int
$class: 'UserIdentityTrait'
-
extension
-
- Nested object
-
name
-
If given, «GIT_COMMITTER_NAME=[this]» and «GIT_AUTHOR_NAME=[this]» are set for builds. This overrides whatever is in the global settings.
Type:String
email
-
If given, «GIT_COMMITTER_EMAIL=[this]» and «GIT_AUTHOR_EMAIL=[this]» are set for builds. This overrides whatever is in the global settings.
Type:String
bitbucketWebhookConfiguration
-
Sets the value for committersToIgnore in the Bitbucket Webhook. Value should be a comma separated string.
committerToIgnore is used to prevent triggering Jenkins builds when commits by certain users
are made.committersToIgnore
-
Type:String
bitbucketWebhookRegistration
-
Overrides the defaults for webhook management.
Webhooks are used to inform Jenkins about changes to repositories. There are two ways webhooks can be
configured:- Manual webhook configuration requires the user to configure Bitbucket with the Jenkins URL in order
to ensure that Bitbucket will send the events to Jenkins after every change. - Automatic webhook configuration requires that Jenkins has credentials with sufficient permission to
configure webhooks and also that Jenkins knows the URL that Bitbucket can connect to.
The Manage Jenkins » Configure Jenkins › Bitbucket Endpoints allows defining the list of
servers. Each server
can be associated with credentials. If credentials are defined then the default behaviour is to use those
credentials to automatically manage the webhooks of all repositories that Jenkins is interested in. If no
credentials are defined then the default behaviour is to require the user to manually configure webhooks.mode
-
There are two available modes:
- Disable hook management
- Disables hook management irrespective of the global defaults.
- Use item credentials for hook management
- Enabled hook management but uses the selected credentials to manage the hooks rather than those defined in
Manage Jenkins » Configure Jenkins › Bitbucket Endpoints
Type:String
- Manual webhook configuration requires the user to configure Bitbucket with the Jenkins URL in order
headWildcardFilter
-
includes
-
Space-separated list of name patterns to consider.
You may use*
as a wildcard; for example:master release*
NOTE: this filter will be applied to all branch like things, including change requestsType:String
excludes
-
Space-separated list of name patterns to ignore even if matched by the includes list.
For example:release alpha-* beta-*
NOTE: this filter will be applied to all branch like things, including change requestsType:String
$class: 'WipeWorkspaceTrait'
-
bitbucketBranchDiscovery
-
Discovers branches on the repository.
strategyId
-
Determines which branches are discovered.
- Exclude branches that are also filed as PRs
-
If you are discovering origin pull requests, it may not make sense to discover the same changes both as a
pull request and as a branch. - Only branches that are also filed as PRs
-
Discovers branches that have PR’s associated with them. This may make sense if you have a
notification sent to the team at the end of a triggered build or limited Jenkins resources. - All branches
-
Ignores whether the branch is also filed as a pull request and instead discovers all branches on the
origin repository.
Type:int
bitbucketForkDiscovery
-
Discovers pull requests where the origin repository is a fork of the target repository.
strategyId
-
Determines how pull requests are discovered.
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging
Type:int
trust
-
One of the great powers of pull requests is that anyone with read access to a repository can fork it, commit
some changes to their fork and then create a pull request against the original repository with their changes.
There are some files stored in source control that are important. For example, aJenkinsfile
may contain configuration details to sandbox pull requests in order to mitigate against malicious pull requests.
In order to protect against a malicious pull request itself modifying theJenkinsfile
to remove
the protections, you can define the trust policy for pull requests from forks.Other plugins can extend the available trust policies. The default policies are:
- Nobody
-
Pull requests from forks will all be treated as untrusted. This means that where Jenkins requires a
trusted file (e.g.Jenkinsfile
) the contents of that file will be retrieved from the
target branch on the origin repository and not from the pull request branch on the fork repository. - Forks in the same account
-
Bitbucket allows for a repository to be forked into a «sibling» repository in the same account but using
a different name. This strategy will trust any pull requests from forks that are in the same account as
the target repository on the basis that users have to have been granted write permission to account in
order create such a fork. - Everyone
-
All pull requests from forks will be treated as trusted. NOTE: this option can be dangerous
if used on a public repository hosted on Bitbucket Cloud.
java.lang.UnsupportedOperationException: do not know how to categorize attributes of type jenkins.scm.api.trait.SCMHeadAuthority<? super com.cloudbees.jenkins.plugins.bitbucket.BitbucketSCMSourceRequest, ? extends jenkins.scm.api.mixin.ChangeRequestSCMHead2, ? extends jenkins.scm.api.SCMRevision>
bitbucketPullRequestDiscovery
-
Discovers pull requests where the origin repository is the same as the target repository.
strategyId
-
Determines how pull requests are discovered.
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging
Type:int
bitbucketSshCheckout
-
By default the discovered branches / pull requests will all use the same credentials
that were used for discovery when checking out sources. This means that the checkout will be using the
https://
protocol for the Git repository.This behaviour allows you to select the SSH private key to be used for checking out sources, which will
consequently force the checkout to use thessh://
protocol.credentialsId
-
Credentials used to check out sources.
It must be a SSH key based credential.
Type:String
bitbucketTagDiscovery
-
Discovers tags on the repository.
$class: 'com.cloudogu.scmmanager.scm.BranchDiscoveryTrait'
-
$class: 'com.cloudogu.scmmanager.scm.TagDiscoveryTrait'
-
gitBranchDiscovery
-
Discovers branches on the repository.
gitTagDiscovery
-
Discovers tags on the repository.
gitHubBranchDiscovery
-
Discovers branches on the repository.
strategyId
-
Determines which branches are discovered.
- Exclude branches that are also filed as PRs
-
If you are discovering origin pull requests, you may not want to also build the source branches
for those pull requests. - Only branches that are also filed as PRs
-
Similar to discovering origin pull requests, but discovers the branch rather than the pull request.
This meansenv.GIT_BRANCH
will be set to the branch name rather thanPR-#
.
Also, status notifications for these builds will only be applied to the commit and not to the pull request. - All branches
-
Ignores whether the branch is also filed as a pull request and instead discovers all branches on the
origin repository.
Type:int
gitHubForkDiscovery
-
Discovers pull requests where the origin repository is a fork of the target repository.
strategyId
-
Determines how pull requests are discovered:
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch. - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging. - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging.
Type:int
trust
-
One of the great powers of pull requests is that anyone with read access to a repository can fork it, commit
some changes to their fork and then create a pull request against the original repository with their changes.
There are some files stored in source control that are important. For example, aJenkinsfile
may contain configuration details to sandbox pull requests in order to mitigate against malicious pull requests.
In order to protect against a malicious pull request itself modifying theJenkinsfile
to remove
the protections, you can define the trust policy for pull requests from forks.Other plugins can extend the available trust policies. The default policies are:
- Nobody
-
Pull requests from forks will all be treated as untrusted. This means that where Jenkins requires a
trusted file (e.g.Jenkinsfile
) the contents of that file will be retrieved from the
target branch on the origin repository and not from the pull request branch on the fork repository. - Collaborators
-
Pull requests from collaborators
to the origin repository will be treated as trusted, all other pull requests from fork repositories
will be treated as untrusted.
Note that if credentials used by Jenkins for scanning the repository does not have permission to
query the list of collaborators to the origin repository then only the origin account will be treated
as trusted — i.e. this will fall back toNobody
.
NOTE: all collaborators are trusted, even if they are only members of a team with read permission. - Everyone
-
All pull requests from forks will be treated as trusted. NOTE: this option can be dangerous
if used on a public repository hosted on GitHub. - From users with Admin or Write permission
-
Pull requests forks will be treated as trusted if and only if the fork owner has either Admin or Write
permissions on the origin repository.
This is the recommended policy.
Note that this strategy requires the
Review
a user’s permission level API, as a result on GitHub Enterprise Server versions before 2.12 this
is the same as trusting Nobody.
java.lang.UnsupportedOperationException: do not know how to categorize attributes of type jenkins.scm.api.trait.SCMHeadAuthority<? super org.jenkinsci.plugins.github_branch_source.GitHubSCMSourceRequest, ? extends jenkins.scm.api.mixin.ChangeRequestSCMHead2, ? extends jenkins.scm.api.SCMRevision>
gitHubPullRequestDiscovery
-
Discovers pull requests where the origin repository is the same as the target repository.
strategyId
-
Determines how pull requests are discovered:
- Merging the pull request with the current target branch revision
- Discover each pull request once with the discovered revision corresponding to the result of merging with the
current revision of the target branch. - The current pull request revision
- Discover each pull request once with the discovered revision corresponding to the pull request head revision
without merging. - Both the current pull request revision and the pull request merged with the current target branch revision
- Discover each pull request twice. The first discovered revision corresponds to the result of merging with
the current revision of the target branch in each scan. The second parallel discovered revision corresponds
to the pull request head revision without merging.
Type:int
gitHubSshCheckout
-
By default the discovered branches / pull requests will all use the same username / password credentials
that were used for discovery when checking out sources. This means that the checkout will be using the
https://
protocol for the Git repository.This behaviour allows you to select the SSH private key to be used for checking out sources, which will
consequently force the checkout to use thessh://
protocol.credentialsId
-
Credentials used to check out sources. Must be a SSH key based credential.
Type:String
gitHubTagDiscovery
-
Discovers tags on the repository.
scmManagerSvn
-
serverUrl
-
Specify the root URL of the SCM-Manager instance including the context path (such as https://scm-manager.org/scm/).
Type:String
repository
-
Select an existing repository from the SCM-Manager instance.
Type:String
id
(optional)-
Type:String
credentialsId
(optional)-
Select valid credentials for the specified SCM-Manager instance.
Type:String
browser
(optional)-
- Nested choice of objects
-
$class: 'Assembla'
-
spaceName
-
Type:String
$class: 'CollabNetSVN'
-
url
-
The repository browser URL for the root of the project.
For example, a Java.net project calledmyproject
would use
https://myproject.dev.java.net/source/browse/myproject
.
Type:String
$class: 'FishEyeSVN'
-
url
-
Specify the URL of this module in FishEye.
(such ashttp://fisheye6.cenqua.com/browse/ant/
)
Type:String
rootModule
-
Specify the root Subversion module that this FishEye monitors.
For example, forhttp://fisheye6.cenqua.com/browse/ant/
,
this field would beant
because it displays the directory «/ant»
of the ASF repo. If FishEye is configured to display the whole SVN repository,
leave this field empty.Type:String
svnPhabricator
-
url
-
Type:String
repo
-
Type:String
$class: 'SVNWeb'
-
url
-
Type:String
$class: 'ScmManagerSvnRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository (such as https://scm-manager.org/scm/repo/namespace/name).
Type:String
$class: 'Sventon'
-
url
-
Specify the URL of the Sventon repository browser.
For example, if you normally browse fromhttp://somehost.com/svn/repobrowser.svn?name=local
,
this field would behttp://somehost.com/svn/
Type:String
repositoryInstance
-
Specify the Sventon repository instance name that references this subversion repository.
For example, if you normally browse fromhttp://somehost.com/svn/repobrowser.svn?name=local
,
this field would belocal
Type:String
$class: 'Sventon2'
-
url
-
Specify the URL of the Sventon repository browser.
For example, if you normally browse fromhttp://somehost.com/svn/repobrowser.svn?name=local
,
this field would behttp://somehost.com/svn/
Type:String
repositoryInstance
-
Specify the Sventon repository instance name that references this subversion repository.
For example, if you normally browse fromhttp://somehost.com/svn/repobrowser.svn?name=local
,
this field would belocal
Type:String
$class: 'ViewSVN'
-
url
-
Specify the root URL of ViewSVN for this repository
(such as this).Type:String
$class: 'VisualSVN'
-
url
-
Type:String
$class: 'WebSVN'
-
url
-
Type:String
excludes
(optional)-
Optionally specify branches to be excluded from builds using glob expressions.
Type:String
includes
(optional)-
Specify the branches to be build using glob expressions (like trunk,branches/*,tags/*,sandbox/*).
Type:String
workspaceUpdater
(optional)-
- Nested choice of objects
-
$class: 'CheckoutUpdater'
-
$class: 'NoopUpdater'
-
$class: 'UpdateUpdater'
-
$class: 'UpdateWithCleanUpdater'
-
$class: 'UpdateWithRevertUpdater'
-
fromScm
-
name
-
The name of the SCM head/trunk/branch/tag that this source provides.
Type:String
scm
-
- Nested choice of objects
-
$class: 'GitSCM'
-
The git plugin provides fundamental git operations for Jenkins projects.
It can poll, fetch, checkout, and merge contents of git repositories.The git plugin provides an SCM implementation to be used with the Pipeline SCM
checkout
step.
The Pipeline Syntax Snippet Generator guides the user to select git plugin checkout options and provides online help for each of the options.userRemoteConfigs
-
Specify the repository to track. This can be a URL or a local file path.
Note that for super-projects (repositories with submodules), only a local file
path or a complete URL is valid. The following are examples of valid git URLs.- ssh://git@github.com/github/git.git
- git@github.com:github/git.git (short notation for ssh protocol)
- ssh://user@other.host.com/~/repos/R.git (to access the repos/R.git
repository in the user’s home directory) - https://github.com/github/git.git
If the repository is a super-project, the
location from which to clone submodules is dependent on whether the repository
is bare or non-bare (i.e. has a working directory).- If the super-project is bare, the location of the submodules will be
taken from .gitmodules. - If the super-project is not bare, it is assumed that the
repository has each of its submodules cloned and checked out appropriately.
Thus, the submodules will be taken directly from a path like
${SUPER_PROJECT_URL}/${SUBMODULE}
, rather than relying on
information from .gitmodules.
For a local URL/path to a super-project,
git rev-parse —is-bare-repository
is used to detect whether the super-project is bare or not.
For a remote URL to a super-project, the ending of the URL determines whether
a bare or non-bare repository is assumed:- If the remote URL ends with /.git, a non-bare repository is
assumed. - If the remote URL does NOT end with /.git, a bare
repository is assumed.
Array/List:
- Nested object
-
url
-
Specify the URL or path of the git repository.
This uses the same syntax as yourgit clone
command.Type:String
name
-
ID of the repository, such as
origin
, to uniquely identify this repository among other remote repositories.
This is the same «name» that you use in yourgit remote
command. If left empty,
Jenkins will generate unique names for you.You normally want to specify this when you have multiple remote repositories.
Type:String
refspec
-
A refspec controls the remote refs to be retrieved and how they map to local refs. If left blank, it will default to
the normal behaviour ofgit fetch
, which retrieves all the branch heads asremotes/REPOSITORYNAME/BRANCHNAME
.
This default behaviour is OK for most cases.In other words, the default refspec is «+refs/heads/*:refs/remotes/REPOSITORYNAME/*» where
REPOSITORYNAME
is the value
you specify in the above «name of repository» textbox.When do you want to modify this value? A good example is when you want to just retrieve one branch. For example,
+refs/heads/master:refs/remotes/origin/master
would only retrieve the master branch and nothing else.The plugin uses a default refspec for its initial fetch, unless the «Advanced Clone Option» is set to honor refspec.
This keeps compatibility with previous behavior, and allows the job definition to decide if the refspec should be
honored on initial clone.Multiple refspecs can be entered by separating them with a space character.
+refs/heads/master:refs/remotes/origin/master +refs/heads/develop:refs/remotes/origin/develop
retrieves the master branch and the develop branch and nothing else.See the refspec definition in Git user manual for more details.
Type:String
credentialsId
-
Credential used to check out sources.
Type:String
branches
-
List of branches to build.
Jenkins jobs are most effective when each job builds only a single branch.
When a single job builds multiple branches, the changelog comparisons between branches often show no changes or incorrect changes.Array/List:
- Nested object
-
name
-
Specify the branches if you’d like to track a specific branch in a repository.
If left blank, all branches will be examined for changes and built.The safest way is to use the
refs/heads/<branchName>
syntax. This way the expected branch
is unambiguous.If your branch name has a
/
in it make sure to use the full reference above. When not presented
with a full path the plugin will only use the part of the string right of the last slash.
Meaningfoo/bar
will actually matchbar
.If you use a wildcard branch specifier, with a slash (e.g.
release/
),
you’ll need to specify the origin repository in the branch names to
make sure changes are picked up. So e.g.origin/release/
Possible options:
-
<branchName>
Tracks/checks out the specified branch. If ambiguous the first result is taken, which is not necessarily
the expected one. Better userefs/heads/<branchName>
.
E.g.master
,feature1
, … -
refs/heads/<branchName>
Tracks/checks out the specified branch.
E.g.refs/heads/master
,refs/heads/feature1/master
, … -
<remoteRepoName>/<branchName>
Tracks/checks out the specified branch. If ambiguous the first result is taken, which is not necessarily
the expected one.
Better userefs/heads/<branchName>
.
E.g.origin/master
-
remotes/<remoteRepoName>/<branchName>
Tracks/checks out the specified branch.
E.g.remotes/origin/master
-
refs/remotes/<remoteRepoName>/<branchName>
Tracks/checks out the specified branch.
E.g.refs/remotes/origin/master
-
<tagName>
This does not work since the tag will not be recognized as tag.
Userefs/tags/<tagName>
instead.
E.g.git-2.3.0
-
refs/tags/<tagName>
Tracks/checks out the specified tag.
E.g.refs/tags/git-2.3.0
-
<commitId>
Checks out the specified commit.
E.g.5062ac843f2b947733e6a3b105977056821bd352
,5062ac84
, … -
${ENV_VARIABLE}
It is also possible to use environment variables. In this case the variables are evaluated and the
result is used as described above.
E.g.${TREEISH}
,refs/tags/${TAGNAME}
, … -
<Wildcards>
The syntax is of the form:REPOSITORYNAME/BRANCH
.
In addition,BRANCH
is recognized as a shorthand of*/BRANCH
, ‘*’ is recognized as a wildcard,
and ‘**’ is recognized as wildcard that includes the separator ‘/’. Therefore,origin/branches*
would
matchorigin/branches-foo
but notorigin/branches/foo
, whileorigin/branches**
would
match bothorigin/branches-foo
andorigin/branches/foo
. -
:<regular expression>
The syntax is of the form::regexp
.
Regular expression syntax in branches to build will only
build those branches whose names match the regular
expression.
Examples::^(?!(origin/prefix)).*
- matches:
origin
ororigin/master
ororigin/feature
- does not match:
origin/prefix
ororigin/prefix_123
ororigin/prefix-abc
- matches:
:origin/release-d{8}
- matches:
origin/release-20150101
- does not match:
origin/release-2015010
ororigin/release-201501011
ororigin/release-20150101-something
- matches:
:^(?!origin/master$|origin/develop$).*
- matches:
origin/branch1
ororigin/branch-2
ororigin/master123
ororigin/develop-123
- does not match:
origin/master
ororigin/develop
- matches:
Type:String
-
browser
-
Defines the repository browser that displays changes detected by the git plugin.
- Nested choice of objects
-
$class: 'AssemblaWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://www.assembla.com/code/PROJECT/git/).
Type:String
bitbucketServer
-
repoUrl
-
Specify the Bitbucket Server root URL for this repository (such as https://bitbucket:7990/OWNER/REPO/).
Type:String
$class: 'BitbucketWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://bitbucket.org/OWNER/REPO/).
Type:String
$class: 'CGit'
-
repoUrl
-
Specify the root URL serving this repository (such as http://cgit.example.com:port/group/REPO/).
Type:String
$class: 'FisheyeGitRepositoryBrowser'
-
repoUrl
-
Specify the URL of this repository in FishEye (such as http://fisheye6.cenqua.com/browse/ant/).
Type:String
$class: 'GitBlitRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository.
Type:String
projectName
-
Specify the name of the project in GitBlit.
Type:String
$class: 'GitLab'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gitlabserver:port/group/REPO/).
Type:String
version
(optional)-
Specify the major and minor version of GitLab you use (such as 9.1). If you
don’t specify a version, a modern version of GitLab (>= 8.0) is assumed.Type:String
$class: 'GitList'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gitlistserver:port/REPO/).
Type:String
$class: 'GitWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://github.com/jenkinsci/jenkins.git).
Type:String
$class: 'GithubWeb'
-
repoUrl
-
Specify the HTTP URL for this repository’s GitHub page (such as https://github.com/jquery/jquery).
Type:String
$class: 'Gitiles'
-
repoUrl
-
Specify the root URL serving this repository (such as https://gwt.googlesource.com/gwt/).
Type:String
$class: 'GitoriousWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as https://gitorious.org/gitorious/mainline).
Type:String
$class: 'GogsGit'
-
repoUrl
-
Specify the root URL serving this repository (such as http://gogs.example.com:port/username/some-repo-url.git).
Type:String
$class: 'KilnGit'
-
repoUrl
-
Specify the root URL serving this repository (such as https://khanacademy.kilnhg.com/Code/Website/Group/webapp).
Type:String
$class: 'Phabricator'
-
repoUrl
-
Specify the phabricator instance root URL (such as http://phabricator.example.com).
Type:String
repo
-
Specify the repository name in phabricator (such as the foo part of phabricator.example.com/diffusion/foo/browse).
Type:String
$class: 'RedmineWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as http://SERVER/PATH/projects/PROJECT/repository).
Type:String
$class: 'RhodeCode'
-
repoUrl
-
Specify the HTTP URL for this repository’s RhodeCode page (such as http://rhodecode.mydomain.com:5000/projects/PROJECT/repos/REPO/).
Type:String
$class: 'ScmManagerGitRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository (such as https://scm-manager.org/scm/repo/namespace/name).
Type:String
$class: 'Stash'
-
repoUrl
-
Specify the HTTP URL for this repository’s Stash page (such as http://stash.mydomain.com:7990/projects/PROJECT/repos/REPO/).
Type:String
$class: 'TFS2013GitRepositoryBrowser'
-
repoUrl
-
Either the name of the remote whose URL should be used, or the URL of this
module in TFS (such as http://fisheye6.cenqua.com/tfs/PROJECT/_git/REPO/).
If empty (default), the URL of the «origin» repository is used.If TFS is also used as the repository server, this can usually be left blank.
Type:String
$class: 'ViewGitWeb'
-
repoUrl
-
Specify the root URL serving this repository (such as http://code.fealdia.org/viewgit/).
Type:String
projectName
-
Specify the name of the project in ViewGit (e.g. scripts, scuttle etc. from http://code.fealdia.org/viewgit/).
Type:String
gitTool
-
Absolute path to the git executable.
This is different from other Jenkins tool definitions.
Rather than providing the directory that contains the executable, you must provide the complete path to the executable.
Setting ‘/usr/bin/git
‘ would be correct, while setting ‘/usr/bin/
‘ is not correct.Type:String
extensions
-
Extensions add new behavior or modify existing plugin behavior for different uses.
Extensions help users more precisely tune plugin behavior to meet their needs.Extensions include:
-
Clone extensions modify the git operations that retrieve remote changes into the agent workspace.
The extensions can adjust the amount of history retrieved, how long the retrieval is allowed to run, and other retrieval details. -
Checkout extensions modify the git operations that place files in the workspace from the git repository on the agent.
The extensions can adjust the maximum duration of the checkout operation, the use and behavior of git submodules, the location of the workspace on the disc, and more. - Changelog extensions adapt the source code difference calculations for different cases.
- Tagging extensions allow the plugin to apply tags in the current workspace.
-
Build initiation extensions control the conditions that start a build.
They can ignore notifications of a change or force a deeper evaluation of the commits when polling. -
Merge extensions can optionally merge changes from other branches into the current branch of the agent workspace.
They control the source branch for the merge and the options applied to the merge.
Array/List:
- Nested choice of objects
-
$class: 'AuthorInChangelog'
-
The default behavior is to use the Git commit’s «Committer» value in Jenkins’ build changesets.
If this option is selected, the Git commit’s «Author» value would be used instead. $class: 'BuildChooserSetting'
-
When you are interested in using a job to build multiple heads (most typically multiple branches),
you can choose how Jenkins choose what branches to build in what order.This extension point in Jenkins is used by many other plugins to control the job to build
specific commits. When you activate those plugins, you may see them installing a custom strategy
here.buildChooser
-
- Nested choice of objects
-
$class: 'AncestryBuildChooser'
-
maximumAgeInDays
-
Type:int
ancestorCommitSha1
-
Type:String
$class: 'DefaultBuildChooser'
-
$class: 'InverseBuildChooser'
-
$class: 'BuildSingleRevisionOnly'
-
Disable scheduling for multiple candidate revisions.
If we have 3 branches:
—-A—.—.— B
——C
jenkins would try to build (B) and (C).
This behaviour disables this and only builds one of them.
It is helpful to reduce the load of the Jenkins infrastructure when the
SCM system like Bitbucket or GitHub should decide what commits to build. $class: 'ChangelogToBranch'
-
This method calculates the changelog against the specified branch.
options
-
- Nested object
-
compareRemote
-
Name of the repository, such as
origin
, that contains the branch you specify below.Type:String
compareTarget
-
The name of the branch within the named repository to compare against.
Type:String
$class: 'CheckoutOption'
-
timeout
-
Specify a timeout (in minutes) for checkout.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
$class: 'CleanBeforeCheckout'
-
Clean up the workspace before every checkout by deleting all untracked files and directories,
including those which are specified in.gitignore
.
It also resets all tracked files to their versioned state.
This ensures that the workspace is
in the same state as if you cloned and checked out in a brand-new empty directory, and ensures
that your build is not affected by the files generated by the previous build.deleteUntrackedNestedRepositories
(optional)-
Deletes untracked submodules and any other subdirectories which contain
.git
directories.Type:boolean
$class: 'CleanCheckout'
-
Clean up the workspace after every checkout by deleting all untracked files and directories,
including those which are specified in.gitignore
.
It also resets all tracked files to their versioned state.
This ensures that the workspace is
in the same state as if you cloned and checked out in a brand-new empty directory, and ensures
that your build is not affected by the files generated by the previous build.deleteUntrackedNestedRepositories
(optional)-
Deletes untracked submodules and any other subdirectories which contain
.git
directories.Type:boolean
$class: 'CloneOption'
-
shallow
-
Perform shallow clone, so that git will not download the history of the project,
saving time and disk space when you just want to access the latest version of a repository.Type:boolean
noTags
-
Deselect this to perform a clone without tags, saving time and disk space when you just want to access
what is specified by the refspec.Type:boolean
reference
-
Specify a folder containing a repository that will be used by Git as a reference during clone operations.
This option will be ignored if the folder is not available on the controller or agent where the clone is being executed.Type:String
timeout
-
Specify a timeout (in minutes) for clone and fetch operations.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
depth
(optional)-
Set shallow clone depth, so that git will only download recent history of the project,
saving time and disk space when you just want to access the latest commits of a repository.Type:int
honorRefspec
(optional)-
Perform initial clone using the refspec defined for the repository.
This can save time, data transfer and disk space when you only need
to access the references specified by the refspec.Type:boolean
$class: 'DisableRemotePoll'
-
Git plugin uses git ls-remote polling mechanism by default when configured with a single branch (no wildcards!).
This compare the latest built commit SHA with the remote branch without cloning a local copy of the repo.If you don’t want to / can’t use this.
If this option is selected, polling will require a workspace and might trigger unwanted builds (see JENKINS-10131).
$class: 'GitLFSPull'
-
Enable git large file support for the workspace by pulling large files after the checkout completes.
Requires that the controller and each agent performing an LFS checkout have installed `git lfs`. $class: 'IgnoreNotifyCommit'
-
If checked, this repository will be ignored when the notifyCommit-URL is accessed regardless of if the repository
matches or not. $class: 'LocalBranch'
-
If given, checkout the revision to build as HEAD on this branch.
If selected, and its value is an empty string or «**», then the branch
name is computed from the remote branch without the origin. In that
case, a remote branch origin/master will be checked out to a local
branch named master, and a remote branch origin/develop/new-feature
will be checked out to a local branch named develop/newfeature.Please note that this has not been tested with submodules.
localBranch
-
Type:String
$class: 'MessageExclusion'
-
excludedMessage
-
If set, and Jenkins is set to poll for changes, Jenkins will ignore any revisions committed with message matched to
Pattern when determining
if a build needs to be triggered. This can be used to exclude commits done by the build itself from triggering another build,
assuming the build server commits the change with a distinct message.Exclusion uses Pattern
matching.*[maven-release-plugin].*
The example above illustrates that if only revisions with «[maven-release-plugin]» message in first comment line
have been committed to the SCM a build will not occur.You can create more complex patterns using embedded flag expressions.
(?s).*FOO.*
This example will search FOO message in all comment lines.
Type:String
$class: 'PathRestriction'
-
If set, and Jenkins is set to poll for changes, Jenkins will pay attention to included and/or excluded files and/or
folders when determining if a build needs to be triggered.Using this behaviour will preclude the faster git ls-remote polling mechanism, forcing polling to require a workspace thus sometimes triggering unwanted builds, as if you had selected the Force polling using workspace extension as well.
includedRegions
-
Each inclusion uses java regular expression pattern matching,
and must be separated by a new line.
An empty list implies that everything is included.myapp/src/main/web/.*.html myapp/src/main/web/.*.jpeg myapp/src/main/web/.*.gif
The example above illustrates that a build will only occur, if html/jpeg/gif files
have been committed to the SCM. Exclusions take precedence over inclusions, if there is
an overlap between included and excluded regions.Type:String
excludedRegions
-
Each exclusion uses java regular expression pattern matching,
and must be separated by a new line.myapp/src/main/web/.*.html myapp/src/main/web/.*.jpeg myapp/src/main/web/.*.gif
The example above illustrates that if only html/jpeg/gif files have been committed to
the SCM a build will not occur.Type:String
$class: 'PerBuildTag'
-
Create a tag in the workspace for every build to unambiguously mark the commit that was built.
You can combine this with Git publisher to push the tags to the remote repository. $class: 'PreBuildMerge'
-
These options allow you to perform a merge to a particular branch before building.
For example, you could specify an integration branch to be built, and to merge to master.
In this scenario, on every change of integration, Jenkins will perform a merge with the master branch,
and try to perform a build if the merge is successful.
It then may push the merge back to the remote repository if the Git Push post-build action is selected.options
-
- Nested object
-
mergeTarget
-
The name of the branch within the named repository to merge to, such as
master
.Type:String
fastForwardMode
(optional)-
Merge fast-forward mode selection.
The default, —ff, gracefully falls back to a merge commit when required.
For more information, see the Git Merge Documentation mergeRemote
(optional)-
Name of the repository, such as
origin
, that contains the branch you specify below. If left blank,
it’ll default to the name of the first repository configured above.Type:String
mergeStrategy
(optional)-
Merge strategy selection.
This feature is not fully implemented in JGIT.Values:
DEFAULT
RESOLVE
RECURSIVE
OCTOPUS
OURS
SUBTREE
RECURSIVE_THEIRS
$class: 'PruneStaleBranch'
-
Run «git remote prune» for each remote, to prune obsolete local branches.
pruneTags
-
pruneTags
-
Type:boolean
$class: 'RelativeTargetDirectory'
-
relativeTargetDir
-
Specify a local directory (relative to the workspace root)
where the Git repository will be checked out. If left empty, the workspace root itself
will be used.This extension should not be used in Jenkins Pipeline (either declarative or scripted).
Jenkins Pipeline already provides standard techniques for checkout to a subdirectory.
Use ws and
dir
in Jenkins Pipeline rather than this extension.Type:String
$class: 'ScmName'
-
Unique name for this SCM. Needed when using Git within the Multi SCM plugin.
name
-
Type:String
$class: 'SparseCheckoutPaths'
-
Specify the paths that you’d like to sparse checkout. This may be used for saving space (Think about a reference repository).
Be sure to use a recent version of Git, at least above 1.7.10sparseCheckoutPaths
-
Array/List:
- Nested object
-
path
-
Type:String
$class: 'SubmoduleOption'
-
disableSubmodules
-
By disabling support for submodules you can still keep using basic
git plugin functionality and just have Jenkins to ignore submodules
completely as if they didn’t exist.Type:boolean
recursiveSubmodules
-
Retrieve all submodules recursively
(uses ‘—recursive’ option which requires git>=1.6.5)
Type:boolean
trackingSubmodules
-
Retrieve the tip of the configured branch in .gitmodules
(Uses ‘—remote’ option which requires git>=1.8.2)
Type:boolean
reference
-
Specify a folder containing a repository that will be used by Git as a reference during clone operations.
This option will be ignored if the folder is not available on the controller or agent where the clone is being executed.
To prepare a reference folder with multiple subprojects, create a bare git repository and add all the remote urls then perform a fetch:git init --bare git remote add SubProject1 https://gitrepo.com/subproject1 git remote add SubProject2 https://gitrepo.com/subproject2 git fetch --all
Type:String
timeout
-
Specify a timeout (in minutes) for submodules operations.
This option overrides the default timeout of 10 minutes.
You can change the global git timeout via the property org.jenkinsci.plugins.gitclient.Git.timeOut (see JENKINS-11286).
Note that property should be set on both controller and agent to have effect (see JENKINS-22547).Type:int
parentCredentials
-
Use credentials from the default remote of the parent project.
Type:boolean
depth
(optional)-
Set shallow clone depth, so that git will only download recent history of the project,
saving time and disk space when you just want to access the latest commits of a repository.Type:int
shallow
(optional)-
Perform shallow clone, so that git will not download the history of the project,
saving time and disk space when you just want to access the latest version of a repository.Type:boolean
threads
(optional)-
Specify the number of threads that will be used to update submodules.
If unspecified, the command line git default thread count is used.Type:int
$class: 'UserExclusion'
-
excludedUsers
-
If set, and Jenkins is set to poll for changes, Jenkins will ignore any revisions committed by users in this list when determining if a build needs to be triggered. This can be used to exclude commits done by the build itself from triggering another build, assuming the build server commits the change with a distinct SCM user.
Using this behaviour will preclude the faster git ls-remote polling mechanism, forcing polling to require a workspace thus sometimes triggering unwanted builds, as if you had selected the Force polling using workspace extension as well.
Each exclusion uses exact string comparison and must be separated by a new line.
User names are only excluded if they exactly match one of the names in this list.auto_build_user
The example above illustrates that if only revisions by «auto_build_user» have been committed to the SCM a build will not occur.
Type:String
$class: 'UserIdentity'
-
name
-
If given, «GIT_COMMITTER_NAME=[this]» and «GIT_AUTHOR_NAME=[this]» are set for builds. This overrides whatever is in the global settings.
Type:String
email
-
If given, «GIT_COMMITTER_EMAIL=[this]» and «GIT_AUTHOR_EMAIL=[this]» are set for builds. This overrides whatever is in the global settings.
Type:String
$class: 'WipeWorkspace'
-
Delete the contents of the workspace before building, ensuring a fully fresh workspace.
-
Clone extensions modify the git operations that retrieve remote changes into the agent workspace.
doGenerateSubmoduleConfigurations
(optional)-
Removed facility that was intended to test combinations of git submodule versions.
Removed in git plugin 4.6.0.
Ignores the user provided value and always usesfalse
as its value.Type:boolean
submoduleCfg
(optional)-
Removed facility that was intended to test combinations of git submodule versions.
Removed in git plugin 4.6.0.
Ignores the user provided value(s) and always uses empty values.Array/List:
- Nested object
-
submoduleName
-
Removed in git plugin 4.6.0.
Type:String
branches
-
Removed in git plugin 4.6.0.
$class: 'MercurialSCM'
-
source
-
Specify the repository to track. This can be URL or a local file path.
If you are specifying HTTP credentials, do not include a username in the URL.Type:String
browser
(optional)-
- Nested choice of objects
-
$class: 'FishEye'
-
url
-
Specify the root URL serving this repository, such as: http://www.example.org/browse/hg/
Type:String
$class: 'GoogleCode'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'HgWeb'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'Kallithea'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'KilnHG'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'RhodeCode'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'RhodeCodeLegacy'
-
url
-
Specify the root URL serving this repository (such as this).
Type:String
$class: 'ScmManager'
-
url
-
Specify the root URL serving this repository (such as
http://YOURSCMMANAGER/scm/repo/NAMESPACE/NAME/
).Type:String
clean
(optional)-
When this option is checked, each build will wipe any local modifications
or untracked files in the repository checkout.
This is often a convenient way to ensure that a build is not
using any artifacts from earlier builds.Type:boolean
credentialsId
(optional)-
Optional credentials to use when cloning or pulling from the remote repository.
Supports username/password with HTTP(S) URLs, and SSH private key with SSH URLs.Type:String
disableChangeLog
(optional)-
When checked, Hudson will not calculate the Mercurial changelog for each build.
Disabling the changelog can decrease the amount of time needed to update a
very large repository.Type:boolean
installation
(optional)-
Type:String
modules
(optional)-
Reduce unnecessary builds by specifying a comma or space delimited list of «modules» within the repository.
A module is a directory name within the repository that this project lives in. If this field is set,
changes outside the specified modules will not trigger a build (even though the whole repository is checked
out anyway due to the Mercurial limitation.)Type:String
revision
(optional)-
Specify the branch or tag name you would like to track.
(If you do not type anything, the default value is thedefault
branch.)Type:String
revisionType
(optional)-
Specify the kind of revision you expect Jenkins to update your working copy to.
Values:
BRANCH
TAG
CHANGESET
REVSET
subdir
(optional)-
If not empty, check out the Mercurial repository into this subdirectory of the
job’s workspace. For example:my/sources
(use forward slashes).
If changing this entry, you probably want to clean the workspace first.Type:String
none
-
$class: 'SubversionSCM'
-
Checks out the source code from Subversion repositories. See
post-commit hook set up for improved turn-around time and
performance in polling.locations
-
Array/List:
- Nested object
-
remote
-
Type:String
credentialsId
-
Type:String
local
-
Specify a local directory (relative to the workspace root)
where this module is checked out. If left empty, the last path component of the URL
is used as the default, just like thesvn
CLI.
A single period (.
) may be used to check out the project directly
into the workspace rather than into a subdirectory.Type:String
depthOption
-
—depth
option for checkout and update commands. Default value is
infinity
.
- empty includes only the immediate target of the operation, not any of its file or directory children.
- files includes the immediate target of the operation and any of its immediate file children.
- immediates includes the immediate target of the operation and any of its immediate file or directory children. The directory children will themselves be empty.
- infinity includes the immediate target, its file and directory children, its children’s children, and so on to full recursion.
- as-it-is takes the working depth from the current working copy, allows for setting update depth manually using —set-depth option.
More information can be found
here.Type:String
ignoreExternalsOption
-
«—ignore-externals» option will be used with svn checkout, svn update commands to disable externals definition processing.
More information can be found
here.
Note: there is the potential to leveragesvn:externals
to gain read access to the entire
Subversion repository. This can happen if you follow the normal practice of giving Jenkins
credentials with read access to the entire Subversion repository. You will also need to provide the credentials
to use when checking/polling out the svn:externals using the Additional Credentials option.Type:boolean
cancelProcessOnExternalsFail
-
Determines if the process should be cancelled when checkout/update svn:externals failed. Will work when «Ignore externals» box is not checked.
Default choice is to cancelled the process when checkout/update svn:externals failed.Type:boolean
workspaceUpdater
-
- Nested choice of objects
-
$class: 'CheckoutUpdater'
-
$class: 'NoopUpdater'
-
$class: 'UpdateUpdater'
-
$class: 'UpdateWithCleanUpdater'
-
$class: 'UpdateWithRevertUpdater'
-
browser
-
- Nested choice of objects
-
$class: 'Assembla'
-
spaceName
-
Type:String
$class: 'CollabNetSVN'
-
url
-
The repository browser URL for the root of the project.
For example, a Java.net project calledmyproject
would use
https://myproject.dev.java.net/source/browse/myproject
.
Type:String
$class: 'FishEyeSVN'
-
url
-
Specify the URL of this module in FishEye.
(such ashttp://fisheye6.cenqua.com/browse/ant/
)
Type:String
rootModule
-
Specify the root Subversion module that this FishEye monitors.
For example, forhttp://fisheye6.cenqua.com/browse/ant/
,
this field would beant
because it displays the directory «/ant»
of the ASF repo. If FishEye is configured to display the whole SVN repository,
leave this field empty.Type:String
svnPhabricator
-
url
-
Type:String
repo
-
Type:String
$class: 'SVNWeb'
-
url
-
Type:String
$class: 'ScmManagerSvnRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository (such as https://scm-manager.org/scm/repo/namespace/name).
Type:String
$class: 'Sventon'
-
url
-
Specify the URL of the Sventon repository browser.
For example, if you normally browse fromhttp://somehost.com/svn/repobrowser.svn?name=local
,
this field would behttp://somehost.com/svn/
Type:String
repositoryInstance
-
Specify the Sventon repository instance name that references this subversion repository.
For example, if you normally browse fromhttp://somehost.com/svn/repobrowser.svn?name=local
,
this field would belocal
Type:String
$class: 'Sventon2'
-
url
-
Specify the URL of the Sventon repository browser.
For example, if you normally browse fromhttp://somehost.com/svn/repobrowser.svn?name=local
,
this field would behttp://somehost.com/svn/
Type:String
repositoryInstance
-
Specify the Sventon repository instance name that references this subversion repository.
For example, if you normally browse fromhttp://somehost.com/svn/repobrowser.svn?name=local
,
this field would belocal
Type:String
$class: 'ViewSVN'
-
url
-
Specify the root URL of ViewSVN for this repository
(such as this).Type:String
$class: 'VisualSVN'
-
url
-
Type:String
$class: 'WebSVN'
-
url
-
Type:String
excludedRegions
-
If set, and Jenkins is set to poll for changes, Jenkins will ignore any files and/or
folders in this list when determining if a build needs to be triggered.Each exclusion uses regular expression pattern matching, and must be separated by a new line.
/trunk/myapp/src/main/web/.*.html /trunk/myapp/src/main/web/.*.jpeg /trunk/myapp/src/main/web/.*.gif
The example above illustrates that if only html/jpeg/gif files have been committed to
the SCM a build will not occur.More information on regular expressions can be found
here.Type:String
excludedUsers
-
If set, and Jenkins is set to poll for changes, Jenkins will ignore any revisions committed by users in this list when determining if a build needs to be triggered. This can be used to exclude commits done by the build itself from triggering another build, assuming the build server commits the change with a distinct SCM user.
Each exclusion uses literal pattern matching, and must be separated by a new line.
auto_build_user
The example above illustrates that if only revisions by «auto_build_user» have been committed to the SCM a build will not occur.
Type:String
excludedRevprop
-
If set, and Jenkins is set to poll for changes, Jenkins will ignore any revisions
that are marked with the given revision property (revprop) when determining if
a build needs to be triggered. This can be used to exclude commits done by the
build itself from triggering another build, assuming the build server commits
the change with the correct revprop.This type of exclusion only works with Subversion 1.5 servers and newer.
More information on revision properties can be found
here.Type:String
excludedCommitMessages
-
If set, and Jenkins is set to poll for changes, Jenkins will ignore any revisions
with commit messages containing any of the given regular expressions when
determining if a build needs to be triggered.Type:String
includedRegions
-
If set, and Jenkins is set to poll for changes, Jenkins will ignore any files and/or
folders that are not in this list when determining if a build needs to be triggered.Each inclusion uses regular expression pattern matching, and must be separated by a new line.
This is useful when you need to check out an entire resource for building, but only want to do
the build when a subset has changed./trunk/myapp/c/library1/.* /trunk/myapp/c/library2/.*
If /trunk/myapp is checked out, the build will only occur when there are changes to
either the c/library1 and c/library2 subtrees.If there are also excluded regions specified, then a file is not ignored when it is in
the included list and not in the excluded list.More information on regular expressions can be found
here.Type:String
ignoreDirPropChanges
-
If set, Jenkins ignores svn-property only changes of directories.
These changes are ignored when determining whether a build should be triggered and are removed from a
build’s changeset.
Main usage of this property is to ignore svn:mergeinfo changes (which would otherwise e.g. lead to a complete rebuild
of a maven project, in spite of incremental build option).Type:boolean
filterChangelog
-
If set Jenkins will apply the same inclusion and exclusion patterns for displaying changelog entries as it does for polling for changes.
If this is disabled, changes which are excluded for polling are still displayed in the changelog.Type:boolean
additionalCredentials
-
If there are additional credentials required in order to obtain a complete checkout of the source, they can be
provided here.The realm is how the repository self-identifies to a client. It usually has the following format:
<proto://host:port> Realm Name
proto
is the protocol, e.g.http
orsvn
.host
is the host how it’s accessed by Jenkins, e.g. as IP address192.168.1.100
, host namesvnserver
, or host name and domainsvn.example.org
.port
is the port, even if not explicitly specified. By default, this is80
for HTTP,443
for HTTPS, 3690 for thesvn
protocol.Realm Name
is how the repository self-identifies. Common options includeVisualSVN Server
,Subversion Authentication
or the UUID of the repository.
To find out the realm, you could do any of the following:
- If you access the repository via HTTP or HTTPS: Open the repo in a web browser without saved credentials. It will use the
Realm Name
(see above) in the authentication dialog. - Use the command line
svn
program.- If you don’t have stored the credentials, run e.g.
svn info https://svnserver/repo
and it will tell you the realm when asking you to enter a password, e.g.: Authentication realm: <svn://svnserver:3690> VisualSVN Server. - If you have already stored the credentials to access the repository, look for the realm name in one of the files in
~/.subversion/auth/svn/simple
; it will be two lines below the linesvn:realmstring
.
- If you don’t have stored the credentials, run e.g.
- When accessing a repository via the
svn+ssh
protocol, the realm has the formatusername@svn+ssh://host:port
– note that the username is before thesvn+ssh://
(unlike the URL used for normal SVN operations), and that there are no angle brackets and no realm name. For this protocol the default port is 22.
Make sure to enter the realm exactly as shown, starting with a
<
(except for repositories accessed viasvn+ssh
– see above).Array/List:
- Nested object
-
realm
-
This is the realm that the SvnKit library associates with a specific checkout. For most Subversion servers this
will typically be of the format<scheme://hostname(:port)> name
,
while for servers accessed viasvn+ssh
it is of the format(username@)svn+ssh://hostname(:port)
.Type:String
credentialsId
-
Select the credential from the list of relevant credentials in order to use that credential for checking out
the source code.Type:String
quietOperation
-
Mimics subversion command line
--quiet
parameter for check out / update operations to help keep the output shorter. Prints nothing, or only summary information.Type:boolean
id
(optional)-
Type:String
$class: 'SubversionSCMSource'
-
remoteBase
-
Type:String
id
(optional)-
Type:String
browser
(optional)-
- Nested choice of objects
-
$class: 'Assembla'
-
spaceName
-
Type:String
$class: 'CollabNetSVN'
-
url
-
The repository browser URL for the root of the project.
For example, a Java.net project calledmyproject
would use
https://myproject.dev.java.net/source/browse/myproject
.
Type:String
$class: 'FishEyeSVN'
-
url
-
Specify the URL of this module in FishEye.
(such ashttp://fisheye6.cenqua.com/browse/ant/
)
Type:String
rootModule
-
Specify the root Subversion module that this FishEye monitors.
For example, forhttp://fisheye6.cenqua.com/browse/ant/
,
this field would beant
because it displays the directory «/ant»
of the ASF repo. If FishEye is configured to display the whole SVN repository,
leave this field empty.Type:String
svnPhabricator
-
url
-
Type:String
repo
-
Type:String
$class: 'SVNWeb'
-
url
-
Type:String
$class: 'ScmManagerSvnRepositoryBrowser'
-
repoUrl
-
Specify the root URL serving this repository (such as https://scm-manager.org/scm/repo/namespace/name).
Type:String
$class: 'Sventon'
-
url
-
Specify the URL of the Sventon repository browser.
For example, if you normally browse fromhttp://somehost.com/svn/repobrowser.svn?name=local
,
this field would behttp://somehost.com/svn/
Type:String
repositoryInstance
-
Specify the Sventon repository instance name that references this subversion repository.
For example, if you normally browse fromhttp://somehost.com/svn/repobrowser.svn?name=local
,
this field would belocal
Type:String
$class: 'Sventon2'
-
url
-
Specify the URL of the Sventon repository browser.
For example, if you normally browse fromhttp://somehost.com/svn/repobrowser.svn?name=local
,
this field would behttp://somehost.com/svn/
Type:String
repositoryInstance
-
Specify the Sventon repository instance name that references this subversion repository.
For example, if you normally browse fromhttp://somehost.com/svn/repobrowser.svn?name=local
,
this field would belocal
Type:String
$class: 'ViewSVN'
-
url
-
Specify the root URL of ViewSVN for this repository
(such as this).Type:String
$class: 'VisualSVN'
-
url
-
Type:String
$class: 'WebSVN'
-
url
-
Type:String
credentialsId
(optional)-
Type:String
excludes
(optional)-
Type:String
includes
(optional)-
Type:String
workspaceUpdater
(optional)-
- Nested choice of objects
-
$class: 'CheckoutUpdater'
-
$class: 'NoopUpdater'
-
$class: 'UpdateUpdater'
-
$class: 'UpdateWithCleanUpdater'
-
$class: 'UpdateWithRevertUpdater'
-
targets
-
The branch names to try and resolve from the source, in order of preference.
ignoreErrors
(optional)-
When selected, the step will return
null
in the event that no matching branch can be resolved.Type:boolean
retry
: Retry the body up to N times
Retry the block (up to N times) if any exception happens during its body execution.
If an exception happens on the final attempt then it will lead to aborting the build (unless it is caught and processed somehow).
User aborts of the build are not caught.
count
-
Type:int
conditions
(optional)-
Conditions under which the block should be retried.
If none match, the block will fail.
If there are no specified conditions,
the block will always be retried except in case of user aborts.Array/List:
- Nested choice of objects
-
agent
-
Detects that a
node
block, or certain steps inside it such assh
,
failed for reasons which are likely due to infrastructure rather than the behavior of the build.
If the connection to an agent is broken or the agent is removed from the list of executors while in use
(typically in response to the disappearance of underlying cloud resources),
this condition will allowretry
to allocate a fresh agent and try the whole block again. kubernetesAgent
-
Similar to
agent()
(Agent errors) but tailored to agents provisioned from a Kubernetes cloud.
Unlike the generic agent error condition,
this will ignore certain pod termination reasons which are likely to be under the control of the Pipeline author (e.g.,OOMKilled
)
while still allowingretry
to recover after common cases of pod deletion.handleNonKubernetes
(optional)-
Behave like the generic
agent()
(Agent errors) when applied to a non-Kubernetes agent.
Useful in cases where it is hard to predict in a job definition whether a Kubernetes or other sort of agent will be used.Type:boolean
nonresumable
-
The Jenkins controller was restarted while the build was running a step which cannot be resumed.
Some steps likesh
orinput
are written to survive a Jenkins restart
and simply pick up where they left off when the build resumes.
Others likecheckout
orjunit
normally complete promptly but cannot tolerate a restart.
In case one of these steps happened to be in progress when Jenkins shut down,
the resumed build will throw an error;
using this condition withretry
allows the step (or the whole enclosingnode
block) to be rerun.
scanForIssues
: Scan files or the console log for warnings or issuesblameDisabled
(optional)-
If this option is unchecked, then the plugin automatically shows what revision and author (name and email)
last modified the lines of the affected files that contain issues. If this operation slows down your build or
you don’t want to publish sensitive user data, you can use this option to deactivate this feature.Type:boolean
filters
(optional)-
The created report of issues can be filtered afterwards. You can specify an arbitrary number of include or exclude
filters. Currently, there is support for filtering issues by module name, package or namespace name, file name,
category or type. Include filters will be combined withor
, exclude filters withand
.
If no filter is defined, then all issues will be published. Filters with empty regular expression will be ignored.Array/List:
- Nested choice of objects
-
excludeCategory
-
pattern
-
Type:String
excludeFile
-
pattern
-
Type:String
excludeMessage
-
pattern
-
Type:String
excludeModule
-
pattern
-
Type:String
excludePackage
-
pattern
-
Type:String
excludeType
-
pattern
-
Type:String
includeCategory
-
pattern
-
Type:String
includeFile
-
pattern
-
Type:String
includeMessage
-
pattern
-
Type:String
includeModule
-
pattern
-
Type:String
includePackage
-
pattern
-
Type:String
includeType
-
pattern
-
Type:String
forensicsDisabled
(optional)-
Type:boolean
scm
(optional)-
Type:String
sourceCodeEncoding
(optional)-
In order to correctly show all your affected source code files in the detail views,
the plugin must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
sourceDirectories
(optional)-
Some plugins copy source code files to Jenkins’ build folder so that these files can be rendered in the user
interface together with build results (coverage, warnings, etc.). If these files are not part of the workspace
of a build then Jenkins will not show them by default: otherwise sensitive files could be shown by accident.
You can provide a list of additional source code directories that are allowed to be shown in Jenkins user interface
here. Note, that such a directory must be an absolute path on the agent that executes the build.Array/List:
- Nested object
-
path
-
This plugin copies source code files to Jenkins’ build folder so that these files can be rendered in the user
interface together with the plugin results. If these files are referenced with relative paths then they cannot
be found by the plugin. In these cases you need to specify one or more relative paths within the workspace where
the plugin can locate them. Alternatively, you can also specify absolute paths if the source code files are stored
outside the workspace (in a directory on the agent). All absolute paths must be additionally approved by an
administrator in Jenkins’ global configuration page.Type:String
sourceDirectory
(optional)-
Type:String
tool
(optional)-
For each static analysis tool a dedicated parser or scanner will be used to read report files or produce issues in
any other way. If your tool is not yet supported you can define a new Groovy based parser in Jenkins
system configuration. You can reference this new parser afterwards when you select the tool ‘Groovy Parser’.
Additionally, you provide a new parser within a new small plug-in. If the parser is useful for other teams
as well please share it and provide pull requests for the
Warnings Next Generation Plug-in and
the Analysis Parsers Library.- Nested choice of objects
-
acuCobol
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
ajc
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
androidLintParser
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
ansibleLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
aquaScanner
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
armCc
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
axivionSuite
-
basedir
(optional)-
Type:String
credentialsId
(optional)-
Type:String
id
(optional)-
Type:String
name
(optional)-
Type:String
namedFilter
(optional)-
Type:String
projectUrl
(optional)-
Type:String
bluepearl
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
brakeman
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
buckminster
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
cadence
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
cargo
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
ccm
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
checkStyle
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
clair
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
clang
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
clangAnalyzer
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
clangTidy
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
cmake
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
codeAnalysis
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
codeChecker
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
codeNarc
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
coolflux
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
cpd
-
highThreshold
(optional)-
Type:int
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
normalThreshold
(optional)-
Type:int
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
cppCheck
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
cppLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
cssLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
dscanner
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
dart
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
detekt
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
diabC
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
docFx
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
dockerLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
doxygen
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
drMemory
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
dupFinder
-
highThreshold
(optional)-
Type:int
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
normalThreshold
(optional)-
Type:int
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
eclipse
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
erlc
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
errorProne
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
esLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
findBugs
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
useRankAsPriority
(optional)-
Type:boolean
flake8
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
flawfinder
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
flexSdk
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
fxcop
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
gcc3
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
gcc
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
gendarme
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
ghsMulti
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
gnat
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
gnuFortran
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
goLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
goVet
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
groovyScript
-
parserId
-
Type:String
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
hadoLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
iar
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
iarCstat
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
ibLinter
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
ideaInspection
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
infer
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
intel
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
invalids
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
junitParser
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
java
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
javaDoc
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
jcReport
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
jsHint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
jsLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
klocWork
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
kotlin
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
ktLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
mavenConsole
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
modelsim
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
metrowerksCodeWarrior
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
msBuild
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
myPy
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
nagFortran
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
oelintAdv
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
otDockerLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
taskScanner
-
excludePattern
(optional)-
Type:String
highTags
(optional)-
Type:String
id
(optional)-
Type:String
ignoreCase
(optional)-
Type:boolean
includePattern
(optional)-
You can define multiple filesets using comma as a separator, e.g. ‘**/*.c, **/*.h’.
Basedir of the fileset is the workspace root.Type:String
isRegularExpression
(optional)-
Note that the regular expression must contain two capturing groups:
the first one is interpreted as tag name, the second one as message.
An example of such a regular expression would be^.*(TODO(?:[0-9]*))(.*)$
.Type:boolean
lowTags
(optional)-
Type:String
name
(optional)-
Type:String
normalTags
(optional)-
Type:String
owaspDependencyCheck
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
PVSStudio
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
pcLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
pep8
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
perforce
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
perlCritic
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
php
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
phpCodeSniffer
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
phpStan
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
pit
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
pmdParser
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
prefast
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
protoLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
puppetLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
pyDocStyle
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
pyLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
qacSourceCodeAnalyser
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
qtTranslation
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
analysisParser
-
analysisModelId
-
Type:String
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
resharperInspectCode
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
revApi
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
rfLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
robocopy
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
ruboCop
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
sarif
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
scala
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
simian
-
highThreshold
(optional)-
Type:int
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
normalThreshold
(optional)-
Type:int
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
sonarQube
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
sphinxBuild
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
spotBugs
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
useRankAsPriority
(optional)-
Type:boolean
styleCop
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
styleLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
sunC
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
swiftLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
tagList
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
taskingVx
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
tiCss
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
tnsdl
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
trivy
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
tsLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
veracodePipelineScanner
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
issues
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
xlc
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
xmlLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
yamlLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
yuiCompressor
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
zptLint
-
id
(optional)-
The results of the selected tool are published using a unique ID (i.e. URL) which must not be already used by
another tool in this job. This ID is used as link to the results, so choose a short and meaningful name.
Allowed elements are characters, digits, dashes and underscores (more precisely,
the ID must match the regular expression `p{Alnum}[p{Alnum}-_]*`).
If you leave the ID field empty, then the built-in default ID of the registered tool will be used.Type:String
name
(optional)-
You can override the display name of the tool. This name is used in details views, trend captions, and hyper
links. If you leave the name field empty, then the built-in default name of the registered tool will be used.Type:String
pattern
(optional)-
Type:String
reportEncoding
(optional)-
In order to read all characters of your reports correctly, the plugin
must open these files with the correct character encoding (UTF-8, ISO-8859-1, etc.).
If you leave this field empty then the default encoding of the platform will be used. This might work but
is not recommended.Type:String
skipSymbolicLinks
(optional)-
Skipping symbolic links is useful when the scanned directory contains links that create a recursive structure.
Note that this option may not work on Windows, since symbolic links are not fully supported here.Type:boolean
script
: Run arbitrary Pipeline scriptsh
: Shell Scriptscript
-
Runs a Bourne shell script, typically on a Unix node. Multiple lines are accepted.
An interpreter selector may be used, for example:
#!/usr/bin/perl
Otherwise the system default shell will be run, using the
-xe
flags
(you can specifyset +e
and/orset +x
to disable those).Type:String
encoding
(optional)-
Encoding of process output.
In the case ofreturnStdout
, applies to the return value of this step;
otherwise, or always for standard error, controls how text is copied to the build log.
If unspecified, uses the system default encoding of the node on which the step is run.
If there is any expectation that process output might include non-ASCII characters,
it is best to specify the encoding explicitly.
For example, if you have specific knowledge that a given process is going to be producing UTF-8
yet will be running on a node with a different system encoding
(typically Windows, since every Linux distribution has defaulted to UTF-8 for a long time),
you can ensure correct output by specifying:encoding: 'UTF-8'
Type:String
label
(optional)-
Label to be displayed in the pipeline step view and blue ocean details for the step instead of the step type.
So the view is more meaningful and domain specific instead of technical.Type:String
returnStatus
(optional)-
Normally, a script which exits with a nonzero status code will cause the step to fail with an exception.
If this option is checked, the return value of the step will instead be the status code.
You may then compare it to zero, for example.Type:boolean
returnStdout
(optional)-
If checked, standard output from the task is returned as the step value as a
String
,
rather than being printed to the build log.
(Standard error, if any, will still be printed to the log.)
You will often want to call.trim()
on the result to strip off a trailing newline.Type:boolean
sha1
: Compute the SHA1 of a given fileComputes the SHA1 of a given file.
file
-
The path to the file to hash.
Type:String
sha256
: Compute the SHA256 of a given fileComputes the SHA256 of a given file.
file
-
The path to the file to hash.
Type:String
sleep
: Sleep
Simply pauses the Pipeline build until the given amount of time has expired.
Equivalent to (on Unix) sh 'sleep …'
.
May be used to pause one branch of parallel
while another proceeds.
time
-
The length of time for which the step will sleep.
Type:int
unit
(optional)-
The unit for the time parameter. Defaults to ‘SECONDS’ if not specified.
Values:
NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS
snykSecurity
: Invoke Snyk Security taskadditionalArguments
(optional)-
Type:String
failOnError
(optional)-
Type:boolean
failOnIssues
(optional)-
Type:boolean
monitorProjectOnBuild
(optional)-
Type:boolean
organisation
(optional)-
Type:String
projectName
(optional)-
Type:String
severity
(optional)-
Type:String
snykInstallation
(optional)-
Type:String
snykTokenId
(optional)-
Type:String
targetFile
(optional)-
Type:String
stage
: StageCreates a labeled block.
An older, deprecated mode of this step did not take a block argument, and accepted a concurrency
parameter.
name
-
Type:String
concurrency
(optional)-
Type:int
stash
: Stash some files to be used later in the build
Saves a set of files for later use on any node/workspace in the same Pipeline run.
By default, stashed files are discarded at the end of a pipeline run.
Other plugins may change this behavior to preserve stashes for longer.
For example, Declarative Pipeline includes a preserveStashes()
option
to allow stashes from a run to be retained and used if that run is restarted.
Stashes from one Pipeline run are not available in other runs, other Pipelines, or other jobs.
If you want to persist artifacts for use outside of a single run, consider using
archiveArtifacts
instead.
Note that the stash
and unstash
steps are designed for use with small files.
For large data transfers, use the External Workspace Manager plugin,
or use an external repository manager such as Nexus or Artifactory.
This is because stashed files are archived in a compressed TAR, and with large files this demands considerable on-master
resources, particularly CPU time.
There’s not a hard stash size limit, but between 5-100 MB you should probably consider alternatives.
name
-
Name of a stash.
Should be a simple identifier akin to a job name.Type:String
allowEmpty
(optional)-
Create stash even if no files are included. If
false
(default), an error is raised when the stash does not contain files.Type:boolean
excludes
(optional)-
Optional set of Ant-style exclude patterns.
Use a comma separated list to add more than one expression.
If blank, no files will be excluded.Type:String
includes
(optional)-
Optional set of Ant-style include patterns.
Use a comma separated list to add more than one expression.
If blank, treated like**
: all files.
The current working directory is the base directory for the saved files,
which will later be restored in the same relative locations,
so if you want to use a subdirectory wrap this indir
.Type:String
useDefaultExcludes
(optional)-
If selected, use the default excludes from Ant — see
here for the list. Defaults to true.Type:boolean
step
: General Build Step
This is a special step that allows to call builders or post-build actions (as in freestyle or similar projects), in general «build steps».
Just select the build step to call from the dropdown list and configure it as needed.
Note that only Pipeline-compatible steps will be shown in the list.
delegate
-
- Nested choice of objects
-
archiveArtifacts
-
Archives the build artifacts (for example, distribution zip files or jar files)
so that they can be downloaded later.
Archived files will be accessible from the Jenkins webpage.
Normally, Jenkins keeps artifacts for a build as long as a build log itself is kept,
but if you don’t need old artifacts and would rather save disk space, you can do so.Note that the Maven job type automatically archives any produced Maven artifacts.
Any artifacts configured here will be archived on top of that.
Automatic artifact archiving can be disabled under the advanced Maven options.The Pipeline Snippet Generator generates this example
when all arguments are set to true (some arguments by default are true):archiveArtifacts artifacts: '**/*.txt', allowEmptyArchive: true, fingerprint: true, onlyIfSuccessful: true
artifacts
-
You can use wildcards like ‘module/dist/**/*.zip’.
See
the includes attribute of Ant fileset for the exact format
— except that","
(comma) is the only supported separator.
The base directory is the workspace.
You can only archive files that are located in your workspace.Here are some examples of usage for pipeline:
- How to archive multiple artifacts from a specific folder:
archiveArtifacts artifacts: 'target/*.jar'
- How to archive multiple artifacts with different patterns:
archiveArtifacts artifacts: 'target/*.jar, target/*.war'
-
How to archive multiple nested artifacts:
archiveArtifacts artifacts: '**/*.jar'
Type:String
- How to archive multiple artifacts from a specific folder:
allowEmptyArchive
(optional)-
Normally, a build fails if archiving returns zero artifacts.
This option allows the archiving process to return nothing without failing the build.
Instead, the build will simply throw a warning.Type:boolean
caseSensitive
(optional)-
Artifact archiver uses Ant
org.apache.tools.ant.DirectoryScanner
which by default is case sensitive.
For instance, if the job produces *.hpi files, pattern «**/*.HPI» will fail to find them.This option can be used to disable case sensitivity. When it’s unchecked, pattern «**/*.HPI» will match any *.hpi files, or pattern «**/cAsEsEnSiTiVe.jar» will match a file called caseSensitive.jar.
Type:boolean
defaultExcludes
(optional)-
Type:boolean
excludes
(optional)-
Optionally specify the ‘excludes’ pattern, such as «foo/bar/**/*». Use «,» to set a list of patterns.
A file that matches this mask will not be archived even if it matches the
mask specified in ‘files to archive’ section.Type:String
fingerprint
(optional)-
Type:boolean
followSymlinks
(optional)-
By disabling this option all symbolic links found in the workspace will be ignored.
Type:boolean
onlyIfSuccessful
(optional)-
Type:boolean
associateTag
-
nexusInstanceId
-
Type:String
tagName
-
The tag which will be applied to components matching the specified search criteria
Type:String
search
-
The search criteria used to locate components on the target Nexus Repository Manager server.
For more details, please seeSearch API
Array/List:
- Nested object
-
key
-
Type:String
value
-
Type:String
googleStorageUpload
-
credentialsId
-
Type:String
bucket
-
Type:String
pattern
-
Type:String
pathPrefix
(optional)-
Type:String
sharedPublicly
(optional)-
Type:boolean
showInline
(optional)-
Type:boolean
createTag
-
nexusInstanceId
-
Type:String
tagName
-
Tag name is required and must be unique. Name can only contain letters, numbers, underscores, hyphens and dots and
cannot start with an underscore or dot. The name cannot exceed 256 charactersType:String
tagAttributesJson
(optional)-
Optional metadata for the tag in JSON format. These attributes will be merged with those contained in the
attributes file if both are provided. Attributes in this field will override those present in the fileType:String
tagAttributesPath
(optional)-
The file path (environment-aware) to the optional metadata for the tag, using the workspace as the base path
Type:String
deleteComponents
-
nexusInstanceId
-
Type:String
tagName
-
Components associated with this tag will be deleted
Type:String
dependencyCheckPublisher
-
failedNewCritical
(optional)-
Type:int
failedNewHigh
(optional)-
Type:int
failedNewLow
(optional)-
Type:int
failedNewMedium
(optional)-
Type:int
failedTotalCritical
(optional)-
Type:int
failedTotalHigh
(optional)-
Type:int
failedTotalLow
(optional)-
Type:int
failedTotalMedium
(optional)-
Type:int
newThresholdAnalysisExploitable
(optional)-
Type:boolean
pattern
(optional)-
Type:String
totalThresholdAnalysisExploitable
(optional)-
Type:boolean
unstableNewCritical
(optional)-
Type:int
unstableNewHigh
(optional)-
Type:int
unstableNewLow
(optional)-
Type:int
unstableNewMedium
(optional)-
Type:int
unstableTotalCritical
(optional)-
Type:int
unstableTotalHigh
(optional)-
Type:int
unstableTotalLow
(optional)-
Type:int
unstableTotalMedium
(optional)-
Type:int
dependencyCheck
-
additionalArguments
(optional)-
Type:String
odcInstallation
(optional)-
Type:String
skipOnScmChange
(optional)-
Type:boolean
skipOnUpstreamChange
(optional)-
Type:boolean
dependencyTrackPublisher
-
artifact
-
Specifies the artifact to upload. Dependency-Track supports uploading of CycloneDX bill-of-materials (BOM) formats.
See Best Practices
for additional information.The value can contain environment variables in the form of
${VARIABLE_NAME}
which are resolved.Type:String
synchronous
-
Synchronous publishing mode uploads a BOM to Dependency-Track and waits for Dependency-Track to process
and return results. The results returned are identical to the auditable findings but exclude findings that
have previously been suppressed. Analysis decisions and vulnerability details are included in the response.This feature provides per-build results that display all finding details as well as interactive charts that
display trending information.Synchronous mode is possible with Dependency-Track v3.3.1 and higher.
The API key provided requires the VIEW_VULNERABILITY permission to use this feature with Dependency-Track v4.4 and newer!
Type:boolean
autoCreateProjects
(optional)-
Enable auto creation of projects when authentication is enabled on Dependency-Track and the API key provided has the PROJECT_CREATION_UPLOAD permission.
Type:boolean
dependencyTrackApiKey
(optional)-
When authentication is enabled on Dependency-Track, a valid API key will be required.
Type:String
dependencyTrackFrontendUrl
(optional)-
The alternative base URL to the Frontend of Dependency-Track v3 or higher. (i.e. http://hostname:port)
Use this if you run backend and frontend on different servers. If omitted, «Dependency-Track Backend URL» will be used instead.
Type:String
dependencyTrackUrl
(optional)-
The base URL to Dependency-Track Backend (i.e. http://hostname:port)
Type:String
failedNewCritical
(optional)-
Type:int
failedNewHigh
(optional)-
Type:int
failedNewLow
(optional)-
Type:int
failedNewMedium
(optional)-
Type:int
failedTotalCritical
(optional)-
Type:int
failedTotalHigh
(optional)-
Type:int
failedTotalLow
(optional)-
Type:int
failedTotalMedium
(optional)-
Type:int
overrideGlobals
(optional)-
Allows to override global settings for «Auto Create Projects», «Dependency-Track URL», «Dependency-Track Frontend URL» and «API key».
Can be ignored in pipelines, just set the properties
dependencyTrackUrl
,dependencyTrackFrontendUrl
,dependencyTrackApiKey
andautoCreateProjects
as needed.Type:boolean
projectId
(optional)-
Specifies the unique Project ID of the project to upload scan results to. The Project ID is a UUID
with the following format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxIf the list of projects are not displayed (such as an HTTP 403 response), ensure the API key
specified in the global configuration has VIEW_PORTFOLIO permission in addition to BOM_UPLOAD
and/or SCAN_UPLOAD. Permissions are defined in Dependency-Track.Type:String
projectName
(optional)-
Specifies the name of the project for automatic creation of project during the upload process.
This is an alternative to specifying the unique UUID. It must be used together with a project version.
Ensure the API key specified in the global configuration has PROJECT_CREATION_UPLOAD permission and that you have enabled
Auto Create Projects
.The value can contain environment variables in the form of
${VARIABLE_NAME}
which are resolved.Type:String
projectProperties
(optional)-
Set additional properties for the given project.
The API key provided requires the PORTFOLIO_MANAGEMENT permission to use this feature!
- Nested object
-
description
(optional)-
The description to be set for the project.
Type:String
group
(optional)-
Specifies the value of «Namespace / Group / Vendor» to be set for the project.
Type:String
swidTagId
(optional)-
Specifies the SWID Tag ID to be set for the project.
Type:String
tags
(optional)-
Specifies the list of tags to be set for the project. Separate multiple tags with spaces or put each tag on a separate line.
All tags are automatically lowercased!
- Nested choice of objects
- (not enumerable)
projectVersion
(optional)-
Specifies the version of the project for automatic creation of project during the upload process.
This is an alternative to specifying the unique UUID. It must be used together with a project name.
Ensure the API key specified in the global configuration has PROJECT_CREATION_UPLOAD permission and that you have enabled
Auto Create Projects
.The value can contain environment variables in the form of
${VARIABLE_NAME}
which are resolved.Type:String
unstableNewCritical
(optional)-
Type:int
unstableNewHigh
(optional)-
Type:int
unstableNewLow
(optional)-
Type:int
unstableNewMedium
(optional)-
Type:int
unstableTotalCritical
(optional)-
Type:int
unstableTotalHigh
(optional)-
Type:int
unstableTotalLow
(optional)-
Type:int
unstableTotalMedium
(optional)-
Type:int
googleStorageDownload
-
credentialsId
-
Type:String
bucketUri
-
This specifies the cloud object to download from Cloud Storage.
You can view these by visiting the «Cloud Storage» section of the Cloud Console for your project.
A single asterisk can be specified in the object path (not the bucket name), past the last «/». The asterisk behaves consistently with gsutil. For example,gs://my-bucket-name/pre/a_*.txt
would match the objects in cloud bucketmy-bucket-name
that are namedpre/a_2.txt
orpre/a_abc23-4.txt
, but notpre/a_2/log.txt
.Type:String
localDirectory
-
The local directory that will store the downloaded files. The path specified is considered relative to the build’s workspace. Example value:
- path/to/dir
Type:String
pathPrefix
(optional)-
The specified prefix will be stripped from all downloaded filenames. Filenames that do not start with this prefix will not be modified. If this prefix does not have a trailing slash, it will be added automatically.
Type:String
jobDsl
-
additionalClasspath
(optional)-
Newline separated list of additional classpath entries for the Job DSL scripts. All entries must be relative to the
workspace root, e.g. build/classes/main. Supports Ant-style patterns like lib/*.jar.Type:String
additionalParameters
(optional)-
java.lang.UnsupportedOperationException: do not know how to categorize attributes of type java.util.Map<java.lang.String, java.lang.Object>
failOnMissingPlugin
(optional)-
If checked, the build will be marked as failed if a plugin must be installed or updated to support all features used
in the DSL scripts. If not checked, the build will be marked as unstable instead.Type:boolean
failOnSeedCollision
(optional)-
Fail build if generated item(s) have the same name as existing items already managed by another seed job. By default, this plugin will always regenerate all jobs and views, thus updating previously generated jobs and views even if managed by another seed job. Check this box if you wish to fail the job if a generated item name collision is detected.
Type:boolean
ignoreExisting
(optional)-
Ignore previously generated jobs and views. By default, this plugin will always regenerate all jobs and views, thus updating previously generated jobs and views. Check this box if you wish to leave previous jobs and views as is.
Type:boolean
ignoreMissingFiles
(optional)-
Ignore missing DSL scripts. If not checked, the build step will fail if a configured script is missing or if
a wildcard does not match any files.Type:boolean
lookupStrategy
(optional)-
Determines how relative job names in DSL scripts are interpreted. You will only see a difference when
the seed job is located in a
folder.-
Jenkins Root
When this option is selected relative job names are always interpreted relative to the Jenkins root. -
Seed Job
If you choose this option relative job names in DSL scripts will be
interpreted relative to the folder in which the seed job is located. Suppose you have a seed job which is
located in a folder named seedJobFolder and a DSL script which creates a job named
subfolder2/job. The job that is created by the seed job will be at the location
/seedJobFolder/subfolder2/job.
Values:
JENKINS_ROOT
SEED_JOB
-
Jenkins Root
removedConfigFilesAction
(optional)-
Specifies what to do when previously generated config files are not referenced anymore.
Note: when using multiple Job DSL build steps in a single job, set this to «Delete» only for the last Job
DSL build step. Otherwise config files may be deleted and re-created. See
JENKINS-44142 for details. removedJobAction
(optional)-
Specifies what to do when a previously generated job is not referenced anymore.
Note: when using multiple Job DSL build steps in a single job, set this to «Delete» or «Disable» only for
the last Job DSL build step. Otherwise jobs will be deleted and re-created or disabled and re-enabled and you
may lose the job history of generated jobs. See
JENKINS-44142 for details.Values:
IGNORE
DISABLE
DELETE
removedViewAction
(optional)-
Specifies what to do when a previously generated view is not referenced anymore.
Note: when using multiple Job DSL build steps in a single job, set this to «Delete» only for the last Job
DSL build step. Otherwise views may be deleted and re-created. See
JENKINS-44142 for details. sandbox
(optional)-
If checked, runs the DSL scripts in a sandbox with limited abilities.
You will also need to configure this job to run with the identity of a particular user.
If unchecked, and you are not a Jenkins administrator,
you will need to wait for an administrator to approve the scripts.Type:boolean
scriptText
(optional)-
DSL Script, which is groovy code. Look at documentation for details on the syntax.
Type:String
targets
(optional)-
Newline separated list of DSL scripts, located in the Workspace.
Can use wildcards like ‘jobs/**/*.groovy’. See
the @includes of Ant fileset
for the exact format.Scripts are executed in the same order as specified. The execution order of expanded wildcards is unspecified.
Type:String
unstableOnDeprecation
(optional)-
If checked, marks the build as unstable when using deprecated features. If not checked, a warning will be
printed to the build log only.Type:boolean
useScriptText
(optional)-
Type:boolean
googleStorageBucketLifecycle
-
credentialsId
-
Type:String
bucket
-
Type:String
ttl
-
Type:int
fingerprint
-
Jenkins can record the ‘fingerprint’ of files (most often jar files) to keep track
of where/when those files are produced and used. When you have inter-dependent
projects on Jenkins, this allows you to quickly find out answers to questions like:-
I have
foo.jar
on my HDD but which build number of FOO did it come from? -
My BAR project depends on
foo.jar
from the FOO project. -
-
Which build of
foo.jar
is used in BAR #51? -
Which build of BAR contains my bug fix to
foo.jar
#32?
-
Which build of
To use this feature, all of the involved projects (not just the project
in which a file is produced, but also the projects in which the file
is used) need to use this and record fingerprints.See this document
for more details.targets
-
Type:String
caseSensitive
(optional)-
Fingerprinter uses Ant
org.apache.tools.ant.DirectoryScanner
which by default is case sensitive.
For instance, if the job produces *.hpi files, pattern «**/*.HPI» will fail to find them.This option can be used to disable case sensitivity. When it’s unchecked, pattern «**/*.HPI» will match any *.hpi files, or pattern «**/cAsEsEnSiTiVe.jar» will match a file called caseSensitive.jar.
Type:boolean
defaultExcludes
(optional)-
Type:boolean
excludes
(optional)-
Optionally specify the ‘excludes’ pattern, such as «foo/bar/**/*». Use «,» to set a list of patterns.
A file that matches this mask will not be fingerprinted even if it matches the
mask specified in ‘files to fingerprint’ section.Type:String
-
I have
$class: 'GitHubCommitNotifier'
-
This notifier will set GH commit status.
This step is DEPRECATED and will be migrated to new step in one of the next major plugin releases.
Please refer to new universal step.resultOnFailure
-
Type:String
statusMessage
(optional)-
- Nested object
-
content
-
Message content that will be expanded using core variable expansion i.e.
${WORKSPACE}
and Token Macro Plugin tokens.
Type:String
$class: 'GitHubCommitStatusSetter'
-
Using GitHub status api sets status of the commit.
commitShaSource
(optional)-
- Nested choice of objects
-
$class: 'BuildDataRevisionShaSource'
-
Uses data-action (located at
${build.url}/git/
) to determine actual SHA.
$class: 'ManuallyEnteredShaSource'
-
Allows to define commit SHA manually.
sha
-
Allows env vars and token macro.
Type:String
contextSource
(optional)-
- Nested choice of objects
-
$class: 'DefaultCommitContextSource'
-
Uses display name property defined in «GitHub project property» with fallback to job name.
$class: 'ManuallyEnteredCommitContextSource'
-
You can define context name manually.
context
-
Allows env vars and token macros.
Type:String
errorHandlers
(optional)-
Array/List:
- Nested choice of objects
-
$class: 'ChangingBuildStatusErrorHandler'
-
result
-
Type:String
$class: 'ShallowAnyErrorHandler'
-
reposSource
(optional)-
- Nested choice of objects
-
$class: 'AnyDefinedRepositorySource'
-
Any repository provided by the programmatic contributors list.
$class: 'ManuallyEnteredRepositorySource'
-
A manually entered repository URL.
url
-
Type:String
statusBackrefSource
(optional)-
- Nested choice of objects
-
$class: 'BuildRefBackrefSource'
-
Points commit status backref back to the producing build page.
$class: 'ManuallyEnteredBackrefSource'
-
A manually entered backref URL.
backref
-
A backref URL. Allows env vars and token macro.
Type:String
statusResultSource
(optional)-
- Nested choice of objects
-
$class: 'ConditionalStatusResultSource'
-
You can define in which cases you want to publish exact state and message for the commit. You can define multiple cases.
First match (starting from top) wins. If no one matches, PENDING status + warn message will be used.results
-
Array/List:
- Nested choice of objects
-
$class: 'AnyBuildResult'
-
message
(optional)-
Type:String
state
(optional)-
Type:String
$class: 'BetterThanOrEqualBuildResult'
-
message
(optional)-
Allows env vars and token macro.
Type:String
result
(optional)-
Type:String
state
(optional)-
Type:String
$class: 'DefaultStatusResultSource'
-
Writes simple message about build result and duration.
$class: 'GitHubSetCommitStatusBuilder'
-
contextSource
(optional)-
- Nested choice of objects
-
$class: 'DefaultCommitContextSource'
-
Uses display name property defined in «GitHub project property» with fallback to job name.
$class: 'ManuallyEnteredCommitContextSource'
-
You can define context name manually.
context
-
Allows env vars and token macros.
Type:String
statusMessage
(optional)-
- Nested object
-
content
-
Message content that will be expanded using core variable expansion i.e.
${WORKSPACE}
and Token Macro Plugin tokens.
Type:String
$class: 'JUnitResultArchiver'
-
Jenkins understands the JUnit test report XML format (which is also used by TestNG).
When this option is configured, Jenkins can provide useful information about test results,
such as historical test result trends, a web UI for viewing test reports, tracking failures,
and so on.To use this feature, first set up your build to run tests, then
specify the path to JUnit XML files in the
Ant glob syntax,
such as **/build/test-reports/*.xml. Be sure not to include any non-report
files into this pattern. You can specify multiple patterns of files separated by commas.testResults
-
Type:String
allowEmptyResults
(optional)-
If checked, the default behavior of failing a build on missing test result files
or empty test results is changed to not affect the status of the build.
Please note that this setting make it harder to spot misconfigured jobs or
build failures where the test tool does not exit with an error code when
not producing test report files.Type:boolean
checksName
(optional)-
If provided, and publishing checks enabled, the plugin will use this name when publishing results to corresponding
SCM hosting platforms. If not, a default of «Tests» will be used.Type:String
healthScaleFactor
(optional)-
The amplification factor to apply to test failures when computing the test result contribution to the build health
score.
The default factor is1.0
- A factor of
0.0
will disable the test result contribution to build health score. - A factor of
0.1
means that 10% of tests failing will score 99% health - A factor of
0.5
means that 10% of tests failing will score 95% health - A factor of
1.0
means that 10% of tests failing will score 90% health - A factor of
2.0
means that 10% of tests failing will score 80% health - A factor of
2.5
means that 10% of tests failing will score 75% health - A factor of
5.0
means that 10% of tests failing will score 50% health - A factor of
10.0
means that 10% of tests failing will score 0% health
The factor is persisted with the build results, so changes will only be reflected in new builds.
Type:double
- A factor of
keepLongStdio
(optional)-
If checked, any standard output or error from a test suite will be retained
in the test results after the build completes. (This refers only to additional
messages printed to console, not to a failure stack trace.) Such output is
always kept if the test failed, but by default lengthy output from passing
tests is truncated to save space. Check this option if you need to see every
log message from even passing tests, but beware that Jenkins’s memory consumption
can substantially increase as a result, even if you never look at the test results!Type:boolean
skipMarkingBuildUnstable
(optional)-
If this option is unchecked, then the plugin will mark the build as unstable when it finds at least 1 test failure.
If this option is checked, then the build will still be successful even if there are test failures reported.Type:boolean
skipOldReports
(optional)-
Type:boolean
skipPublishingChecks
(optional)-
If this option is unchecked, then the plugin automatically publishes the test results to corresponding SCM hosting platforms.
For example, if you are using this feature for a GitHub organization project, the warnings will be published to
GitHub through the Checks API. If this operation slows down your build, or you don’t want to publish the warnings to
SCM platforms, you can use this option to deactivate this feature.Type:boolean
testDataPublishers
(optional)
javadoc
-
javadocDir
-
Type:String
keepAll
-
If you check this option, Jenkins will retain Javadoc for each successful build.
This allows you to browse Javadoc for older builds, at the expense of additional
disk space requirement.If you leave this option unchecked, Jenkins will only keep the latest Javadoc,
so older Javadoc will be overwritten as new builds succeed.Type:boolean
$class: 'Mailer'
-
If configured, Jenkins will send out an e-mail to the specified recipients
when a certain important event occurs.- Every failed build triggers a new e-mail.
- A successful build after a failed (or unstable) build triggers a new e-mail,
indicating that a crisis is over. - An unstable build after a successful build triggers a new e-mail,
indicating that there’s a regression. - Unless configured, every unstable build triggers a new e-mail,
indicating that regression is still there.
For lazy projects where unstable builds are the norm, Uncheck «Send e-mail for every unstable build».
recipients
-
Type:String
notifyEveryUnstableBuild
-
Type:boolean
sendToIndividuals
-
If this option is checked, the notification e-mail will be sent to individuals who have
committed changes for the broken build (by assuming that those changes broke the build).If e-mail addresses are also specified in the recipient list, then both the individuals
as well as the specified addresses get the notification e-mail. If the recipient list
is empty, then only the individuals will receive e-mails.Type:boolean
moveComponents
-
nexusInstanceId
-
Type:String
destination
-
The repository to which components will be moved
Type:String
search
(optional)-
java.lang.UnsupportedOperationException: do not know how to categorize attributes of type java.util.Map<java.lang.String, java.lang.String>
tagName
(optional)-
Components associated with this tag will be moved to the selected destination repository
Type:String
$class: 'NexusPublisherBuildStep'
-
nexusInstanceId
-
Type:String
nexusRepositoryId
-
The publisher currently supports hosted release Maven 2 repositories. This list is limited to
repositories which meet this requirement.Type:String
packages
-
Array/List:
- Nested choice of objects
-
$class: 'MavenPackage'
-
mavenCoordinate
-
- Nested object
-
groupId
-
Type:String
artifactId
-
Type:String
version
-
Type:String
packaging
-
Type:String
mavenAssetList
-
Array/List:
- Nested object
-
filePath
-
Type:String
classifier
-
Type:String
extension
-
Type:String
tagName
(optional)-
Tag is only available for Nexus Repository Manager 3+
Type:String
mineRepository
-
scm
(optional)-
Type:String
discoverReferenceBuild
-
referenceJob
(optional)-
The reference job is the baseline that is used to determine which of the issues in the current
build are new, outstanding, or fixed. This baseline is also used to determine the number of new issues for the
quality gate evaluation.Type:String
$class: 'SnykStepBuilder'
-
additionalArguments
(optional)-
Additional runtime arguments that will be used to invoke the Snyk CLI.
See the Snyk CLI help page for more details.Use the standalone double-dash
--
to pass arguments to the build tool invoked by the Snyk CLI.
For example:-- -Pprofile -Dkey=value
forMaven
projects.-- --configuration runtime
forGradle
projects.-- -Dkey=value
forSBT
projects.
Type:String
failOnError
(optional)-
Whether the step should fail if Snyk fails to scan the project due to an error. Errors include scenarios like: failing
to download Snyk’s binaries, improper Jenkins setup, bad configuration and server errors.Type:boolean
failOnIssues
(optional)-
The «When issues are found» selection specifies if builds should be failed or continued based on issues found by Snyk.
- if «Fail the build, if severity at or above» is selected, the Jenkins build will fail if
Snyk detects issues of provided level or higher. - if «Let the build continue» is selected, the Jenkins build will continue even if Snyk
detects issues in the project.
The corresponding CLI option for severity parameter: —severity-threshold
Type:boolean
- if «Fail the build, if severity at or above» is selected, the Jenkins build will fail if
monitorProjectOnBuild
(optional)-
Monitor the project on every build by taking a snapshot of its current dependencies on Snyk.io. Selecting this option will keep you notified about newly
disclosed vulnerabilities and remediation options in the project.Type:boolean
organisation
(optional)-
The Snyk organisation in which this project should be tested and monitored. Leave empty to use your default organisation.
The corresponding CLI option for this parameter: —org
Type:String
projectName
(optional)-
A custom name for the Snyk project created for this Jenkins project on every build. Leave empty for the project’s name to be detected in the manifest file.
The corresponding CLI option for this parameter: —project-name
Type:String
severity
(optional)-
Type:String
snykInstallation
(optional)-
Ensures that the selected version of Snyk tools are installed. In addition,
the Snyk tools will be added at the start of thePATH
environment
variable during builds.If no Snyk installations have been defined in the Jenkins system config, then
none of the above steps will take place.Type:String
snykTokenId
(optional)-
This needs to be the ID of an existing «Snyk API Token» credential. The token will be used to authenticate with
Snyk.If you prefer to provide the Snyk API Token another way, such using alternative credential bindings, you’ll need to
provide aSNYK_TOKEN
build environment variable.Type:String
targetFile
(optional)-
The path to the manifest file to be used by Snyk. Leave empty for Snyk to auto-detect the manifest file in the project’s root folder.
The corresponding CLI option for this parameter: —file
Type:String
googleStorageBuildLogUpload
-
credentialsId
-
Type:String
bucket
-
Type:String
logName
-
Type:String
pathPrefix
(optional)-
Type:String
sharedPublicly
(optional)-
Type:boolean
showInline
(optional)-
Type:boolean
svn
: SubversionSVN step. It performs a checkout from the specified repository.
Note that this step is shorthand for the generic SCM step:
checkout([$class: 'SubversionSCM', remote: 'http://sv-server/repository/trunk']]])
url
-
Type:String
changelog
(optional)-
Enable or Disable ‘Include in changelog’:
If ‘Include in changelog’ is enabled for an SCM source, then when a build occurs, the changes from that SCM source will be included in the changelog.
If ‘Include in changelog’ is disabled, then when a build occurs,
the changes from this SCM source will not be included in the changelog.Type:boolean
poll
(optional)-
Enable or Disable ‘Include in polling’
If ‘Include in polling’ is enabled or ‘Include in changelog’ is enabled, then when polling occurs, the job will
be started if changes are detected from this SCM source.If ‘Include in polling’ is disabled and ‘Include in changelog’ is disabled, then when polling occurs, changes
that are detected from this repository will be ignored.Type:boolean
tar
: Create Tar fileCreate a tar/tar.gz file of content in the workspace.
file
(optional)-
The name/path of the tar file to create.
Type:String
archive
(optional)-
If the tar file should be archived as an artifact of the current build.
The file will still be kept in the workspace after archiving.Type:boolean
compress
(optional)-
The created tar file shall be compressed as gz.
Type:boolean
dir
(optional)-
The path of the base directory to create the tar from.
Leave empty to create from the current working directory.Type:String
exclude
(optional)-
Type:String
glob
(optional)-
Ant style pattern
of files to include in the tar.
Leave empty to include all files and directories.Type:String
overwrite
(optional)-
If the tar file should be overwritten in case of already existing a file with the same name.
Type:boolean
tee
: Tee output to filefile
-
Type:String
throttle
: Throttle execution of node blocks within this bodycategories
-
One or more throttle categories in a list.
timeout
: Enforce time limit
Executes the code inside the block with a determined time out limit.
If the time limit is reached, an exception (org.jenkinsci.plugins.workflow.steps.FlowInterruptedException) is thrown, which leads to aborting
the build (unless it is caught and processed somehow).
time
-
The length of time for which this step will wait before cancelling the nested block.
Type:int
activity
(optional)-
Timeout after no activity in logs for this block instead of absolute duration. Defaults to false.
Type:boolean
unit
(optional)-
The unit of the time parameter. Defaults to ‘MINUTES’ if not specified.
Values:
NANOSECONDS
MICROSECONDS
MILLISECONDS
SECONDS
MINUTES
HOURS
DAYS
timestamps
: Timestampstm
: Expand a string containing macrosstringWithMacro
-
Type:String
tool
: Use a tool from a predefined Tool Installation
Binds a tool installation to a variable (the tool home directory is returned).
Only tools already configured in Configure System
are available here. If the original tool installer
has the auto-provision feature, then the tool will be installed as required.
name
-
The name of the tool. The tool name must be pre-configured in Jenkins under Manage Jenkins → Global Tool Configuration.
Type:String
type
(optional)-
Type:String
touch
: Create a file (if not already exist) in the workspace, and set the timestampCreates a file if it does not already exist, and updates the timestamp.
file
-
The path to the file to touch.
Type:String
timestamp
(optional)-
The timestamp to set (number of ms since the epoc), leave empty for current system time.
Type:long
unstable
: Set stage result to unstable
Prints a message to the log and sets the overall build result and the stage
result to UNSTABLE
. The message will also be associated with
the stage result and may be shown in visualizations.
message
-
A message that will be logged to the console. The message will also be
associated with the stage result and may be shown in visualizations.Type:String
unstash
: Restore files previously stashed
Restores a set of files previously stash
ed into the current workspace.
name
-
Name of a previously saved stash.
Type:String
untar
: Extract Tar fileExtract a tar/tar.gz file in the workspace.
file
(optional)-
The name/path of the tar/tar.gz file to extract.
Type:String
dir
(optional)-
The path of the base directory to extract the tar to.
Leave empty to extract in the current working directory.Type:String
glob
(optional)-
Ant style pattern
of files to extract from the tar.
Leave empty to include all files and directories.Type:String
quiet
(optional)-
Suppress the verbose output that logs every single file that is dealt with.
E.g.
untar file: 'example.tgz', quiet: true
Type:boolean
test
(optional)-
Test the integrity of the archive instead of extracting it.
When this parameter is enabled, all other parameters (except for file) will be ignored.
The step will returntrue
orfalse
depending on the result
instead of throwing an exception.Type:boolean
unzip
: Extract Zip fileExtract a zip file in the workspace.
zipFile
-
The name/path of the zip file to extract.
Type:String
charset
(optional)-
Specify which Charset you wish to use eg. UTF-8
Type:String
dir
(optional)-
The path of the base directory to extract the zip to.
Leave empty to extract in the current working directory.Type:String
file
(optional)-
Type:String
glob
(optional)-
Ant style pattern
of files to extract from the zip.
Leave empty to include all files and directories.Type:String
quiet
(optional)-
Suppress the verbose output that logs every single file that is dealt with.
E.g.
unzip zipFile: 'example.zip', quiet: true
Type:boolean
read
(optional)-
Read the content of the files into a Map instead of writing them to the workspace.
The keys of the map will be the path of the files read.
E.g.
def v = unzip zipFile: 'example.zip', glob: '*.txt', read: true
String version = v['version.txt']
Type:boolean
test
(optional)-
Test the integrity of the archive instead of extracting it.
When this parameter is enabled, all other parameters (except for zipFile) will be ignored.
The step will returntrue
orfalse
depending on the result
instead of throwing an exception.Type:boolean
validateDeclarativePipeline
: Validate a file containing a Declarative Pipeline
Checks if the given file (as relative path to current directory) contains a valid Declarative Pipeline.
Returns true | false
.
path
-
Relative (
/
-separated) path to file within a workspace to validate as a Declarative Pipeline.Type:String
verifySha1
: Verify the SHA1 of a given fileVerifies the SHA1 of a given file.
file
-
The path to the file to hash.
Type:String
hash
-
The expected hash.
Type:String
verifySha256
: Verify the SHA256 of a given fileVerifies the SHA256 of a given file.
file
-
The path to the file to hash.
Type:String
hash
-
The expected hash.
Type:String
waitForQualityGate
: Wait for SonarQube analysis to be completed and return quality gate status
This step pauses Pipeline execution and wait for previously submitted SonarQube analysis to be completed and returns
quality gate status. Setting the parameter abortPipeline
to true will abort the pipeline if quality gate status is not green.
Note: This step doesn’t require an executor.
Requirements:
- SonarQube server 6.2+
- Configure a webhook in your SonarQube server pointing to
<your Jenkins instance>/sonarqube-webhook/
. The trailing slash is mandatory! - Use
withSonarQubeEnv
step to run your analysis prior to use this step
Example using declarative pipeline:
pipeline {
agent none
stages {
stage("build & SonarQube analysis") {
agent any
steps {
withSonarQubeEnv('My SonarQube Server') {
sh 'mvn clean package sonar:sonar'
}
}
}
stage("Quality Gate") {
steps {
timeout(time: 1, unit: 'HOURS') {
waitForQualityGate abortPipeline: true
}
}
}
}
}
Example using scripted pipeline:
stage("build & SonarQube analysis") {
node {
withSonarQubeEnv('My SonarQube Server') {
sh 'mvn clean package sonar:sonar'
}
}
}
stage("Quality Gate"){
timeout(time: 1, unit: 'HOURS') {
def qg = waitForQualityGate()
if (qg.status != 'OK') {
error "Pipeline aborted due to quality gate failure: ${qg.status}"
}
}
}
abortPipeline
-
Type:boolean
credentialsId
(optional)-
Type:String
webhookSecretId
(optional)-
Type:String
waitUntil
: Wait for condition
Runs its body repeatedly until it returns true
.
If it returns false
, waits a while and tries again.
(Subsequent failures will slow down the delay between attempts up to a maximum of 15 seconds.)
There is no limit to the number of retries,
but if the body throws an error that is thrown up immediately.
initialRecurrencePeriod
(optional)-
Sets the initial wait period, in milliseconds, between retries. Defaults to 250ms.
Each failure will slow down the delay between attempts up to a maximum of 15 seconds.Type:long
quiet
(optional)-
If true, the step does not log a message each time the condition is checked. Defaults to false.
Type:boolean
warnError
: Catch error and set build and stage result to unstable
Executes its body, and if an exception is thrown, sets the overall build result
and the stage result to UNSTABLE
, prints a specified message and
the thrown exception to the build log, and associates the stage result with the
message so that it can be displayed by visualizations.
Equivalent to catchError(message: message, buildResult: 'UNSTABLE', stageResult: 'UNSTABLE')
.
message
-
A message that will be logged to the console if an error is caught. The
message will also be associated with the stage result and may be shown in
visualizations.Type:String
catchInterruptions
(optional)-
If true, certain types of exceptions that are used to interrupt the flow of
execution for Pipelines will be caught and handled by the step. If false,
those types of exceptions will be caught and immediately rethrown. Examples
of these types of exceptions include those thrown when a build is manually
aborted through the UI and those thrown by thetimeout
step. Defaults to true.Type:boolean
withChecks
: Inject checks properties into its closurename
-
Type:String
withCredentials
: Bind credentials to variables
Allows various kinds of credentials (secrets) to be used in idiosyncratic ways.
(Some steps explicitly ask for credentials of a particular kind,
usually as a credentialsId
parameter,
in which case this step is unnecessary.)
Each binding will define an environment variable active within the scope of the step.
You can then use them directly from any other steps that expect environment variables to be set:
node {
withCredentials([usernameColonPassword(credentialsId: 'mylogin', variable: 'USERPASS')]) {
sh '''
set +x
curl -u "$USERPASS" https://private.server/ > output
'''
}
}
As another example (use Snippet Generator to see all options):
node {
withCredentials([string(credentialsId: 'mytoken', variable: 'TOKEN')]) {
sh '''
set +x
curl -H "Token: $TOKEN" https://some.api/
'''
}
}
Note the use of single quotes to define the script
(implicit parameter to sh
) in Groovy above.
You want the secret to be expanded by the shell as an environment variable.
The following idiom is potentially less secure, as the secret is interpolated by Groovy
and so (for example) typical operating system process listings will accidentally disclose it:
node {
withCredentials([string(credentialsId: 'mytoken', variable: 'TOKEN')]) {
sh /* WRONG! */ """
set +x
curl -H 'Token: $TOKEN' https://some.api/
"""
}
}
At least on Linux, environment variables can be obtained by other processes running in the same account,
so you should not run a job which uses secrets on the same node as a job controlled by untrusted parties.
In any event, you should always prefer expansion as environment variables to inclusion in the command,
since Jenkins visualizations such as Blue Ocean will attempt to detect step parameters containing secrets
and refuse to display them.
The secret(s) will be masked (****
) in case they are printed to the build log.
This prevents you from accidentally disclosing passwords and the like via the log.
(Bourne shell set +x
, or Windows batch @echo off
,
blocks secrets from being displayed in echoed commands;
but build tools in debug mode might dump all environment variables to standard output/error,
or poorly designed network clients might display authentication, etc.)
The masking could of course be trivially circumvented;
anyone permitted to configure a job or define Pipeline steps
is assumed to be trusted to use any credentials in scope however they like.
Beware that certain tools mangle secrets when displaying them.
As one example, Bash (as opposed to Ubuntu’s plainer Dash) does so with text containing '
in echo mode:
$ export PASS=foo"'"bar
$ env|fgrep PASS
PASS=foo'bar
$ sh -xc 'echo $PASS'
+ echo foo'bar
foo'bar
$ bash -xc 'echo $PASS'
+ echo 'foo'''bar'
foo'bar
Mangled secrets can only be detected on a best-effort basis. By default, Jenkins will attempt to mask mangled
secrets as they would appear in output of Bourne shell, Bash, Almquist shell and Windows batch. Without these strategies in place, mangled secrets
would appear in plain text in log files. In the example above, this would result in:
+ echo 'foo'''bar'
****
This particular issue can be more safely prevented by turning off echo with set +x
or avoiding the use
of shell metacharacters in secrets.
For bindings which store a secret file, beware that
node {
dir('subdir') {
withCredentials([file(credentialsId: 'secret', variable: 'FILE')]) {
sh 'use $FILE'
}
}
}
is not safe, as $FILE
might be inside the workspace (in subdir@tmp/secretFiles/
),
and thus visible to anyone able to browse the job’s workspace.
If you need to run steps in a different directory than the usual workspace, you should instead use
node {
withCredentials([file(credentialsId: 'secret', variable: 'FILE')]) {
dir('subdir') {
sh 'use $FILE'
}
}
}
to ensure that the secrets are outside the workspace; or choose a different workspace entirely:
node {
ws {
withCredentials([file(credentialsId: 'secret', variable: 'FILE')]) {
sh 'use $FILE'
}
}
}
Also see the
Limitations of Credentials Masking
blog post for more background.
bindings
-
Array/List:
- Nested choice of objects
-
certificate
-
Sets one variable to the username and one variable to the password given in the credentials.
Warning: if the Jenkins controller or agent node has multiple executors,
any other build running concurrently on the same node will be able to read
the text of the secret, for example on Linux usingps e
.keystoreVariable
-
Name of an environment variable to be set to the temporary keystore location during the build. The contents of this file are not masked.
Type:String
credentialsId
-
Credentials of an appropriate type to be set to the variable.
Type:String
aliasVariable
(optional)-
Name of an environment variable to be set to the keystore alias name of the certificate during the build.
Type:String
passwordVariable
(optional)-
Name of an environment variable to be set to the password during the build.
Type:String
dockerCert
-
variable
-
Name of an environment variable to be set during the build.
Its value will be the absolute path of the directory where the{ca,cert,key}.pem
files will be created.
You probably want to call this variableDOCKER_CERT_PATH
, which will be understood by the docker client binary.Type:String
credentialsId
-
Credentials of an appropriate type to be set to the variable.
Type:String
file
-
Copies the file given in the credentials to a temporary location, then sets the variable to that location.
(The file is deleted when the build completes.)Warning: if the Jenkins controller or agent node has multiple executors,
any other build running concurrently on the same node will be able to read
the contents of this file.variable
-
Name of an environment variable to be set during the build. The contents of this location are not masked.
Type:String
credentialsId
-
Credentials of an appropriate type to be set to the variable.
Type:String
gitUsernamePassword
-
gitToolName
-
Specify the Git tool installation name
Type:String
credentialsId
-
Set the git username / password credential for HTTP and HTTPS protocols.
Shell example
withCredentials([gitUsernamePassword(credentialsId: 'my-credentials-id', gitToolName: 'git-tool')]) { sh 'git fetch --all' }
Batch example
withCredentials([gitUsernamePassword(credentialsId: 'my-credentials-id', gitToolName: 'git-tool')]) { bat 'git submodule update --init --recursive' }
Powershell example
withCredentials([gitUsernamePassword(credentialsId: 'my-credentials-id', gitToolName: 'git-tool')]) { powershell 'git push' }
Type:String
sshUserPrivateKey
-
Copies the SSH key file given in the credentials to a temporary location, then sets a variable to that location.
(The file is deleted when the build completes.) Also optionally sets variables for the SSH key’s username and passphrase.Warning: if the Jenkins controller or agent node has multiple executors,
any other build running concurrently on the same node will be able to read
the contents of this file.keyFileVariable
-
Name of an environment variable to be set to the temporary path of the SSH key file during the build. The contents of this file are not masked.
Type:String
credentialsId
-
Credentials of an appropriate type to be set to the variable.
Type:String
passphraseVariable
(optional)-
Name of an environment variable to be set to the password during the build. (optional)
Type:String
usernameVariable
(optional)-
Name of an environment variable to be set to the username during the build. (optional)
Type:String
string
-
Sets a variable to the text given in the credentials.
Warning: if the Jenkins controller or agent node has multiple executors,
any other build running concurrently on the same node will be able to read
the text of the secret, for example on Linux usingps e
.variable
-
Name of an environment variable to be set during the build. The contents of this location are not masked.
Type:String
credentialsId
-
Credentials of an appropriate type to be set to the variable.
Type:String
usernameColonPassword
-
Sets a variable to the username and password given in the credentials, separated by a colon (
:
).Warning: if the Jenkins controller or agent node has multiple executors,
any other build running concurrently on the same node will be able to read
the text of the secret, for example on Linux usingps e
.variable
-
Name of an environment variable to be set during the build. The contents of this location are not masked.
Type:String
credentialsId
-
Credentials of an appropriate type to be set to the variable.
Type:String
usernamePassword
-
Sets one variable to the username and one variable to the password given in the credentials.
Warning: if the Jenkins controller or agent node has multiple executors,
any other build running concurrently on the same node will be able to read
the text of the secret, for example on Linux usingps e
.usernameVariable
-
Name of an environment variable to be set to the username during the build.
Type:String
passwordVariable
-
Name of an environment variable to be set to the password during the build.
Type:String
credentialsId
-
Credentials of an appropriate type to be set to the variable.
Type:String
zip
-
Unpacks the ZIP file given in the credentials to a temporary directory, then sets the variable to that location.
(The directory is deleted when the build completes.)Warning: if the Jenkins controller or agent node has multiple executors,
any other build running concurrently on the same node will be able to read
the contents of this directory.variable
-
Name of an environment variable to be set during the build. The contents of this location are not masked.
Type:String
credentialsId
-
Credentials of an appropriate type to be set to the variable.
Type:String
withEnv
: Set environment variables
Sets one or more environment variables within a block.
The names of environment variables are case-insensitive but case-preserving, that is, setting `Foo` will change the value of `FOO` if it already exists.
Environment variables are available to any external processes spawned within that scope.
For example:
node { withEnv(['MYTOOL_HOME=/usr/local/mytool']) { sh '$MYTOOL_HOME/bin/start' } }
(Note that here we are using single quotes in Groovy, so the variable expansion is being done by the Bourne shell, not Jenkins.)
See the documentation for the env
singleton for more information on environment variables.
overrides
-
A list of environment variables to set, each in the form
VARIABLE=value
orVARIABLE=
to unset variables otherwise defined.
You may also use the syntaxPATH+WHATEVER=/something
to prepend/something
to$PATH
.
withSonarQubeEnv
: Prepare SonarQube Scanner environmentinstallationName
-
Type:String
credentialsId
(optional)-
Type:String
envOnly
(optional)-
Type:boolean
wrap
: General Build Wrapper
This is a special step that allows to call build wrappers (also called «Environment Configuration» in freestyle or similar projects).
Just select the wrapper to use from the dropdown list and configure it as needed. Everything inside the wrapper block is under its effect.
Note that only Pipeline-compatible wrappers will be shown in the list.
delegate
-
- Nested choice of objects
-
$class: 'AnsiColorBuildWrapper'
-
colorMapName
-
Type:String
configFileProvider
-
managedFiles
-
Array/List:
-
fileId
-
Name of the file.
Type:String
replaceTokens
(optional)-
Decides whether the token should be replaced using macro.
Type:boolean
targetLocation
(optional)-
Name of the file (with optional file relative to workspace directory) where the config file should be copied.
Type:String
variable
(optional)-
Name of the variable which can be used as the reference for further configuration.
Type:String
configFile
-
kubeconfig
-
Configure Kubernetes client (kubectl) so it can be used in the build to run Kubernetes commands
serverUrl
-
URL of the Kubernetes API endpoint. If not set the connection options will be autoconfigured from service account or kube config file.
Type:String
credentialsId
-
Type:String
caCertificate
-
The base64 encoded certificate of the certificate authority (CA). It is used to verify the server certificate.
Leaving this field empty will skip the certificate verification.
Type:String
withSonarQubeEnv
-
installationName
-
Type:String
credentialsId
(optional)-
Type:String
envOnly
(optional)-
Type:boolean
$class: 'TimestamperBuildWrapper'
-
writeCSV
: Write content to a CSV file in the workspace.
Write a CSV file in the current working directory. That for example was previously read by readCSV
.
See CSVPrinter for details.
Fields:
-
records
:
The list of CSVRecord instances to write. -
file
:
Path to a file in the workspace to write to. -
format
:
See CSVFormat for details.
Example:
def records = [['key', 'value'], ['a', 'b']]
writeCSV file: 'output.csv', records: records, format: CSVFormat.EXCEL
file
-
Type:String
records
-
java.lang.UnsupportedOperationException: do not know how to categorize attributes of type java.lang.Iterable<?>
format
(optional)-
org.kohsuke.stapler.NoStaplerConstructorException: There's no @DataBoundConstructor on any constructor of class org.apache.commons.csv.CSVFormat
writeFile
: Write file to workspaceWrite the given content to a named file in the current directory.
file
-
Relative path of a file within the workspace.
Type:String
text
-
The data to write in the file.
Type:String
encoding
(optional)-
The target encoding for the file.
If left blank, the platform default encoding will be used.
If the text is a Base64-encoded string, the decoded binary data can be written
to the file by specifying «Base64» as the encoding.Type:String
writeJSON
: Write JSON to a file in the workspace.
Write JSON to a file in the
current working directory, or to a String.
Fields:
-
json
:
The object to write. Can either be a
JSON
instance or another Map/List implementation. Both are supported. -
file
(optional):
Optional path to a file in the workspace to write to.
If provided, thenreturnText
must befalse
or omitted.
It is required that eitherfile
is provided, orreturnText
istrue
. -
pretty
(optional):
Prettify the output with this number of spaces added to each level of indentation. -
returnText
(optional):
Return the JSON as a string instead of writing it to a file. Defaults tofalse
.
Iftrue
, thenfile
must not be provided.
It is required that eitherfile
is provided, orreturnText
istrue
.
Example:
Writing to a file:
def amap = ['something': 'my datas',
'size': 3,
'isEmpty': false]
writeJSON file: 'data.json', json: amap
def read = readJSON file: 'data.json'
assert read.something == 'my datas'
assert read.size == 3
assert read.isEmpty == false
Writing to a string:
def amap = ['something': 'my datas', 'size': 3, 'isEmpty': false] String json = writeJSON returnText: true, json: amap def read = readJSON text: json assert read.something == 'my datas' assert read.size == 3 assert read.isEmpty == false
json
-
- Nested choice of objects
- (not enumerable)
file
(optional)-
Type:String
pretty
(optional)-
Type:int
returnText
(optional)-
Type:boolean
writeMavenPom
: Write a maven project file.
Writes a
Maven project
file. That for example was previously read by readMavenPom
.
Fields:
-
model
:
The Model
object to write. -
file
:
Optional path to a file in the workspace to write to.
If left empty the step will write topom.xml
in the current working directory.
Example:
def pom = readMavenPom file: 'pom.xml'
//Do some manipulation
writeMavenPom model: pom
Avoid using this step and readMavenPom
.
It is better to use the sh
step to run mvn
goals:
For example:
sh 'mvn versions:set-property -Dproperty=some-key -DnewVersion=some-value -DgenerateBackupPoms=false'
model
-
org.kohsuke.stapler.NoStaplerConstructorException: There's no @DataBoundConstructor on any constructor of class org.apache.maven.model.Model
file
(optional)-
Type:String
writeYaml
: Write a yaml from an object or objects.
Writes yaml to a file in the current working directory or a String from an Object or a String.
It uses SnakeYAML as YAML processor.
The call will fail if the file already exists.
Fields:
-
file
(optional):
Optional path to a file in the workspace to write the YAML datas to.
If provided, thenreturnText
must befalse
or omitted.
It is required that eitherfile
is provided, orreturnText
istrue
. -
data
(optional):
An Optional Object containing the data to be serialized. You must specifydata
or
datas
, but not both in the same invocation. -
datas
(optional):
An Optional Collection containing the datas to be serialized as several YAML documents. You must specify
data
ordatas
, but not both in the same invocation. -
charset
(optional):
Optionally specify the charset to use when writing the file. Defaults toUTF-8
if nothing else is specified.
What charsets that are available depends on your Jenkins master system.
The java specification tells us though that at least the following should be available:- US-ASCII
- ISO-8859-1
- UTF-8
- UTF-16BE
- UTF-16LE
- UTF-16
-
overwrite
(optional):
Allow existing files to be overwritten. Defaults tofalse
. -
returnText
(optional):
Return the YAML as a string instead of writing it to a file. Defaults tofalse
.
Iftrue
, thenfile
,charset
, andoverwrite
must not be provided.
It is required that eitherfile
is provided, orreturnText
istrue
.
Examples:
Writing to a file:
def amap = ['something': 'my datas',
'size': 3,
'isEmpty': false]
writeYaml file: 'datas.yaml', data: amap
def read = readYaml file: 'datas.yaml'
assert read.something == 'my datas'
assert read.size == 3
assert read.isEmpty == false
Writing to a string:
def amap = ['something': 'my datas', 'size': 3, 'isEmpty': false] String yml = writeYaml returnText: true, data: amap def read = readYaml text: yml assert read.something == 'my datas' assert read.size == 3 assert read.isEmpty == false
charset
(optional)-
Type:String
data
(optional)-
- Nested choice of objects
- (not enumerable)
datas
(optional)-
- Nested choice of objects
-
file
(optional)-
Type:String
overwrite
(optional)-
Type:boolean
returnText
(optional)-
Type:boolean
ws
: Allocate workspace
Allocates a workspace.
Note that a workspace is automatically allocated for you with the node
step.
dir
-
A workspace is automatically allocated for you with the
node
step,
or you can get an alternate workspace with thisws
step,
but by default the location is chosen automatically.
(Something likeAGENT_ROOT/workspace/JOB_NAME@2
.)You can instead specify a path here and that workspace will be locked instead.
(The path may be relative to the build agent root, or absolute.)If concurrent builds ask for the same workspace, a directory with a suffix such as
@2
may be locked instead.
Currently there is no option to wait to lock the exact directory requested;
if you need to enforce that behavior, you can either fail (error
) whenpwd
indicates that you got a different directory,
or you may enforce serial execution of this part of the build by some other means such asstage name: '…', concurrency: 1
.If you do not care about locking, just use the
dir
step to change current directory.Type:String
zip
: Create Zip fileCreate a zip file of content in the workspace.
zipFile
-
The name/path of the zip file to create.
Type:String
archive
(optional)-
If the zip file should be archived as an artifact of the current build.
The file will still be kept in the workspace after archiving.Type:boolean
dir
(optional)-
The path of the base directory to create the zip from.
Leave empty to create from the current working directory.Type:String
exclude
(optional)-
Type:String
file
(optional)-
Type:String
glob
(optional)-
Ant style pattern
of files to include in the zip.
Leave empty to include all files and directories.Type:String
overwrite
(optional)-
If the zip file should be overwritten in case of already existing a file with the same name.
Type:boolean
Permalink
Cannot retrieve contributors at this time
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
try { | |
error(«this is an error«) | |
} catch(e) { | |
// do something about the error | |
println(e) | |
// currentBuild.result is jenkins variable which is null by default | |
currentBuild.result = «FAILED« | |
} finally { | |
// do something here | |
println(«this will always run«) | |
// but fail it instead | |
if (currentBuild.result == «FAILED«) { | |
error(«You got an error again«) | |
} | |
} |