<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" | |
"http://www.w3.org/TR/html4/loose.dtd"> | |
<!-- | |
Licensed to the Apache Software Foundation (ASF) under one | |
or more contributor license agreements. See the NOTICE file | |
distributed with this work for additional information | |
regarding copyright ownership. The ASF licenses this file | |
to you under the Apache License, Version 2.0 (the | |
"License"); you may not use this file except in compliance | |
with the License. You may obtain a copy of the License at | |
http://www.apache.org/licenses/LICENSE-2.0 | |
Unless required by applicable law or agreed to in writing, | |
software distributed under the License is distributed on an | |
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY | |
KIND, either express or implied. See the License for the | |
specific language governing permissions and limitations | |
under the License. | |
--> | |
<html> | |
<head> | |
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/> | |
<meta name="Author" content="Malcolm Edgar"/> | |
<meta name="description" lang="en" content="Apache Click Java web application framework"/> | |
<meta name="keywords" lang="en" content="Apache Click, Click Framework, Java, JEE, J2EE, web application framework, open source"/> | |
<title>Apache Click</title> | |
<link rel="stylesheet" type="text/css" href="../../help.css"/> | |
<style type="text/css"> | |
th { text-align: left; } | |
td { vertical-align: top; white-space: nowrap; } | |
</style> | |
</head> | |
<body> | |
<h1>Creating a Release for Subprojects</h1> | |
This page documents the requirements for releasing a Click subproject. | |
<p/> | |
<b>Please note</b> this section is for committers only. | |
<h3>Prerequisites</h3> | |
Subprojects have the same prerequisites as Click. See <a href="releasing.html#prerequisites">here</a> for details. | |
<h3>Release Procedure</h3> | |
Subproject releases should adhere to the following steps: | |
<ol> | |
<li> | |
Create the distribution using your favorite build tool e.g. Ant. | |
</li> | |
<li> | |
Create MD5 and SHA1 hashes of the distribution file. | |
</li> | |
<li> | |
Digitally sign the distribution, for example: | |
<pre class="codeConfig">gpg --armor --output ClickIDE-X.X.X.zip.asc --detach-sig ClickIDE-X.X.X.zip</pre> | |
</li> | |
<li> | |
Upload the distribution to your account at <tt>people.apache.org</tt> | |
under the folder <tt>~/public_html/click/SUBPROJECT/X.X.X</tt>, where | |
<tt>SUBPROJECT</tt> is the name of the subproject and X.X.X | |
is the version. | |
<p/> | |
For example version <tt>2.2.0</tt> of subproject <tt>ClickIDE</tt> could be published to: | |
<pre class="codeConfig"><tt>~/public_html/click/clickide/2.2.0</tt></pre> | |
Make sure the uploaded files have the right permissions (<tt>664</tt>) | |
and belong to the 'click' group to ensure that other members | |
have proper access to these files. | |
If not execute the following commands to ensure file and directory | |
permissions are correct: | |
<pre class="codeConfig">ssh people.apache.org | |
cd ~/public_html/click/clickide/X.X.X | |
find . -type d | xargs chmod 775 | |
find . -type f | xargs chmod 664 | |
chgrp -R click *</pre> | |
</li> | |
<li> | |
Verify the digital signatures at <tt>people.apache.org</tt> to | |
ensure nothing went wrong with the upload. | |
<p/> | |
Please note if this is the first time you verify your key | |
at <tt>people.apache.org</tt>, you'll need to import your public | |
key first. | |
<p/> | |
Assuming your public key ID is 'B51329CB' and your key is available | |
from the public key server 'pgp.mit.edu', the following command | |
will import the key on <tt>people.apache.org</tt>: | |
<pre class="codeConfig"> | |
ssh people.apache.org | |
gpg --keyserver pgp.mit.edu --recv-keys B51329CB | |
</pre> | |
Next verify the signature with the following command: (Replace SUBPROJECT with the name of the actual project.) | |
<pre class="codeConfig"> | |
ssh people.apache.org | |
cd ~/public_html/click/SUBPROJECT/X.X.X | |
gpg --verify SUBPROJECT-X.X.X.zip.asc SUBPROJECT-X.X.X.zip | |
</pre> | |
</li> | |
<li> | |
Releases must be voted on before they are published. Please | |
see the <a href="releasing.html#voting">Voting</a> | |
section for details. | |
</li> | |
<li> | |
Releases are published at <tt>people.apache.org</tt> under | |
the folder: | |
<p/> | |
<tt>/www/www.apache.org/dist/click/<tt>SUBPROJECT</tt>/X.X.X</tt> | |
<p/> | |
For example <tt>ClickIDE</tt> will be published to the folder: | |
<p/> | |
<tt>/www/www.apache.org/dist/click/clickide/X.X.X</tt> | |
<p/> | |
An easy way to do this is to copy the files in your <tt>public_html</tt> | |
folder for example: | |
<pre class="codeConfig">ssh people.apache.org | |
cp ~/public_html/click/clickide/X.X.X/ /www/www.apache.org/dist/click/clickide/X.X.X | |
</pre> | |
</li> | |
<li> | |
Email release announcement to <tt>click-user</tt> and <tt>click-dev</tt> | |
mailing lists. | |
</li> | |
</ol> | |
<p/> | |
</body> | |
</html> |