Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

...

There is no need to manually deploy snapshots.
Snapshots are automatically deployed by Hudson build to the Nexus snapshot repository at https://repository.apache.org/content/repositories/snapshots/org/apache/wink

Updating Notice files

Code Block

for i in `/usr/bin/find . -name "NOTICE"`; do sed "s/Copyright (c) 2009-2012 The Apache Software Foundation/Copyright (c) 2009-2013 The Apache Software Foundation/g" $i >/tmp/tmp.notice; cp /tmp/tmp.notice $i; done

Performing a Release

For the most part, we follow the same instructions that the maven team uses.http://maven.apache.org/developers/release/releasing.html

...

Code Block
xml
xml
<scm>
    <connection>scm:svn:http://svn.apache.org/repos/asf/incubator/wink/trunk</connection>
    <developerConnection>scm:svn:https://svn.apache.org/repos/asf/incubator/wink/trunk</developerConnection>
    <url>http://svn.apache.org/viewvc/incubator/wink/trunk</url>
</scm>

To (change the branch name appropriately):

Code Block
xml
xml
<scm>
    <connection>scm:svn:http://svn.apache.org/repos/asf/incubator/wink/branches/wink-1.1-incubating</connection>
    <developerConnection>scm:svn:https://svn.apache.org/repos/asf/incubator/wink/branches/wink-1.1-incubating</developerConnection>
    <url>http://svn.apache.org/viewvc/incubator/wink/branches/wink-1.1-incubating</url>
</scm>

...

Code Block
xml
xml
<version>1.1.0-incubating-SNAPSHOT</version>

If, for example, the target version is 1.1-incubating.0-SNAPSHOT, change the tag in each of the places found in your find commands to:

Code Block
xml
xml
<version>1.1-incubating<.0</version>

You can also use find and sed together to change the versions:

No Format
find wink-itests -name 'pom.xml' -type f -exec sed -i 's/1.1.0-incubating-SNAPSHOT/1.1-incubating.0/g' {} \;
find wink-itests -name '*.java' -type f -exec sed -i 's/1.1.0-incubating-SNAPSHOT/1.1-incubating.0/g' {} \;
find wink-assembly -name 'pom.xml' -type f -exec sed -i 's/1.1.0-incubating-SNAPSHOT/1.1-incubating.0/g' {} \;

Also read through and edit appropriate changes to the release_notes.txt and wink-assembly/wink-assembly-aggregatejar/DEPENDENCIES files.

...

Running mvn release:prepare will executes the following steps

  • Check that there are no uncommitted changes in the sources
  • Check that there are no SNAPSHOT dependencies
  • Change the version in the poms from x-SNAPSHOT to a new version (you will be prompted for the versions to use)
  • Transform the SCM information in the POM to include the final destination of the tag
  • Run the project tests against the modified POMs to confirm everything is in working order
  • Tag the code in the SCM with a version name (this will be prompted for)
  • Bump the version in the POMs to a new value y-SNAPSHOT (these values will also be prompted for)
    • NOTE: since we're running the release from the branch, and you want this branch name to match up with the version in the pom.xml files within the branch, use the same name on this "development version" prompt that you used on the "release version" prompt. We'll update the pom.xml files in trunk by hand after a successful release vote.
  • Commit the modified POMs

You'll have to build some modules by hand to prepare your local repository for the release:perform: (wiki note: why is this needed?)

...

Running mvn release:perform will executes the following steps

  • Checkout from the tag
  • Build the project and deploy all artifacts to Nexus temporary staging repository while gpg signing all artifacts.


3. Close the staging repository

...

If the vote is unsuccessful, the process will need to be restarted

  • Rollback changes done to POMs
  • delete tag from SCM manually
  • Login to Nexus, and "Drop" the release from the staging repository


6. Successful wink-dev Voting, Call the general@incubator vote

...

Copy the actual distributions (all artifacts located under apache-wink in Nexus repo) to people.apache.org:/www/www.apache.org/dist/incubator/wink. You can

No Format
create the directory for the release
'cd' into it
'wget -r -l 1 https://repository.apache.org/content/groups/public/org/apache/wink/apache-wink/1.1.2-incubating/' to retrieve the artifacts (url is an example)
'mv repository.apache.org/content/groups/public/org/apache/wink/apache-wink/1.1.2-incubating/* .'
'rm -rf repository.apache.org index.html'


9. Update Wink site
  • Check out Wink site from https://svn.apache.org/repos/asf/incubator/wink/site
  • Update Wink Java-Docs by:
    • Download & extract Java-Docs from distribution source archivearchive; apache-wink-1.1.2-incubating.zip, for example
    • Create new directory under /wink/site/trunk/src/site/resources/VERSION and copy extracted Java-Docs
  • Update Wink site Download page with new Wink release artifacts
  • Follow instructions located under /wink/site/trunk/how-to.txt to rebuild the site

...