NewVersion

jiraNewVersion

Creates new version based on given input, which should have some minimal information on that object.

Input

• version - version to be created.
• site - Optional, default: JIRA_SITE environment variable.
• failOnError - Optional. default: true.
• auditLog - Optional. default: true. Append the build url and build user name to the description.

Output

• Each step generates generic output, please refer to this link for more information.
• The api response of this jira_new_version step can be reused later in your script by doing response.data.required_field_name.
• You can see some example scenarios here
• All the available fields for a jira response can be found in JIRA Api documentation depending on your JIRA version.

Examples

• With default site from global variables.

  node {
    stage('JIRA') {
      def testVersion = [ name: 'test-version',
                          archived: true,
                          released: true,
                          description: 'desc',
                          project: 'TEST' ]
      jiraNewVersion version: testVersion
    }
  }
  

• withEnv to override the default site (or if there is not global site)

  node {
    stage('JIRA') {
      withEnv(['JIRA_SITE=LOCAL']) {
        def testVersion = [ name: 'test-version',
                            archived: true,
                            released: true,
                            description: 'desc',
                            project: 'TEST' ]
        jiraNewVersion version: testVersion
      }
    }
  }
  

• Without environment variables.

  def testVersion = [ name: 'test-version',
                      archived: true,
                      released: true,
                      description: 'desc',
                      project: 'TEST' ]
  jiraNewVersion version: testVersion, site: 'LOCAL'