Apache Commons logo

commons-release:clean-staging

Full name:

org.apache.commons:commons-release-plugin:1.7:clean-staging

Description:

This class checks out the dev distribution location, checkes whether anything exists in the distribution location, and if it is non-empty it deletes all of the resources there.

Attributes:

  • Requires a Maven project to be executed.
  • Executes as an aggregator plugin.
  • Since version: 1.6.
  • Binds by default to the lifecycle phase: post-clean.

Required Parameters

Name Type Since Description
<project> MavenProject 1.6 The MavenProject object is essentially the context of the maven build at a given time.
Default value is: ${project}.

Optional Parameters

Name Type Since Description
<distCleanupDirectory> File 1.6 The location to which to checkout the dist subversion repository under our working directory, which was given above. We then do an SVN delete on all of the directories in this repository.
Default value is: ${project.build.directory}/commons-release-plugin/scm-cleanup.
User property is: commons.distCleanupDirectory.
<distServer> String 1.6 The ID of the server (specified in settings.xml) which should be used for dist authentication. This will be used in preference to username/password.
User property is: commons.distServer.
<distSvnStagingUrl> String 1.6 The url of the subversion repository to which we wish the artifacts to be staged. Typically this would need to be of the form: scm:svn:https://dist.apache.org/repos/dist/dev/commons/foo/version-RC#. Note. that the prefix to the substring https is a requirement.
User property is: commons.distSvnStagingUrl.
<dryRun> Boolean 1.6 A boolean that determines whether or not we actually commit the files up to the subversion repository. If this is set to true, we do all but make the commits. We do checkout the repository in question though.
Default value is: false.
User property is: commons.release.dryRun.
<isDistModule> Boolean 1.6 A parameter to generally avoid running unless it is specifically turned on by the consuming module.
Default value is: false.
User property is: commons.release.isDistModule.
<password> String 1.6 The password associated with CommonsDistributionStagingMojo.username.
User property is: user.password.
<username> String 1.6 The username for the distribution subversion repository. This is typically your Apache id.
User property is: user.name.
<workingDirectory> File 1.6 The main working directory for the plugin, namely target/commons-release-plugin, but that assumes that we're using the default maven ${project.build.directory}.
Default value is: ${project.build.directory}/commons-release-plugin.
User property is: commons.outputDirectory.

Parameter Details

<distCleanupDirectory>

The location to which to checkout the dist subversion repository under our working directory, which was given above. We then do an SVN delete on all of the directories in this repository.
  • Type: java.io.File
  • Since: 1.6
  • Required: No
  • User Property: commons.distCleanupDirectory
  • Default: ${project.build.directory}/commons-release-plugin/scm-cleanup

<distServer>

The ID of the server (specified in settings.xml) which should be used for dist authentication. This will be used in preference to username/password.
  • Type: java.lang.String
  • Since: 1.6
  • Required: No
  • User Property: commons.distServer

<distSvnStagingUrl>

The url of the subversion repository to which we wish the artifacts to be staged. Typically this would need to be of the form: scm:svn:https://dist.apache.org/repos/dist/dev/commons/foo/version-RC#. Note. that the prefix to the substring https is a requirement.
  • Type: java.lang.String
  • Since: 1.6
  • Required: No
  • User Property: commons.distSvnStagingUrl

<dryRun>

A boolean that determines whether or not we actually commit the files up to the subversion repository. If this is set to true, we do all but make the commits. We do checkout the repository in question though.
  • Type: java.lang.Boolean
  • Since: 1.6
  • Required: No
  • User Property: commons.release.dryRun
  • Default: false

<isDistModule>

A parameter to generally avoid running unless it is specifically turned on by the consuming module.
  • Type: java.lang.Boolean
  • Since: 1.6
  • Required: No
  • User Property: commons.release.isDistModule
  • Default: false

<password>

The password associated with CommonsDistributionStagingMojo.username.
  • Type: java.lang.String
  • Since: 1.6
  • Required: No
  • User Property: user.password

<project>

The MavenProject object is essentially the context of the maven build at a given time.
  • Type: org.apache.maven.project.MavenProject
  • Since: 1.6
  • Required: Yes
  • Default: ${project}

<username>

The username for the distribution subversion repository. This is typically your Apache id.
  • Type: java.lang.String
  • Since: 1.6
  • Required: No
  • User Property: user.name

<workingDirectory>

The main working directory for the plugin, namely target/commons-release-plugin, but that assumes that we're using the default maven ${project.build.directory}.
  • Type: java.io.File
  • Since: 1.6
  • Required: No
  • User Property: commons.outputDirectory
  • Default: ${project.build.directory}/commons-release-plugin