JGit Flow Maven Plugin

jgitflow:release-finish

Full name:

external.atlassian.jgitflow:jgitflow-maven-plugin:1.0-m5.1:release-finish

Description:

(no description)

Attributes:

  • Requires a Maven project to be executed.
  • Executes as an aggregator plugin.
  • Requires dependency resolution of artifacts in scope: test.
  • Since version: version.

Optional Parameters

Name Type Since Description
allowSnapshots boolean version Whether to allow SNAPSHOT dependencies. Default is to fail when finding any SNAPSHOT.
Default value is: false.
User property is: allowSnapshots.
allowUntracked boolean version Whether to allow untracked files when checking if the working tree is clean.
Default value is: false.
User property is: allowUntracked.
alwaysUpdateOrigin boolean version Whether to always overwrite the origin url in the .git/config file This is useful to ensure the proper origin url is used in CI environments
Default value is: true.
User property is: alwaysUpdateOrigin.
arguments String version ALL of the explicit arguments to be passed to the internal maven build. If not set, the plugin will use the args from the initial maven build.
User property is: arguments.
autoVersionSubmodules boolean version Whether to automatically assign submodules the parent version. If set to false, the user will be prompted for the version of each submodules.
Default value is: false.
User property is: autoVersionSubmodules.
consistentProjectVersions boolean version If set to true, only the first parent/project version will be used across all version updates
Default value is: false.
User property is: consistentProjectVersions.
defaultOriginUrl String version Default url to use if origin remote is not found in .git/config. This is highly useful for CI servers that don't do proper clones.
User property is: defaultOriginUrl.
enableSshAgent boolean version Whether to enable using an ssh-agent.
Default value is: false.
User property is: enableSshAgent.
eol String version This can be used to force the type of line ending used when rewriting poms. If not set, blank or has an invalid value, the eol will be looked up from core.eol Valid values are: native, lf, crlf
User property is: eol.
flowInitContext FlowInitContext version This parameter permits you to configure branch and tag names, as shown in the following example: 
<flowInitContext>
  <masterBranchName>master</masterBranchName>
  <developBranchName>develop</developBranchName>
  <featureBranchPrefix>feature-</featureBranchPrefix>
  <releaseBranchPrefix>release-</releaseBranchPrefix>
  <hotfixBranchPrefix>hotfix-</hotfixBranchPrefix>
  <versionTagPrefix>stable-</versionTagPrefix>
</flowInitContext>

Default value is: ${flowInitContext}.
goals String version The space-separated list of gaols to run when doing a maven deploy
Default value is: clean deploy.
User property is: goals.
keepBranch boolean version Whether to keep the release branch after finishing the release. If set to false, the branch will be deleted.
Default value is: false.
User property is: keepBranch.
localOnly boolean version Whether to turn off all operations access the remote git repository. This will still allow network access to download dependencies and such.

NOTE: THIS IS NOT CURRENTLY IMPLEMENTED!
Default value is: false.
User property is: localOnly.
noDeploy boolean version Whether to turn off maven deployment. If false the "deploy" goal is called. If true the "install" goal is called
Default value is: false.
User property is: noDeploy.
noReleaseBuild boolean version Whether to turn off project building. If true the project will NOT be built during release finish
Default value is: false.
User property is: noReleaseBuild.
noReleaseMerge boolean version Whether to turn off merging changes from the release branch to master and develop
Default value is: false.
User property is: noReleaseMerge.
noTag boolean version Whether to turn off tagging the release in git.
Default value is: false.
User property is: noTag.
offline boolean version Whether to turn off all operations that require network access. NOTE: THIS IS NOT CURRENTLY IMPLEMENTED!
Default value is: ${settings.offline}.
User property is: offline.
password String version The password to use when using user/pass authentication
User property is: password.
pullDevelop boolean version Whether to pull the develop branch when jgitflow is initialized
Default value is: false.
User property is: pullDevelop.
pullMaster boolean version Whether to pull the master branch when jgitflow is initialized
Default value is: false.
User property is: pullMaster.
pushReleases boolean version Whether to push release branches to the remote upstream.
Default value is: false.
User property is: pushReleases.
releaseBranchVersionSuffix String version Suffix to append to versions on the release branch.
User property is: releaseBranchVersionSuffix.
releaseFinishExtension String version A FQCN of a compatible release finish extension. Extensions are used to run custom code at various points in the jgitflow lifecycle. More documentation on using extensions will be available in the future
scmCommentPrefix String version The message prefix to use for all SCM changes.
User property is: scmCommentPrefix.
scmCommentSuffix String version The message suffix to use for all SCM changes.
User property is: scmCommentSuffix.
squash boolean version Whether to squash commits into a single commit before merging.
Default value is: false.
User property is: squash.
tagMessage String version Commit message to use when tagging the release. If not set, the default message is "tagging release ${version}".
User property is: tagMessage.
updateDependencies boolean version Whether, for modules which refer to each other within the same multi-module build, to update dependencies version to the release version.
Default value is: true.
User property is: updateDependencies.
useReleaseProfile boolean version Whether to use the release profile that adds sources and javadocs to the released artifact, if appropriate. If set to true, the plugin sets the property "performRelease" to true, which activates the profile "release-profile", which is inherited from the super pom.
Default value is: true.
User property is: useReleaseProfile.
username String version The username to use when using user/pass authentication
User property is: username.

Parameter Details

allowSnapshots:

Whether to allow SNAPSHOT dependencies. Default is to fail when finding any SNAPSHOT.
  • Type: boolean
  • Since: version
  • Required: No
  • User Property: allowSnapshots
  • Default: false

allowUntracked:

Whether to allow untracked files when checking if the working tree is clean.
  • Type: boolean
  • Since: version
  • Required: No
  • User Property: allowUntracked
  • Default: false

alwaysUpdateOrigin:

Whether to always overwrite the origin url in the .git/config file This is useful to ensure the proper origin url is used in CI environments
  • Type: boolean
  • Since: version
  • Required: No
  • User Property: alwaysUpdateOrigin
  • Default: true

arguments:

ALL of the explicit arguments to be passed to the internal maven build. If not set, the plugin will use the args from the initial maven build.
  • Type: java.lang.String
  • Since: version
  • Required: No
  • User Property: arguments

autoVersionSubmodules:

Whether to automatically assign submodules the parent version. If set to false, the user will be prompted for the version of each submodules.
  • Type: boolean
  • Since: version
  • Required: No
  • User Property: autoVersionSubmodules
  • Default: false

consistentProjectVersions:

If set to true, only the first parent/project version will be used across all version updates
  • Type: boolean
  • Since: version
  • Required: No
  • User Property: consistentProjectVersions
  • Default: false

defaultOriginUrl:

Default url to use if origin remote is not found in .git/config. This is highly useful for CI servers that don't do proper clones.
  • Type: java.lang.String
  • Since: version
  • Required: No
  • User Property: defaultOriginUrl

enableSshAgent:

Whether to enable using an ssh-agent.
  • Type: boolean
  • Since: version
  • Required: No
  • User Property: enableSshAgent
  • Default: false

eol:

This can be used to force the type of line ending used when rewriting poms. If not set, blank or has an invalid value, the eol will be looked up from core.eol Valid values are: native, lf, crlf
  • Type: java.lang.String
  • Since: version
  • Required: No
  • User Property: eol

flowInitContext:

This parameter permits you to configure branch and tag names, as shown in the following example: 
<flowInitContext>
  <masterBranchName>master</masterBranchName>
  <developBranchName>develop</developBranchName>
  <featureBranchPrefix>feature-</featureBranchPrefix>
  <releaseBranchPrefix>release-</releaseBranchPrefix>
  <hotfixBranchPrefix>hotfix-</hotfixBranchPrefix>
  <versionTagPrefix>stable-</versionTagPrefix>
</flowInitContext>
  • Type: com.atlassian.maven.plugins.jgitflow.FlowInitContext
  • Since: version
  • Required: No
  • Default: ${flowInitContext}

goals:

The space-separated list of gaols to run when doing a maven deploy
  • Type: java.lang.String
  • Since: version
  • Required: No
  • User Property: goals
  • Default: clean deploy

keepBranch:

Whether to keep the release branch after finishing the release. If set to false, the branch will be deleted.
  • Type: boolean
  • Since: version
  • Required: No
  • User Property: keepBranch
  • Default: false

localOnly:

Whether to turn off all operations access the remote git repository. This will still allow network access to download dependencies and such.

NOTE: THIS IS NOT CURRENTLY IMPLEMENTED!
  • Type: boolean
  • Since: version
  • Required: No
  • User Property: localOnly
  • Default: false

noDeploy:

Whether to turn off maven deployment. If false the "deploy" goal is called. If true the "install" goal is called
  • Type: boolean
  • Since: version
  • Required: No
  • User Property: noDeploy
  • Default: false

noReleaseBuild:

Whether to turn off project building. If true the project will NOT be built during release finish
  • Type: boolean
  • Since: version
  • Required: No
  • User Property: noReleaseBuild
  • Default: false

noReleaseMerge:

Whether to turn off merging changes from the release branch to master and develop
  • Type: boolean
  • Since: version
  • Required: No
  • User Property: noReleaseMerge
  • Default: false

noTag:

Whether to turn off tagging the release in git.
  • Type: boolean
  • Since: version
  • Required: No
  • User Property: noTag
  • Default: false

offline:

Whether to turn off all operations that require network access. NOTE: THIS IS NOT CURRENTLY IMPLEMENTED!
  • Type: boolean
  • Since: version
  • Required: No
  • User Property: offline
  • Default: ${settings.offline}

password:

The password to use when using user/pass authentication
  • Type: java.lang.String
  • Since: version
  • Required: No
  • User Property: password

pullDevelop:

Whether to pull the develop branch when jgitflow is initialized
  • Type: boolean
  • Since: version
  • Required: No
  • User Property: pullDevelop
  • Default: false

pullMaster:

Whether to pull the master branch when jgitflow is initialized
  • Type: boolean
  • Since: version
  • Required: No
  • User Property: pullMaster
  • Default: false

pushReleases:

Whether to push release branches to the remote upstream.
  • Type: boolean
  • Since: version
  • Required: No
  • User Property: pushReleases
  • Default: false

releaseBranchVersionSuffix:

Suffix to append to versions on the release branch.
  • Type: java.lang.String
  • Since: version
  • Required: No
  • User Property: releaseBranchVersionSuffix

releaseFinishExtension:

A FQCN of a compatible release finish extension. Extensions are used to run custom code at various points in the jgitflow lifecycle. More documentation on using extensions will be available in the future
  • Type: java.lang.String
  • Since: version
  • Required: No

scmCommentPrefix:

The message prefix to use for all SCM changes.
  • Type: java.lang.String
  • Since: version
  • Required: No
  • User Property: scmCommentPrefix

scmCommentSuffix:

The message suffix to use for all SCM changes.
  • Type: java.lang.String
  • Since: version
  • Required: No
  • User Property: scmCommentSuffix

squash:

Whether to squash commits into a single commit before merging.
  • Type: boolean
  • Since: version
  • Required: No
  • User Property: squash
  • Default: false

tagMessage:

Commit message to use when tagging the release. If not set, the default message is "tagging release ${version}".
  • Type: java.lang.String
  • Since: version
  • Required: No
  • User Property: tagMessage

updateDependencies:

Whether, for modules which refer to each other within the same multi-module build, to update dependencies version to the release version.
  • Type: boolean
  • Since: version
  • Required: No
  • User Property: updateDependencies
  • Default: true

useReleaseProfile:

Whether to use the release profile that adds sources and javadocs to the released artifact, if appropriate. If set to true, the plugin sets the property "performRelease" to true, which activates the profile "release-profile", which is inherited from the super pom.
  • Type: boolean
  • Since: version
  • Required: No
  • User Property: useReleaseProfile
  • Default: true

username:

The username to use when using user/pass authentication
  • Type: java.lang.String
  • Since: version
  • Required: No
  • User Property: username

Back to top

Copyright ©2015 Atlassian. All Rights Reserved.

Reflow Maven skin by Andrius Velykis.