Steps For a Release of Apache MyFaces Extensions CDI
Preparations
- Heads up on the mailing-lists
e.g.:
[codi] first steps for the next release hi @ all, if there are no objections, i'll start with the first steps for the next release (review, documentation,...). it would be great to start with the release procedure next week. regards, gerhard
- Check the documentation https://cwiki.apache.org/confluence/display/EXTCDI/Documentation
- Check https://analysis.apache.org/dashboard/index/org.apache.myfaces.extensions.cdi:myfaces-extcdi-parent
Check diff with tag of [version-1]
- Check the hudson builds
- Check the integration tests of all examples and add-ons - esp. at apache-extras e.g. http://code.google.com/a/apache-extras.org/p/myfaces-codi-examples/
Create release notes and commit them to https://svn.apache.org/repos/asf/myfaces/extensions/cdi/trunk/readme/ (format [README][version].txt)
- Test compile with Java 1.5
First Steps
mvn release:prepare -DdryRun=true //attention: use an useful tag-name (asked before the new version numbers) format [extcdi-[version]] (see https://svn.apache.org/repos/asf/myfaces/extensions/cdi/tags/) //important: check the generated javadoc in the jsf2 module and the bundle module for jsf2 //important: check if content was lost during release:prepare (especially license headers in pom.xml files) mvn release:clean mvn deploy //check http://repository.apache.org/content/repositories/snapshots/org/apache/myfaces/* mvn release:prepare -Papache-release //attention: use an useful tag-name (asked before the new version numbers) //attention: invoke x2 (esp. in european countries) //check tag in svn mvn release:perform -Papache-release //login to https://repository.apache.org/ and go to "Staging Repositories" //check the shadded configs and esp. .../org/apache/myfaces/extensions/cdi/myfaces-extcdi-parent/[version]/myfaces-extcdi-parent-[version]-source-release.zip //close the repository
Start the Vote
e.g.:
[VOTE] Release of Extensions CDI (CODI) 0.9.4 Hi, I was running the needed tasks to get the 5th release of Apache MyFaces Extensions CDI (aka MyFaces CODI) out. The artifacts are deployed to Nexus [1] (and [2]). The release contains the following modules: - CODI Core - CODI JSF Module (for 1.2 and 2.0 and 2.1) - CODI JPA Module - CODI BV Module - CODI I18N-Message Module - CODI Scripting Module - CODI Trinidad Support Module - CODI Distribution Modules - CODI Base Test-Infrastructure Module - CODI JUnit-Support Module - CODI Cargo-Support Module - CODI OpenWebBeans Test-Support Module - CODI JSF Test-Support Module - CODI JSF Example Please take a look at the 0.9.4 artifacts and vote! Please note: This vote is "majority approval" with a minimum of three +1 votes (see [3]). ------------------------------------------------ [ ] +1 for community members who have reviewed the bits [ ] +0 [ ] -1 for fatal flaws that should cause these bits not to be released, and why.............. ------------------------------------------------ Thanks, Gerhard [1] https://repository.apache.org/content/repositories/orgapachemyfaces-062/ [2] https://repository.apache.org/content/repositories/orgapachemyfaces-062/org/apache/myfaces/extensions/cdi/myfaces-extcdi-parent/0.9.4/myfaces-extcdi-parent-0.9.4-source-release.zip [3] http://www.apache.org/foundation/voting.html#ReleaseVotes
Steps after voting started
create a link to the release notes at http://s.apache.org (format CODI_[version])
- tweet about the vote via @MyFacesTeam.
e.g.:
The #MyFaces community is currently voting on #CODI 0.9.2! http://s.apache.org/CODI_092
Perform the final release
After 72 hours close the vote.
e.g.:
Result (was: Re: [VOTE] Release of Extensions CDI (CODI) 0.9.2) thank you for voting! X binding +1 votes (pmc): [list] Y non-binding +1 votes: [list] Z -1 votes [list] regards, gerhard
If the binding majority approved the vote continue.
- Login to https://repository.apache.org/ and release the repository
- Create the release at jira (https://issues.apache.org/jira/secure/project/ManageVersions.jspa?pid=12311071)
- Close the corresponding tickets of the version
- Wait some hours and check http://repo2.maven.org/maven2/org/apache/myfaces/extensions/cdi/
Site
- Publish the news on myfaces.apache.org http://svn.apache.org/repos/asf/myfaces/site/trunk/src/site/apt/index.apt and deploy it
- Upload the downloads (jsf12 and jsf20 bin and src assemblies (.tar.gz and .zip + *.asc and *.md5) and -source-release.zip (+ .asc and .md5)
scp -p -r ./binaries/* [user name]@people.apache.org:/www/www.apache.org/dist/myfaces/binaries/ scp -p -r ./source/* [user name]@people.apache.org:/www/www.apache.org/dist/myfaces/source/ //check http://www.apache.org/dist/myfaces/binaries/ and http://www.apache.org/dist/myfaces/source/
- Update the CODI downloads and deploy the site
Announce the Release
E-Mails
e.g.:
[ANNOUNCE] Release of Apache MyFaces Extensions CDI 0.9.2 The Apache MyFaces team is pleased to announce the 3rd release of Apache MyFaces Extensions CDI (aka CODI). Apache MyFaces CODI provides portable CDI extensions for the Java-Platform (SE and EE). CODI is a modularized and extensible toolbox for CDI based applications. The release contains the following modules: - CODI Core - CODI JSF Module (for 1.2 and 2.x) - CODI JPA Module - CODI BV Module - CODI I18N-Message Module - CODI Scripting Module - CODI Trinidad Support Module - CODI Distribution Modules - CODI Base Test-Infrastructure Module Apache MyFaces CODI is available in both binary and source distributions: http://myfaces.apache.org/extensions/cdi/download.html Apache MyFaces CODI is available in the central Maven repository under Group ID "org.apache.myfaces.extensions.cdi.*". Release Notes: http://s.apache.org/CODI_092 Enjoy! Gerhard Petracek
Write the e-mails to:
- announce@apache.org
- announce@myfaces.apache.org
- users@myfaces.apache.org and dev@myfaces.apache.org
Further announcements
- Twitter the news
e.g.:
[ANNOUNCE] The Apache MyFaces team is pleased to announce the 3rd release of #Apache #MyFaces Extensions #CDI (aka #CODI).
- Write blog entries
Post release steps
- Update https://cwiki.apache.org/confluence/display/EXTCDI/CODI+Versions
- Delete old version at www.apache.org/dist
- Add the release to the MyFaces report
- Check all version numbers
- Update version numbers at Webapp-tests (see @WebappDependency e.g. @WebappDependency("org.apache.myfaces.extensions.cdi.core:myfaces-extcdi-core-api:jar:0.9.2-SNAPSHOT") )