howto-release.adoc

How to Release GateIn Quickstarts

How to Release GateIn Quickstarts

Tip	There is src/build/sh/release-community.sh script that covers the steps 1. to 5. below.

1. Change to the project top directory:

   cd ~/git/gatein-portal-quickstart

2. Ensure that the READMEs are up to date:

   mvn clean install -P generate-readmes
   ./src/build/sh/md2html.sh # see prerequisites inside md2html.sh

3. If the working copy changed after these commands, commit & push.

4. Create a new git tag

   git tag -a [jpp|gatein]-quickstart-[major].[minor].[micro].[qualifier] -m ...
   git push ...

5. Generate the distributable files:

   mvn clean install -P prepare-zips

6. Upload the files to download.jboss.org/gatein/quickstarts/[jpp|gatein]-[major].[minor] where JBoss Tools and JBoss Developer Studio expect them:

   cd target/assembly
   ls -l
   total 3248
   -rw-rw-r--. 1 ppalaga ppalaga   14519 May 14 15:35 cdi-generic-portlet.zip
   -rw-rw-r--. 1 ppalaga ppalaga   20507 May 14 15:35 cdi-jsf-portlet.zip
   -rw-rw-r--. 1 ppalaga ppalaga   19236 May 14 15:35 cdi-scopes-portlet.zip
   -rw-rw-r--. 1 ppalaga ppalaga 1640427 May 14 15:35 GateIn-3.6-Quickstarts.zip
   -rw-rw-r--. 1 ppalaga ppalaga  827038 May 14 15:35 portal-extension.zip
   -rw-rw-r--. 1 ppalaga ppalaga  571123 May 14 15:35 sample-portal.zip
   -rw-rw-r--. 1 ppalaga ppalaga   32647 May 14 15:35 jsf2-hello-world-portlet.zip
   -rw-rw-r--. 1 ppalaga ppalaga   32994 May 14 15:35 jsf2-rf4-hello-world-portlet.zip
   -rw-rw-r--. 1 ppalaga ppalaga   24607 May 14 15:35 navigation-api-portlet.zip
   -rw-rw-r--. 1 ppalaga ppalaga   25808 May 14 15:35 project-examples-gatein3.6-jbt4.1-001.xml
   -rw-rw-r--. 1 ppalaga ppalaga   12145 May 14 15:35 simplest-hello-world-portlet.zip
   -rw-rw-r--. 1 ppalaga ppalaga   81222 May 14 15:35 social-portlets.zip
   
   # in most cases, you want to publish the *-Quickstarts.zip file (which contains all quickstarts)
   # separately under GateIn/JBoss Portal Downloads
   mv -t /tmp *-Quickstarts.zip
   # the remainig files belong to download.jboss.org/gatein/quickstarts/[jpp|gatein]-[major].[minor] folder
   rsync * ...

7. Upload the *-Quickstarts.zip file to GateIn/JBoss Portal Downloads:

   rsync /tmp/*-Quickstarts.zip ...
   rm /tmp/*-Quickstarts.zip