blob: 5ac5ea029db40ff3f00b8eacb7ef4761a341be75 (
plain) (
tree)
|
|
<html><head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Releasing Jetty</title><link rel="stylesheet" type="text/css" href="css/docbook.css"><meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1"><meta name="keywords" content="jetty, servlet-api, cometd, http, spdy, eclipse, maven, java, software"><link rel="home" href="index.html" title="Jetty : The Definitive Reference"><link rel="up" href="advanced-contributing.html" title="Chapter 30. Contributing to Jetty"><link rel="prev" href="contributing-patches.html" title="Contributing Patches"><link rel="next" href="release-testing.html" title="Testing a Jetty Release"><link xmlns:jfetch="java:org.eclipse.jetty.xslt.tools.JavaSourceFetchExtension" xmlns:fetch="java:org.eclipse.jetty.xslt.tools.SourceFetchExtension" xmlns:d="http://docbook.org/ns/docbook" xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0" xmlns:xslthl="http://xslthl.sf.net" rel="shortcut icon" href="images/favicon.ico"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><center xmlns:jfetch="java:org.eclipse.jetty.xslt.tools.JavaSourceFetchExtension" xmlns:fetch="java:org.eclipse.jetty.xslt.tools.SourceFetchExtension" xmlns:d="http://docbook.org/ns/docbook" xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0" xmlns:xslthl="http://xslthl.sf.net"><a href="http://www.eclipse.org/jetty"><img src="images/jetty-logo.svg" width="80"></a></center><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Releasing Jetty</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="contributing-patches.html">Prev</a> </td><th width="60%" align="center">Chapter 30. Contributing to Jetty</th><td width="20%" align="right"> <a accesskey="n" href="release-testing.html">Next</a></td></tr></table><hr></div><div xmlns:jfetch="java:org.eclipse.jetty.xslt.tools.JavaSourceFetchExtension" xmlns:fetch="java:org.eclipse.jetty.xslt.tools.SourceFetchExtension" xmlns:d="http://docbook.org/ns/docbook" xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0" xmlns:xslthl="http://xslthl.sf.net" style="background-color: #DEF; text-align: left; font-size:80%; font-family: arial, sans; border:thin dotted blue; padding: 4px; "><span style="font-variant: small-caps; font-weight: bold"><a href="http://www.webtide.com/support.jsp" style="text-decoration:none">Contact the core Jetty developers at
<span style="color:#F3A"> www.webtide.com</span></a></span><br><span style="font-style:oblique;font-size: 80%">
private support for your internal/customer projects ... custom extensions and distributions ... versioned snapshots for indefinite support ...
scalability guidance for your apps and Ajax/Comet projects ... development services from 1 day to full product delivery
</span></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="releasing-jetty"></a>Releasing Jetty</h2></div></div></div><div class="toc"><dl><dt><span class="section"><a href="releasing-jetty.html#d0e11779">Jetty Release Notes</a></span></dt><dt><span class="section"><a href="releasing-jetty.html#d0e11858">Building and Deploying Aggregate Docs</a></span></dt><dt><span class="section"><a href="releasing-jetty.html#d0e11876">Deploying Distribution Files</a></span></dt><dt><span class="section"><a href="releasing-jetty.html#d0e11888">Updating Stable Links</a></span></dt></dl></div><p>There are a number of steps to releasing jetty. It is not just limited
to running a couple of maven commands and then moving onto bigger and better
things. There are a number of process related issues once the fun maven bits
have been completed.</p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="d0e11779"></a>Jetty Release Notes</h3></div></div></div><p>This release script is for jetty-9 (to release jetty-7 or jetty-8
see older documentation).</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>Pick your version identification strings.</p><p>These follow a strict format and will be used when prompted
during step <a class="xref" href="releasing-jetty.html#prepare-release-step">6</a> below.</p><pre class="screen">Release Version : 9.0.0.v20130322 (v[year][month][day])
Next Development Version : 9.0.1-SNAPSHOT
Tag Name : jetty-9.9.0.v20130322 </pre></li><li class="listitem"><p>We use the 'release-9' branch to avoid problems with other
developers actively working on the master branch.</p><pre class="screen">// Get all of the remotes
$ git pull origin
// Create a local tracking branch (if you haven't already)
$ git branch --track release-9 refs/remotes/origin/release-9
// Check out your local tracking branch.
$ git checkout release-9
// Merge from master into the branch (this becomes your point in time
// from master that you will be releasing from)
$ git merge --no-ff master</pre></li><li class="listitem"><p>Update the VERSION.txt with changes from the git logs, this
populates the resolves issues since the last release.</p><pre class="screen">$ mvn -N -Pupdate-version </pre></li><li class="listitem"><p>Edit the VERSION.txt file to set the 'Release Version' at the
top alongside the Date of this release.</p><pre class="screen">$ vi VERSION.txt </pre></li><li class="listitem"><p>Make sure everything is commit'd and pushed to
git.eclipse.org</p><pre class="screen">$ git commit -m "Updating VERSION.txt top section" VERSION.txt
$ git push origin release-9 </pre></li><li class="listitem"><p><a name="prepare-release-step"></a>Prepare the Release</p><p>NOTE: This step updates the <version> elements in the
pom.xml files, does a test build with these new versions, and then
commits the pom.xml changes to your local git repo.</p><pre class="screen">$ mvn release:prepare -DreleaseVersion=9.0.0.v20130322 \
-DdevelopmentVersion=9.0.1-SNAPSHOT \
-Dtag=jetty-9.0.0.v20130322 </pre></li><li class="listitem"><p>Perform the Release</p><p>NOTE: This step performs the release and deploys it to a
oss.sonatype.org staging repository.</p><pre class="screen">$ mvn release:perform</pre></li><li class="listitem"><p>Set up files for next development versions.</p><p>Edit <code class="filename">VERSION.txt</code> for 'Next Development
Version' at the top. Do not date this line.</p><p>Make sure everything is commit'd and pushed to
git.eclipse.org</p><pre class="screen">$ vi VERSION.txt
$ git commit -m "Updating VERSION.txt top section" VERSION.txt
$ git push origin release-9</pre></li><li class="listitem"><p>Close the staging repository on oss.sonatype.org</p></li><li class="listitem"><p>Announce stage to the mailing list for testing.</p></li><li class="listitem"><p>Once the staged repository has been approved by the rest of the
committers.</p><div class="orderedlist"><ol class="orderedlist" type="a"><li class="listitem"><p>Release the staging repository to maven central on
oss.sonatype.org</p></li><li class="listitem"><p>Merge back the changes in release-9 to master</p><pre class="screen">$ git checkout master
$ git merge --no-ff release-9
$ git push origin master</pre></li></ol></div></li></ol></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="d0e11858"></a>Building and Deploying Aggregate Docs</h3></div></div></div><p>Define the jetty.eclipse.website server entry in your
.m2/settings.xml file. You'll need to have access to the dev.eclipse.org
machine to perform these actions. If you don't know if you have access to
this then you probably don't and will need to ask a project leader for
help.</p><p>To build and deploy the aggregate javadoc and jxr bits:</p><pre class="screen">cd target/checkout
mvn -Paggregate-site javadoc:aggregate jxr:jxr
mvn -N site:deploy </pre><p>This will generate the aggregate docs and deploy them to the
<code class="filename">/home/www/jetty/<project version>/jetty-project</code>
directory on download.eclipse.org. The last step is to ssh to that machine
and adjust the placement of the apidocs and xref directories to remove the
jetty-project folder from the url so that we maintain a clean and
consistent api url scheme.</p><pre class="screen">ssh $COMMITTER_ID@dev.eclipse.org
cd /home/data/httpd/download.eclipse.org/jetty/<VERSION>
mv jetty-project/apidocs .
mv jetty-project/xref .
rmdir jetty-project </pre><p>The end result should be api documents accessible from
http://download.eclipse.org/jetty/<project version>/api-docs and
http://download.eclipse.org/jetty/<project version>/xref</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="d0e11876"></a>Deploying Distribution Files</h3></div></div></div><p>Since we also provide alternative locations to download jetty
distributions we need to copy these into place. There are a couple of
scripts that will take care of this although they need to be localized to
your particular execution environment and you need to have authorization
to put stuff where it needs to go. These scripts are located at: <a class="link" href="http://git.eclipse.org/c/jetty/org.eclipse.jetty.admin.git/tree/release-scripts" target="_top">
http://git.eclipse.org/c/jetty/org.eclipse.jetty.admin.git/tree/release-scripts</a>.
Once these are setup you can deploy a release to eclipse and codehaus with
the following incantation.</p><pre class="screen">$ ./promote-to-eclipse.sh 9.0.0.v20130322
$ ./promote-to-codehaus.sh 9.0.0.v20130322 9.0.0 </pre><p>Each of these scripts will download all of the relevant files from
maven central and then copy them into the correct location on eclipse and
codehaus infrastructure. On the eclipse side of it they will also adjust
the documentation links if they remain broken as well as regenerate all of
the html files on the eclipse download site.</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="d0e11888"></a>Updating Stable Links</h3></div></div></div><p>Since we are not allowed to have symbolic links on the download site
we have to log into the machine manually and remove the previous stable
directory and update it with a new release. Maintaining the conventions we
use on the site will allow all 'stable' links to be stable and not needed
to update to the latest major Jetty build version:</p><pre class="screen">$ ssh <user>@build.eclipse.org
$ cd ~downloads/jetty/
$ rm -Rf stable-9
$ cp -r <version> stable-9
$ ./index.sh </pre><p>This needs to be done for all Eclipse Jetty releases (regardless of
version). In addition we have to work to reduce the footprint of jetty on
the primary eclipse download resources so we want to move older releases
to the eclipse archive site.</p><pre class="screen">$ cd ~/downloads/jetty
$ mv <old release> /home/data/httpd/archive.eclipse.org/jetty/ </pre></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="contributing-patches.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="advanced-contributing.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="release-testing.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Contributing Patches </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Testing a Jetty Release</td></tr></table></div><div xmlns:jfetch="java:org.eclipse.jetty.xslt.tools.JavaSourceFetchExtension" xmlns:fetch="java:org.eclipse.jetty.xslt.tools.SourceFetchExtension" xmlns:d="http://docbook.org/ns/docbook" xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0" xmlns:xslthl="http://xslthl.sf.net" style="background-color: #DEF; text-align: left; font-size:80%; font-family: arial, sans; border:thin dotted blue; padding: 4px; "><span style="font-style:oblique;font-size: 80%">
See an error or something missing?<br></span><span style="font-variant: small-caps; font-weight: bold"><a href="http://github.com/jetty-project/jetty-documentation" style="text-decoration:none">Contribute to this documentation at
<span style="color:#F3A"> Github!</span></a></span><br></div><script xmlns:jfetch="java:org.eclipse.jetty.xslt.tools.JavaSourceFetchExtension" xmlns:fetch="java:org.eclipse.jetty.xslt.tools.SourceFetchExtension" xmlns:d="http://docbook.org/ns/docbook" xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0" xmlns:xslthl="http://xslthl.sf.net" type="text/javascript">
var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-1149868-7']);
_gaq.push(['_trackPageview']);
(function() {
var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
})();
</script></body></html>
|
