scm:tag

Full name:

org.apache.maven.plugins:maven-scm-plugin:1.8:tag

Description:

Tag the project.

Attributes:

  • Requires a Maven project to be executed.
  • Executes as an aggregator plugin.

Required Parameters

Name Type Since Description
basedir File - The base directory.
tag String - The tag name.

Optional Parameters

Name Type Since Description
addTimestamp boolean - Use timestamp tagging.
Default value is: false.
connectionType String - The type of connection to use (connection or developerConnection).
Default value is: connection.
connectionUrl String - The SCM connection URL.
Default value is: ${project.scm.connection}.
developerConnectionUrl String - The SCM connection URL for developers.
Default value is: ${project.scm.developerConnection}.
excludes String - Comma separated list of excludes file pattern.
includes String - Comma separated list of includes file pattern.
message String - The message applied to the tag creation.
passphrase String - The passphrase (used by java svn).
password String - The user password (used by svn, starteam and perforce protocol).
privateKey String - The private key (used by java svn).
providerImplementations Map - List of provider implementations.
pushChanges boolean 1.4 Should distributed changes be pushed to the central repository? For many distributed SCMs like Git, a change like a commit is only stored in your local copy of the repository. Pushing the change allows your to more easily share it with other users.
Default value is: true.
remoteTagging boolean 1.2 currently only implemented with svn scm. Enable a workaround to prevent issue due to svn client > 1.5.0 (http://jira.codehaus.org/browse/SCM-406)
Default value is: true.
systemProperties Properties - List of System properties to pass to the JUnit tests.
tagBase String - The url of tags base directory (used by svn protocol). It is not necessary to set it if you use the standard svn layout (branches/tags/trunk).
timestampFormat String - Set the timestamp format.
Default value is: yyyyMMddHHmmss.
timestampPosition String - Define the timestamp position (end or begin).
Default value is: end.
timestampPrefix String - Timestamp tag prefix.
Default value is: -.
username String - The user name (used by svn, starteam and perforce protocol).
workingDirectory File - The working directory.

Parameter Details

addTimestamp:

Use timestamp tagging.
  • Type: boolean
  • Required: No
  • Expression: ${addTimestamp}
  • Default: false

basedir:

The base directory.
  • Type: java.io.File
  • Required: Yes
  • Expression: ${basedir}

connectionType:

The type of connection to use (connection or developerConnection).
  • Type: java.lang.String
  • Required: No
  • Expression: ${connectionType}
  • Default: connection

connectionUrl:

The SCM connection URL.
  • Type: java.lang.String
  • Required: No
  • Expression: ${connectionUrl}
  • Default: ${project.scm.connection}

developerConnectionUrl:

The SCM connection URL for developers.
  • Type: java.lang.String
  • Required: No
  • Expression: ${connectionUrl}
  • Default: ${project.scm.developerConnection}

excludes:

Comma separated list of excludes file pattern.
  • Type: java.lang.String
  • Required: No
  • Expression: ${excludes}

includes:

Comma separated list of includes file pattern.
  • Type: java.lang.String
  • Required: No
  • Expression: ${includes}

message:

The message applied to the tag creation.
  • Type: java.lang.String
  • Required: No
  • Expression: ${message}

passphrase:

The passphrase (used by java svn).
  • Type: java.lang.String
  • Required: No
  • Expression: ${passphrase}

password:

The user password (used by svn, starteam and perforce protocol).
  • Type: java.lang.String
  • Required: No
  • Expression: ${password}

privateKey:

The private key (used by java svn).
  • Type: java.lang.String
  • Required: No
  • Expression: ${privateKey}

providerImplementations:

List of provider implementations.
  • Type: java.util.Map
  • Required: No

pushChanges:

Should distributed changes be pushed to the central repository? For many distributed SCMs like Git, a change like a commit is only stored in your local copy of the repository. Pushing the change allows your to more easily share it with other users.
  • Type: boolean
  • Since: 1.4
  • Required: No
  • Expression: ${pushChanges}
  • Default: true

remoteTagging:

currently only implemented with svn scm. Enable a workaround to prevent issue due to svn client > 1.5.0 (http://jira.codehaus.org/browse/SCM-406)
  • Type: boolean
  • Since: 1.2
  • Required: No
  • Expression: ${remoteTagging}
  • Default: true

systemProperties:

List of System properties to pass to the JUnit tests.
  • Type: java.util.Properties
  • Required: No

tag:

The tag name.
  • Type: java.lang.String
  • Required: Yes
  • Expression: ${tag}

tagBase:

The url of tags base directory (used by svn protocol). It is not necessary to set it if you use the standard svn layout (branches/tags/trunk).
  • Type: java.lang.String
  • Required: No
  • Expression: ${tagBase}

timestampFormat:

Set the timestamp format.
  • Type: java.lang.String
  • Required: No
  • Expression: ${timestampFormat}
  • Default: yyyyMMddHHmmss

timestampPosition:

Define the timestamp position (end or begin).
  • Type: java.lang.String
  • Required: No
  • Expression: ${timestampPosition}
  • Default: end

timestampPrefix:

Timestamp tag prefix.
  • Type: java.lang.String
  • Required: No
  • Expression: ${timestampPrefix}
  • Default: -

username:

The user name (used by svn, starteam and perforce protocol).
  • Type: java.lang.String
  • Required: No
  • Expression: ${username}

workingDirectory:

The working directory.
  • Type: java.io.File
  • Required: No
  • Expression: ${workingDirectory}