[dev] Releasing Parancoe
This document is addressed to the Parancoe developer(s) in charge of releasing a version of Parancoe.
Releasing the main project
- go to the main directory of the Parancoe project ($PARANCOE_HOME)
- type
mvn release:prepare
- when asked, type the release version number for each artifact. Be careful to insert the same release version number for each artifact
- when asked, type the SCM tag or label for “Parancoe”. Usually you simply need to confirm the proposed label, by pressing
Enter
- when asked, type the new development version for each artifact. Before the 1.0 release (not yet planned), please insert
1.0-SNAPSHOT
, do not confirm the proposed1.1-SNAPSHOT
.
- (if something went wrong)
- clean the release:
mvn release:clean
- revert the poms:
svn revert pom.xml parancoe-core/pom.xml parancoe-web/pom.xml parancoe-yaml/pom.xml
- clean the release:
- type
mvn release:perform
. Be careful: you need upload privileges on the Parancoe maven repository. The repository is synchronized with the Central Maven Repository, and there is no way for removing something from there. - type
mvn release:clean
Releasing the plugins
- go to the $PARANCOE_HOME/plugins
- update the plugins pom, setting the dependency with the parancoe-web artifact to the most recently released version
- type
mvn release:prepare
- when asked, type the release version number for each artifact. Be careful to insert the same release version number for each artifact
- when asked, type the SCM tag or label for “plugins”. Usually you simply need to confirm the proposed label, by pressing
Enter
- when asked, type the new development version for each artifact. Before the 1.0 release (not yet planned), please insert
1.0-SNAPSHOT
, do not confirm the proposed1.1-SNAPSHOT
.
- (if something went wrong)
- clean the release:
mvn release:clean
- revert the poms:
svn revert pom.xml parancoe-plugin-*/pom.xml
- clean the release:
- type
mvn release:perform
. Be careful: you need upload privileges on the Parancoe maven repository. The repository is synchronized with the Central Maven Repository, and there is no way for removing something from there. - type
mvn release:clean
Releasing the web archetype
- go to the $PARANCOE_HOME/parancoe-webarchetype
- update the
src/main/resources/archetype-resources/pom.xml
, setting the dependency with the parancoe-web and plugin artifacts to the most recently released version - type
mvn release:prepare
- when asked, type the release version number for each artifact. Be careful to insert the same release version number for each artifact
- when asked, type the SCM tag or label for “Archetype…”. Usually you simply need to confirm the proposed label, by pressing
Enter
- when asked, type the new development version for each artifact. Before the 1.0 release (not yet planned), please insert
1.0-SNAPSHOT
, do not confirm the proposed1.1-SNAPSHOT
.
- (if something went wrong)
- clean the release:
mvn release:clean
- revert the poms:
svn revert pom.xml
- clean the release:
- type
mvn release:perform
. Be careful: you need upload privileges on the Parancoe maven repository. The repository is synchronized with the Central Maven Repository, and there is no way for removing something from there. - type
mvn release:clean
Assemblies
Assembling the Parancoe files
- checkout or extract the release of parancoe you want assemble. We’ll call its main directory $PARANCOE_HOME.
- go to the $PARANCOE_HOME directory
- type
mvn package assembly:assembly
- upload the files of the $PARANCOE_HOME/target directory. Usually we upload the following files:
parancoe-x.y.z-bin.tar.gz
parancoe-x.y.z-bin.zip
Assembling the Parancoe plugins
- checkout or extract the release of parancoe-plugins you want assemble. We’ll call its main directory $PLUGINS_HOME.
- go to the $PLUGINS_HOME directory
- type
mvn package assembly:assembly
- upload the files of the $PLUGINS_HOME/target directory. Usually we upload the following files:
parancoe-plugins-x.y.z-bin.tar.gz
parancoe-plugins-x.y.z-bin.zip
Assembling the Parancoe Web Archetype
- checkout or extract the release of parancoe-webarchetype you want assemble. We’ll call its main directory $ARCHETYPE_HOME.
- go to the $ARCHETYPE_HOME directory
- type
mvn package assembly:assembly
- upload the files of the $PLUGINS_HOME/target directory. Usually we upload the following files:
parancoe-webarchetype-x.y.z-bin.tar.gz
parancoe-webarchetype-x.y.z-bin.zip
Assembling the Parancoe Basic Web Application
- this part of Parancoe isn’t released, but builded from the SNAPSHOT tree. So, go to the
$PARANCOE_HOME/examples/basicWebApp
directory - update the pom.xml, setting the dependency with the parancoe-web and plugins artifacts to the most recently released versions
- type
mvn clean install
- upload the file
target/basicWebApp.war
renaming it tobasicWebApp-x.y.z.war
, according to the current Parancoe release.
Posted by Lucio Benfante on Feb 29, 2008