| <!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, 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 -R ~/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> | |
| <!-- FOOTER --> | |
| <div id="footer"> | |
| <hr/> | |
| <p> | |
| <a target='_blank' href='http://www.apache.org' title='Apache Software Foundation'> | |
| <img id="asf-logo" src="http://www.apache.org/images/asf-logo.gif" alt="Apache Software Foundation"/> | |
| </a> | |
| Copyright © 2001-2013 Apache Software Foundation. Apache Click, | |
| Click, Apache, the Apache feather logo, and the Apache Click project logo are | |
| trademarks of The Apache Software Foundation. | |
| <a href="http://cayenne.apache.org/privacy-policy.html">Privacy policy.</a> | |
| </p> | |
| </div> | |
| </body> | |
| </html> |