netbout-spi-1.5.INSTALL.txt Maven / Gradle / Ivy
Copyright (c) 2009-2012, Netbout.com
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met: 1) Redistributions of source code must retain the above
copyright notice, this list of conditions and the following
disclaimer. 2) Redistributions in binary form must reproduce the above
copyright notice, this list of conditions and the following
disclaimer in the documentation and/or other materials provided
with the distribution. 3) Neither the name of the NetBout.com nor
the names of its contributors may be used to endorse or promote
products derived from this software without specific prior written
permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT
NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
OF THE POSSIBILITY OF SUCH DAMAGE.
===============================================================================
Prerequisites
-------------
To build the project you need the following:
- JDK 1.6
- Maven (>= 3.0.3)
Continuous Integration Configuration
------------------------------------
Continuous Integration platform has to be configured to run
"mvn deploy" on every commit. Besides that the platform has to
have "settings.xml", "pubring.gpg", and "secring.gpg" files available
near the project source code base. These files are not inside SVN
repository for security reasons. They have to be provided by the CI
platform owner (the project owner, in most cases). "settings.xml"
file has to document connection settings to the sonatype repository
and web deployment platform. For example (this is a complete example
of "setting.xml" file):
ci
../../closures/
...
....
netbout.s3
....
....
sonatype.nexus
....
....
At the moment the following two goals are defined in our CI
server:
mvn clean deploy site-deploy -e -Dci -Dsite --settings ../../closures/settings.xml
How to release new version to Maven Central:
---------------------------------
1. Create a new ticket in Trac, explaining why you want to release
a new version (for example see ticket #121)
2. Create new branch
3. Replace ... with the next
version you want to use, e.g.:
find . -name "*.xml" -exec sed -i "" 's|\(\\)2\.0\-SNAPSHOT\(\<\/version\>\)|\11.3\2|g' {} \;
4. Commit your changes to SVN
5. Read these pages:
https://docs.sonatype.org/display/Repository/Sonatype+OSS+Maven+Repository+Usage+Guide#SonatypeOSSMavenRepositoryUsageGuide-8.ReleaseIt
http://www.sonatype.com/books/nexus-book/reference/staging-sect-managing-plugin.html
6. Run "mvn -Dci -Pnetbout-production clean deploy"
Make sure that you have this profile in ~/.m2/settings.xml:
netbout-production
/code/gpg/netbout
...
...
7. Go to oss.sonatype.org:
1) login,
2) close staging repo,
3) release staging repo
8. Copy your branch to tags:
svn cp ^/branches/ticketXX ^/tags/netbout-X.X.X -m "refs #XX - netbout-1.3 released to Maven Central"
9. Delete the branch or merge it back to trunk (if you did any changes). Don't
forget to revert back version number:
find . -name "*.xml" -exec sed -i "" 's|\(\\)1\.3\(\<\/version\>\)|\12.0-SNAPSHOT\2|g' {} \;
10. Close the ticket as "fixed"
That's it