February 2008 Archives

[dev] Releasing Parancoe

This document is addressed to the Parancoe developer(s) in charge of releasing a version of Parancoe.

Releasing the main project

  1. go to the main directory of the Parancoe project ($PARANCOE_HOME)
  2. type mvn release:prepare
    1. when asked, type the release version number for each artifact. Be careful to insert the same release version number for each artifact
    2. when asked, type the SCM tag or label for “Parancoe”. Usually you simply need to confirm the proposed label, by pressing Enter
    3. 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 proposed 1.1-SNAPSHOT.
  3. (if something went wrong)
    1. clean the release: mvn release:clean
    2. revert the poms: svn revert pom.xml parancoe-core/pom.xml parancoe-web/pom.xml parancoe-yaml/pom.xml
  4. 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.
  5. type mvn release:clean

Releasing the plugins

  1. go to the $PARANCOE_HOME/plugins
  2. update the plugins pom, setting the dependency with the parancoe-web artifact to the most recently released version
  3. type mvn release:prepare
    1. when asked, type the release version number for each artifact. Be careful to insert the same release version number for each artifact
    2. when asked, type the SCM tag or label for “plugins”. Usually you simply need to confirm the proposed label, by pressing Enter
    3. 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 proposed 1.1-SNAPSHOT.
  4. (if something went wrong)
    1. clean the release: mvn release:clean
    2. revert the poms: svn revert pom.xml parancoe-plugin-*/pom.xml
  5. 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.
  6. type mvn release:clean

Releasing the web archetype

  1. go to the $PARANCOE_HOME/parancoe-webarchetype
  2. 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
  3. type mvn release:prepare
    1. when asked, type the release version number for each artifact. Be careful to insert the same release version number for each artifact
    2. when asked, type the SCM tag or label for “Archetype…”. Usually you simply need to confirm the proposed label, by pressing Enter
    3. 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 proposed 1.1-SNAPSHOT.
  4. (if something went wrong)
    1. clean the release: mvn release:clean
    2. revert the poms: svn revert pom.xml
  5. 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.
  6. type mvn release:clean

Assemblies

Assembling the Parancoe files

  1. checkout or extract the release of parancoe you want assemble. We’ll call its main directory $PARANCOE_HOME.
  2. go to the $PARANCOE_HOME directory
  3. type mvn package assembly:assembly
  4. 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

  1. checkout or extract the release of parancoe-plugins you want assemble. We’ll call its main directory $PLUGINS_HOME.
  2. go to the $PLUGINS_HOME directory
  3. type mvn package assembly:assembly
  4. 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

  1. checkout or extract the release of parancoe-webarchetype you want assemble. We’ll call its main directory $ARCHETYPE_HOME.
  2. go to the $ARCHETYPE_HOME directory
  3. type mvn package assembly:assembly
  4. 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

  1. this part of Parancoe isn’t released, but builded from the SNAPSHOT tree. So, go to the $PARANCOE_HOME/examples/basicWebApp directory
  2. update the pom.xml, setting the dependency with the parancoe-web and plugins artifacts to the most recently released versions
  3. type mvn clean install
  4. upload the file target/basicWebApp.war renaming it to basicWebApp-x.y.z.war, according to the current Parancoe release.
Continue Reading…

Posted by Lucio Benfante on Feb 29, 2008