|Home > Documentation > Geronimo Release Process > Geronimo Component Release Process|
Everyone is encouraged to update this documentation with clarifications, use of newer maven tooling, etc. Only major changes inconsistent with the spirit of this process need to be discussed on the dev list.
The next sections are copied from http://maven.apache.org/developers/release/releasing.html with modifications for Geronimo.
What follows is a description of releasing a Geronimo project to a staging repository, whereupon it is scrutinized by the community, approved, and transfered to a production repository.
Be sure that:
settings.xml. For more information, please refer to Maven Committer settings which also apply for Geronimo committers.
In order to release a project you must also have the following setup in your
$HOME/.m2/settings.xml which is a profile that defines the staging repository.
Here's what your release profile might look like in your
The server name apache.releases at the start of deploy.altRepository must correspond to the apache.releases server definition.
Also that your apache id does not start with "~".
Everything that you need to release has (will have, actually) been configured in the genesis root pom all Geronimo projects inherit from.
Your project should adhere to standard trunk,branches,tags svn layout in which case no further release profile configuration should be needed. Some slight deviation such as our specs project still works without extra configuration. Avoid more complex layouts that require special configuration.
This is the base release configuration in the genesis root pom:
1. Prepare your poms for release:
Genesis and the recommended settings.xml file above rely on the existence of some configuration in the top level pom in your project to parameterize where in your staging area the release will be located. This makes it so you can have multiple independent releases under vote in your staging area at once, and clearly locates the maven generated site in the documentation once the release is completed. You should only need to do this the first time these instructions are used.
pom.xmlwith the one called
pom.xml.tagto see if the license or any other info has been removed. This has been known to happen if the starting <project> tag is not on a single line. The only things that should be different between these files are the
<scm>elements. Any other changes, you must back-port yourself to the original
pom.xmlfile and commit before proceeding with the release.
mvn release:cleanbefore you start the real release process.
IMPORTANT NOTE: Be sure that the generated artifacts respect the Apache release rules : NOTICE and LICENSE files should be present in the META-INF directory within the jar. For -sources artifacts, be sure that your pom does NOT use the maven-source-plugin:2.0.3 which is broken. The recommended version at this time is 2.0.4. All this should be automated
via the maven-remote-resources-plugin (installs legal files) and the tools-maven-plugin (checks for legal files).
If during mvn deploy command, you are challenged for password many times, you may want to create ssh private and public keys.
You could verify the deployment under Apache Snapshot repository.
3. Prepare the release
Preparing the release will create the new tag in SVN, automatically checking in on your behalf.
getting authorization failure
If the prepare release command failed because of authorization failure, like below:
svn: MKACTIVITY of '/repos/asf/!svn/act/6ed2cc4d-dae9-4134-9cfb-f17cc8dd02ea': authorization failed (https://svn.apache.org)
You can issue "mvn release:prepare -Prelease -Dusername=username -Dpassword=password" instead.
4. Make a copy of the checked out project in this state in case you need to roll back the release
AFAICT mvn release:rollback only works on a checkout on which mvn release:prepare has been run but not mvn release:perform.
5. Stage the release for a vote
If the project lists the default modules in a profile you MUST include that profile and the release profile in the command line! For instance if the default profile id is "default" the command line would be
6. Stage the latest documentation (if there is an actual maven generated site)
See the genesis project-config site page for instructions on how to set up your project so site staging works.
Note that the -Prelease profile is needed to specify the profile in settings.xml that configures the staging location.
Build the site from the tag that release:perform checked out into target/checkout in step 5.
7. Propose a vote on the dev list with the closed issues, the issues left, the staging repository and the staging site. For instance:
Once a vote is successful, post the result to the dev list and cc the pmc.
In case the vote fails, rollback the release using the backup copy you made in step 4
You also have to remove the tag from svn by hand.
8. Copy from the staging repo to the production repo
Once the release is deemed fit for public consumption it can be transfered to a production repository where it will be available to all users.
Note: Current version of the stage plugin is 1.0-alpha-1. There's probably an easier way, but I added it to a pom and built to pull it down.
This version of the stage plugin does not work with maven 2.0.9. Use a suitable path to maven so you run it using maven 2.0.8. Note that the stage plugin does not use any info from the project so this should cause no problems
Here is an example on how to use the stage plugin:
The version parameter is currently ignored and the entire staging repository is synced, not just the given version or the current project. It still needs to be provided, though.
Ensure that your public PGP key is in appropriate public locations (esp. /www/www.apache.org/dist/geronimo/KEYS on people and http://pgp.mit.edu/) and that your pgp key has been signed by several other apache committers to create a web of trust.
9. Deploy the current and versioned websites (if there is a reasonable maven generated site)
10. Review Website (if any)
Wait for the files to arrive at
11. Update the plugins page
If this is a plugin release, update the apache
PROPOSAL ON HOW TO DO THIS:
First, perform the release. This process could be done as part of the release but that may be too confusing. The important point is to build the new tag with a fresh copy of geronimo-plugins.xml.
geronimo-plugins.xml is located in svn under e.g. geronimo/site/trunk/docs/plugins/geronimo-2.1/geronimo-plugins.xml
copy this file to
mvn clean install on a fresh checkout of the new tag.
copy the merged geronimo-plugins.xml back your svn site checkout.
Put the apache license header back in to the merged file (the car-maven-plugin removes it)
Edit the source-repository elements in the new plugins if necessary. They should contain
and most likely nothing else.
commit the svn revisions.
12. Update JIRA
Go to Admin section in JIRA and move the released version to released and make a new version.
13. Create an Announcement. For instance:
we don't seem to have a "next board report" or a recent releases page in the wiki
14. Add the release to the next board report, in the private subversion area.
15. Add the release to the wiki, under the Recent Releases section of the front page and on the Releases page.
16. Celebrate :o)
Once a new branch is created you will generally need to manage the version number in the poms. The following Perl scripts will assist in that task. It could use some polishing but given the relatively infrequent use.
Remember to properly escape periods in the oldVersion. For instance, to change 1.1.1-SNAPSHOT to 1.1.1 you would have
making the above script work
You must replace GeronimoDirectory above with the fully qualified path to the directory (using "~" will not work).
Also note: There are references to versions outside of the pom parent entries updated by the script which will also need to be updated with the new version.
We create a branch at freeze time for the following reasons:
pom.xmlto point to the final url in tags. Eg:
Before running this step, verify that there is a corresponding "staging" or "release" profile in pom.xml. Some of the newer releases, will require you to use -Pdefault,release as we are trying to make it impossible to directly release artifacts to the apache.release repo by providing a default "release" profile that stages files to public people.apache.org directory.
deploy.altRepositoryelement in the staging profile of your
settings.xml. Delete all *.asc.* files under this directory tree. Tar the staging directory using the command
Ensure you include the *.asc files, as these are required and will be checked for by the Apache Repository team.
Ensure that the files you copy to the rsync directory have
0775 dir permission and a
0664 file permission set on them.
The original process in this document was voted on by the Geronimo community. Please formally propose all changes to firstname.lastname@example.org.
Revised process using maven tools voted on in March 2008. Only major structural changes now require votes.
See: (not yet in archive)