externals:release

Full name:

org.kuali.maven.plugins:externals-maven-plugin:1.0.5-SNAPSHOT:release

Description:

Perform a release of a multi-module Maven project that contains svn:externals. The release process creates a separate tag for each module defined as an svn:external after trimming SNAPSHOT off the version number. It then increments the version number in the root poms and re-appends the SNAPSHOT qualifier before committing the altered poms.

Attributes:

  • Requires a Maven project to be executed.

Optional Parameters

Name Type Since Description
buildNumberProperty String - The property where the current build number is stored. Jenkins automatically sets an environment variable called BUILD_NUMBER each time a job is run
Default value is: env.BUILD_NUMBER.
checkoutDir File - The directory where the new tag is checked out to
Default value is: ${project.build.directory}/checkout.
createTagMessage String - The commit message for when the new tag is first created
Default value is: [externals-maven-plugin] Create tag.
externalsMessage String - The commit message for when the svn propset command is used to set externals on the tag
Default value is: [externals-maven-plugin] Set svn:externals.
file File - The location of a text file that contains the svn:externals definitions
Default value is: ${project.build.directory}/checkout/svn.externals.
ignoreDirectories String - Directories to ignore when examining the file system for Maven pom's
Default value is: src,target,.svn,.git.
mappings List - These mappings connect the svn:externals definitions with a property inside the root pom that controls what version each external is set to
pom String - Filename pattern used to discover Maven pom's
Default value is: pom.xml.
scmUrlPrefix String - The prefix Maven needs in front of the real SCM url
Default value is: scm:svn:.
updateTagMessage String - The commit message for when the updated pom's and svn.external file is committed to the tag
Default value is: [externals-maven-plugin] Tag maintenance.

Parameter Details

buildNumberProperty:

The property where the current build number is stored. Jenkins automatically sets an environment variable called BUILD_NUMBER each time a job is run
  • Type: java.lang.String
  • Required: No
  • Expression: ${externals.buildNumberProperty}
  • Default: env.BUILD_NUMBER

checkoutDir:

The directory where the new tag is checked out to
  • Type: java.io.File
  • Required: No
  • Expression: ${externals.checkoutDir}
  • Default: ${project.build.directory}/checkout

createTagMessage:

The commit message for when the new tag is first created
  • Type: java.lang.String
  • Required: No
  • Expression: ${externals.createTagMessage}
  • Default: [externals-maven-plugin] Create tag

externalsMessage:

The commit message for when the svn propset command is used to set externals on the tag
  • Type: java.lang.String
  • Required: No
  • Expression: ${externals.externalsMessage}
  • Default: [externals-maven-plugin] Set svn:externals

file:

The location of a text file that contains the svn:externals definitions
  • Type: java.io.File
  • Required: No
  • Expression: ${externals.file}
  • Default: ${project.build.directory}/checkout/svn.externals

ignoreDirectories:

Directories to ignore when examining the file system for Maven pom's
  • Type: java.lang.String
  • Required: No
  • Expression: ${externals.ignoreDirectories}
  • Default: src,target,.svn,.git

mappings:

These mappings connect the svn:externals definitions with a property inside the root pom that controls what version each external is set to
  • Type: java.util.List
  • Required: No

pom:

Filename pattern used to discover Maven pom's
  • Type: java.lang.String
  • Required: No
  • Expression: ${externals.pom}
  • Default: pom.xml

scmUrlPrefix:

The prefix Maven needs in front of the real SCM url
  • Type: java.lang.String
  • Required: No
  • Expression: ${externals.scmUrlPrefix}
  • Default: scm:svn:

updateTagMessage:

The commit message for when the updated pom's and svn.external file is committed to the tag
  • Type: java.lang.String
  • Required: No
  • Expression: ${externals.updateTagMessage}
  • Default: [externals-maven-plugin] Tag maintenance