[Myfaces Wiki] Update of "Extensions/Validator/DevDoc/Steps For A Release" by LeonardoUribe

[Apache Wiki <wi...@apache.org>]

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Myfaces Wiki" for change notification.

The following page has been changed by LeonardoUribe:
http://wiki.apache.org/myfaces/Extensions/Validator/DevDoc/Steps_For_A_Release

New page:
== Steps For a Release of Apache MyFaces Extensions Validator ==

Myfaces Extensions Validator has a module layout that allows release one or all modules together. In other words, it is possible to:

 * Release all modules (synchronous)
 * Release some modules (asynchronous)

For do that, extval has a parent pom module that could be released at any time. Take into account that all artifacts must follow release procedure  guidelines of the ASF (Voting, signing artifacts, LICENSE and NOTICE...).

== Release Procedure All Modules at Once ==

1. Preparing myfaces extensions validator XX 1.X.X (read XX_1_X_X as <jsf-version>_<version> to make it clear)

    * Trying to prepare.
{{{
mvn release:prepare -DprepareRelease=true -DtagBase=https://svn.apache.org/repos/asf/myfaces/extensions/validator/branches/ -Dusername=lu4242 -Dscm.password=??? -Dtag="XX_1_X_X" -DdryRun=true
}}}

   * Release it

{{{
mvn release:prepare -DprepareRelease=true -DtagBase=https://svn.apache.org/repos/asf/myfaces/extensions/validator/branches/ -Dusername=lu4242 -Dscm.password=??? -Dtag="XX_1_0_X" -Dresume=false
}}}

  * It fails (generally maven release plugin says something about cannot find a dependency that is building) run mvn install, mvn release:rollback and try to release it again. It is a known maven release plugin error.

  * Checkout generated branch

2. Deploy on local repo SUCCESS

  * Generate artifacts like javadoc and others.
{{{
mvn clean install -Pgenerate-assembly
}}}

  * Deploy on local repo
{{{
mvn clean install deploy -DperformRelease=true  -DaltDeploymentRepository=myfaces-local-staging::default::scp://localhost/home/youraccount/toyourstagedirectory/somedirectorylikerepoextval1XX -DperformRelease=true
}}}

3. Copy on people.apache.org

{{{
scp -p -r org lu4242@people.apache.org:/home/yourapacheaccount/public_html/myfacesextval1XX
}}}

4. Generate assembly

{{{
cd assembly
mvn package

cd examples/assembly
mvn package
}}}

   * Sign artifacts using script.
{{{
openssl md5 myfaces-extvalXX-1.X.X-src.tar.gz > myfaces-extvalXX-1.X.X-src.tar.gz.md5
openssl md5 myfaces-extvalXX-1.X.X-src.zip > myfaces-extvalXX-1.X.X-src.zip.md5
openssl sha1 myfaces-extvalXX-1.X.X-src.tar.gz > myfaces-extvalXX-1.X.X-src.tar.gz.sha1
openssl sha1 myfaces-extvalXX-1.X.X-src.zip > myfaces-extvalXX-1.X.X-src.zip.sha1
gpg --armor --output myfaces-extvalXX-1.X.X-src.tar.gz.asc --detach-sig myfaces-extvalXX-1.X.X-src.tar.gz
gpg --armor --output myfaces-extvalXX-1.X.X-src.zip.asc --detach-sig myfaces-extvalXX-1.X.X-src.zip
openssl md5 myfaces-extvalXX-1.X.X-bin.tar.gz > myfaces-extvalXX-1.X.X-bin.tar.gz.md5
openssl md5 myfaces-extvalXX-1.X.X-bin.zip > myfaces-extvalXX-1.X.X-bin.zip.md5
openssl sha1 myfaces-extvalXX-1.X.X-bin.tar.gz > myfaces-extvalXX-1.X.X-bin.tar.gz.sha1
openssl sha1 myfaces-extvalXX-1.X.X-bin.zip > myfaces-extvalXX-1.X.X-bin.zip.sha1
gpg --armor --output myfaces-extvalXX-1.X.X-bin.tar.gz.asc --detach-sig myfaces-extvalXX-1.X.X-bin.tar.gz
gpg --armor --output myfaces-extvalXX-1.X.X-bin.zip.asc --detach-sig myfaces-extvalXX-1.X.X-bin.zip

openssl md5 myfaces-extval-examples-1.X.X-src.tar.gz > myfaces-extval-examples-1.X.X-src.tar.gz.md5
openssl md5 myfaces-extval-examples-1.X.X-src.zip > myfaces-extval-examples-1.X.X-src.zip.md5
openssl sha1 myfaces-extval-examples-1.X.X-src.tar.gz > myfaces-extval-examples-1.X.X-src.tar.gz.sha1
openssl sha1 myfaces-extval-examples-1.X.X-src.zip > myfaces-extval-examples-1.X.X-src.zip.sha1
gpg --armor --output myfaces-extval-examples-1.X.X-src.tar.gz.asc --detach-sig myfaces-extval-examples-1.X.X-src.tar.gz
gpg --armor --output myfaces-extval-examples-1.X.X-src.zip.asc --detach-sig myfaces-extval-examples-1.X.X-src.zip
openssl md5 myfaces-extval-examples-1.X.X-bin.tar.gz > myfaces-extval-examples-1.X.X-bin.tar.gz.md5
openssl md5 myfaces-extval-examples-1.X.X-bin.zip > myfaces-extval-examples-1.X.X-bin.zip.md5
openssl sha1 myfaces-extval-examples-1.X.X-bin.tar.gz > myfaces-extval-examples-1.X.X-bin.tar.gz.sha1
openssl sha1 myfaces-extval-examples-1.X.X-bin.zip > myfaces-extval-examples-1.X.X-bin.zip.sha1
gpg --armor --output myfaces-extval-examples-1.X.X-bin.tar.gz.asc --detach-sig myfaces-extval-examples-1.X.X-bin.tar.gz
gpg --armor --output myfaces-extval-examples-1.X.X-bin.zip.asc --detach-sig myfaces-extval-examples-1.X.X-bin.zip
}}}

   * Copy to directory
{{{
scp myfaces-extvalXX-1.X.X-1.0.0-bin* lu4242@people.apache.org:/home/lu4242/public_html/myfacesextval1XXbinsrc/binaries
scp myfaces-extvalXX-1.X.X-1.0.0-src* lu4242@people.apache.org:/home/lu4242/public_html/myfacesextval1XXbinsrc/sources
scp myfaces-extval-examples-1.X.X-bin* lu4242@people.apache.org:/home/lu4242/public_html/myfacesextval1XXbinsrc/binaries
scp myfaces-extval-examples-1.X.X-src* lu4242@people.apache.org:/home/lu4242/public_html/myfacesextval1XXbinsrc/sources
}}}

4. JIRA Release Management

  * Create release version and next snapshot.
  * Move all resolved issues from snapshot to release version.
  * Transition of all issues from resolved to closed.
  * 

4. Ask for vote

{{{
Hi,

I was running the needed tasks to get the 1.X.X release of Apache
MyFaces Extensions Validator out.

Please note that this vote concerns all of the following parts:
 1. Maven artifact group "org.apache.myfaces.extensions.validator" v1.X.X [1]

The artifacts are deployed to my private Apache account ([1]).

There is also binary and source packages available at ([3])

For more info about this artifacts take a loot at the site on ([4]).

Please take a look at the "1.X.X" 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,
Pepito Perez

[1] http://people.apache.org/~youraccount/myfacesextval1XX
[2] http://www.apache.org/foundation/voting.html#ReleaseVotes
[3] http://people.apache.org/~youraccount/myfacesextval1XXbinsrc
[4] http://myfaces.apache.org/extensions/validator
}}}

5. If vote success, continue with the procedure

6. Deploy on repo1.maven.org
{{{
mvn clean install deploy -DperformRelease=true -DaltDeploymentRepository=myfaces-staging::default::scpexe://people.apache.org/www/people.apache.org/repo/m2-ibiblio-rsync-repository  
}}}

7. copy svn branch to tag

8. ANNOUNCE mail

{{{
The Apache MyFaces team is pleased to announce the release of
Apache MyFaces Extensions Validator 1.X.X.

Apache MyFaces Extensions Validator provides an extensible framework to validate user input based on annotations.

Apache MyFaces Extensions Validator is available in the central Maven repository under
Group ID "org.apache.myfaces.extensions.validator".

Enjoy!

Pepito Perez
}}}

=== Testing ===
[[Anchor(testing)]]

Here's the procedure that anyone can do to help test the distribution.

{{{
}}}