jenkins:getjob

Full name:

org.kuali.maven.plugins:jenkins-maven-plugin:1.0.4:getjob

Description:

Connect to a Jenkins server and retrieve an XML document describing the job configuration

Attributes:

  • Requires a Maven project to be executed.
  • Requires dependency resolution of artifacts in scope: test.

Required Parameters

Name Type Since Description
classname String - The classname for Jenkins CLI
Default value is: hudson.cli.CLI.
cmd String - The command issued to Jenkins CLI
Default value is: get-job.
stopOnError boolean - If set to true, the build will fail the first time it encounters an issue. When false, mojo's that issue multiple requests, will proceed through their list of requests and then fail at the end if an issue was encountered along the way.
Default value is: false.
timestampFormat String - The format for timestamp displays
Default value is: yyyy-MM-dd HH:mm:ss z.
type String - The type of job to retrieve. Maven GAV info is combined with 'type' to derive the complete job name eg 'jenkins-maven-plugin-1.0-publish'
Default value is: publish.
url String - The Jenkins instance to connect to.
Default value is: ${project.ciManagement.url}.
workingDir File - The working directory for the plugin
Default value is: ${project.build.directory}/jenkins.

Optional Parameters

Name Type Since Description
name String - The name of the job to retrieve. If name is supplied, 'type' is ignored

Parameter Details

classname:

The classname for Jenkins CLI
  • Type: java.lang.String
  • Required: Yes
  • Expression: ${jenkins.classname}
  • Default: hudson.cli.CLI

cmd:

The command issued to Jenkins CLI
  • Type: java.lang.String
  • Required: Yes
  • Expression: ${jenkins.cmd}
  • Default: get-job

name:

The name of the job to retrieve. If name is supplied, 'type' is ignored
  • Type: java.lang.String
  • Required: No
  • Expression: ${jenkins.name}

stopOnError:

If set to true, the build will fail the first time it encounters an issue. When false, mojo's that issue multiple requests, will proceed through their list of requests and then fail at the end if an issue was encountered along the way.
  • Type: boolean
  • Required: Yes
  • Expression: ${jenkins.stopOnError}
  • Default: false

timestampFormat:

The format for timestamp displays
  • Type: java.lang.String
  • Required: Yes
  • Expression: ${jenkins.timestampFormat}
  • Default: yyyy-MM-dd HH:mm:ss z

type:

The type of job to retrieve. Maven GAV info is combined with 'type' to derive the complete job name eg 'jenkins-maven-plugin-1.0-publish'
  • Type: java.lang.String
  • Required: Yes
  • Expression: ${jenkins.type}
  • Default: publish

url:

The Jenkins instance to connect to.
  • Type: java.lang.String
  • Required: Yes
  • Expression: ${jenkins.url}
  • Default: ${project.ciManagement.url}

workingDir:

The working directory for the plugin
  • Type: java.io.File
  • Required: Yes
  • Expression: ${jenkins.workingDir}
  • Default: ${project.build.directory}/jenkins