This document describes the release process for the CDI APIs. We assume you are in the root directory of the APIs. Before you start, take a look at the getting started guide.

Ensure all dependencies are released

Maven is strict (which is no bad thing!) about ensuring that all dependencies are non-snapshot before starting the release. So, check the properties in pom.xml, and release any dependencies needed.

Checking whether you are good to go

The maven release plugin is very powerful, and will transform all your POMs to a release version, tag them, and then revert trunk or the branch back to a development version. We can also do a dry run to check there are no snapshot dependencies (for example, a developer might have mistakenly put the version in a sub-module). If there are any problems, you need to fix them, and check in the changes.

Make sure all the changes are checked in using svn status.

Now, run mvn release:prepare --batch-mode -Drelease -DdevelopmentVersion=A.B-SNAPSHOT -DreleaseVersion=X.Y-Q -Dtag=X.Y-Q -DdryRun - this will run through the release process, but not actually perform the tagging.

If the build fails, go back and correct the problems

Tagging the release

Now we are ready to tag the release. Make sure the tag doesn't already exist, and run mvn release:prepare --batch-mode -Drelease -DdevelopmentVersion=A.B-SNAPSHOT -DreleaseVersion=X.Y-Q -Dtag=X.Y-Q -Dresume=false.

Once this finishes, verify that the tag is correct (e.g. use a browser).

Perform the release to maven

Now, run mvn release:perform nexus:staging-close -Drelease. You should see all the artifacts uploaded to the staging repository.

Upload the CDI API Javadoc to docs.jboss.org

Uploading is done using SCP, SFTP, or RSYNC in a restricted secure shell on the filemgmt.jboss.org machine:

sftp cdi@filemgmt.jboss.org

Once logged in place your doc content under /docs_htdocs/cdi/api/X.Y-Q. It will then appear at http://docs.jboss.org/cdi.

Uploading is done using SCP, SFTP, or RSYNC in a restricted secure shell on the filemgmt.jboss.org machine:

mkdir -p target/javadoc
cd target/javadoc
unzip ~/.m2/repository/javax/enterprise/cdi-api/{X.Y-Q}/cdi-api-{X.Y-Q}-javadoc.jar
rsync -r --protocol=28 . cdi@filemgmt.jboss.org:docs_htdocs/cdi/api/{X.Y-Q}

Remember to update the latest symlink

sftp cdi@filemgmt.jboss.org:docs_htdocs/cdi/api
rm latest
ln -s X.Y-Q latest

Upload the xsd to jboss.org

Uploading is done using SCP, SFTP, or RSYNC in a restricted secure shell on the filemgmt.jboss.org machine:

scp src/main/resources/beans_1_0.xsd cdi@filemgmt.jboss.org:schema_htdocs/cdi