Added: deltaspike/site/trunk/content/staging/documentation/steps_for_a_release.html URL: http://svn.apache.org/viewvc/deltaspike/site/trunk/content/staging/documentation/steps_for_a_release.html?rev=1643124&view=auto ============================================================================== --- deltaspike/site/trunk/content/staging/documentation/steps_for_a_release.html (added) +++ deltaspike/site/trunk/content/staging/documentation/steps_for_a_release.html Wed Dec 3 14:26:05 2014 @@ -0,0 +1,506 @@ +<!DOCTYPE html> +<head> +<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> +<meta charset="utf-8"> +<meta name="viewport" content="width=device-width, initial-scale=1.0"> +<meta name="description" content="deltaspike-generate-pages"> +<meta name="author" content="chm"> + +<title>Steps for a Release</title> + +<!-- 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. --> + +<!-- Styles --> + +<link href="https://deltaspike.apache.org/resources/css/bootstrap.css"; rel="stylesheet"> +<link href="https://deltaspike.apache.org/resources/css/bootstrap-responsive.css"; rel="stylesheet"> + +<style type="text/css"> +/* Stylesheet for CodeRay to match GitHub theme | MIT License | http://foundation.zurb.com */ +/*pre.CodeRay {background-color:#f7f7f8;}*/ +.CodeRay .line-numbers{border-right:1px solid #d8d8d8;padding:0 0.5em 0 .25em} +.CodeRay span.line-numbers{display:inline-block;margin-right:.5em;color:rgba(0,0,0,.3)} +.CodeRay .line-numbers strong{font-weight: normal} +table.CodeRay{border-collapse:separate;border-spacing:0;margin-bottom:0;border:0;background:none} +table.CodeRay td{vertical-align: top} +table.CodeRay td.line-numbers{text-align:right} +table.CodeRay td.line-numbers>pre{padding:0;color:rgba(0,0,0,.3)} +table.CodeRay td.code{padding:0 0 0 .5em} +table.CodeRay td.code>pre{padding:0} +.CodeRay .debug{color:#fff !important;background:#000080 !important} +.CodeRay .annotation{color:#007} +.CodeRay .attribute-name{color:#000080} +.CodeRay .attribute-value{color:#700} +.CodeRay .binary{color:#509} +.CodeRay .comment{color:#998;font-style:italic} +.CodeRay .char{color:#04d} +.CodeRay .char .content{color:#04d} +.CodeRay .char .delimiter{color:#039} +.CodeRay .class{color:#458;font-weight:bold} +.CodeRay .complex{color:#a08} +.CodeRay .constant,.CodeRay .predefined-constant{color:#008080} +.CodeRay .color{color:#099} +.CodeRay .class-variable{color:#369} +.CodeRay .decorator{color:#b0b} +.CodeRay .definition{color:#099} +.CodeRay .delimiter{color:#000} +.CodeRay .doc{color:#970} +.CodeRay .doctype{color:#34b} +.CodeRay .doc-string{color:#d42} +.CodeRay .escape{color:#666} +.CodeRay .entity{color:#800} +.CodeRay .error{color:#808} +.CodeRay .exception{color:inherit} +.CodeRay .filename{color:#099} +.CodeRay .function{color:#900;font-weight:bold} +.CodeRay .global-variable{color:#008080} +.CodeRay .hex{color:#058} +.CodeRay .integer,.CodeRay .float{color:#099} +.CodeRay .include{color:#555} +.CodeRay .inline{color:#00} +.CodeRay .inline .inline{background:#ccc} +.CodeRay .inline .inline .inline{background:#bbb} +.CodeRay .inline .inline-delimiter{color:#d14} +.CodeRay .inline-delimiter{color:#d14} +.CodeRay .important{color:#555;font-weight:bold} +.CodeRay .interpreted{color:#b2b} +.CodeRay .instance-variable{color:#008080} +.CodeRay .label{color:#970} +.CodeRay .local-variable{color:#963} +.CodeRay .octal{color:#40e} +.CodeRay .predefined{color:#369} +.CodeRay .preprocessor{color:#579} +.CodeRay .pseudo-class{color:#555} +.CodeRay .directive{font-weight:bold} +.CodeRay .type{font-weight:bold} +.CodeRay .predefined-type{color:inherit} +.CodeRay .reserved,.CodeRay .keyword {color:#000;font-weight:bold} +.CodeRay .key{color:#808} +.CodeRay .key .delimiter{color:#606} +.CodeRay .key .char{color:#80f} +.CodeRay .value{color:#088} +.CodeRay .regexp .delimiter{color:#808} +.CodeRay .regexp .content{color:#808} +.CodeRay .regexp .modifier{color:#808} +.CodeRay .regexp .char{color:#d14} +.CodeRay .regexp .function{color:#404;font-weight:bold} +.CodeRay .string{color:#d20} +.CodeRay .string .string .string{background:#ffd0d0} +.CodeRay .string .content{color:#d14} +.CodeRay .string .char{color:#d14} +.CodeRay .string .delimiter{color:#d14} +.CodeRay .shell{color:#d14} +.CodeRay .shell .delimiter{color:#d14} +.CodeRay .symbol{color:#990073} +.CodeRay .symbol .content{color:#a60} +.CodeRay .symbol .delimiter{color:#630} +.CodeRay .tag{color:#008080} +.CodeRay .tag-special{color:#d70} +.CodeRay .variable{color:#036} +.CodeRay .insert{background:#afa} +.CodeRay .delete{background:#faa} +.CodeRay .change{color:#aaf;background:#007} +.CodeRay .head{color:#f8f;background:#505} +.CodeRay .insert .insert{color:#080} +.CodeRay .delete .delete{color:#800} +.CodeRay .change .change{color:#66f} +.CodeRay .head .head{color:#f4f} +body { + padding-top: 60px; + padding-bottom: 40px; +} +</style> +<script type="text/javascript"> + + var _gaq = _gaq || []; + _gaq.push(['_setAccount', 'UA-36103647-1']); + _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> +</head> + +<body> + + <div class="navbar navbar-fixed-top"> + <div class="navbar-inner"> + <div class="container"> + <a class="btn btn-navbar" data-toggle="collapse" + data-target=".nav-collapse"> <span class="icon-bar"></span> <span + class="icon-bar"></span> <span class="icon-bar"></span> + </a> <a class="brand logocolor" + href="http://deltaspike.apache.org/index.html";>Apache + DeltaSpike</a> + <div class="nav-collapse"> + <ul class="nav"> + <li class="active"><a + href="http://deltaspike.apache.org/index.html";>Home</a></li> + <li><a href="http://deltaspike.apache.org/documentation";>Documentation</a></li> + <li><a href="http://deltaspike.apache.org/javadoc.html";>Javadoc</a></li> + <li><a href="http://deltaspike.apache.org/documentation/source.html";>Source</a></li> + <li><a href="http://deltaspike.apache.org/download.html";>Download</a></li> + <li><a href="http://deltaspike.apache.org/community.html";>Community</a></li> + <!-- <li><a href="./support.html">Support</a></li> --> + <li><a href="http://deltaspike.apache.org/news.html";>News</a></li> + <li><a + href="http://deltaspike.apache.org/migration-guide.html";>Migration</a></li> + </ul> + </div> + <!--/.nav-collapse --> + <form id="search-form" action="http://www.google.com/search"; + method="get" class="navbar-search pull-right"> + <input value="deltaspike.apache.org" name="sitesearch" + type="hidden"> <input class="search-query" name="q" + id="query" type="text"> + </form> + </div> + </div> + </div> + + <div class="container"> + <div class="row"> + <div class="span12"> + <div class="page-title"> + <h1>Steps for a Release</h1> + </div> + + <div id="toc" class="toc"> + <ul class="sectlevel1"> +<li><a href="#_preparations">Preparations</a></li> +<li><a href="#_first_steps">First steps</a></li> +<li><a href="#_vote">Vote</a> +<ul class="sectlevel1"> +<li><a href="#_start_the_vote">Start the vote</a></li> +</ul> +</li> +<li><a href="#_announce_the_vote">Announce the vote</a></li> +<li><a href="#_perform_the_final_release">Perform the final release</a> +<ul class="sectlevel1"> +<li><a href="#_close_the_vote">Close the vote</a></li> +<li><a href="#_upload_artifacts">Upload artifacts</a></li> +<li><a href="#_update_download_links">Update download links</a></li> +<li><a href="#_announce_the_release">Announce the Release</a> +<ul class="sectlevel2"> +<li><a href="#_e_mails">E-Mails</a></li> +<li><a href="#_twitter">Twitter</a></li> +<li><a href="#_news">News</a></li> +</ul> +</li> +</ul> +</li> +</ul> + <hr> + + <div class="sect1"> +<h2 id="_preparations">Preparations</h2> +<div class="sectionbody"> +<div class="ulist"> +<ul> +<li> +<p>Heads up on the mailing-lists</p> +</li> +</ul> +</div> +<div class="paragraph"> +<p>e.g.:</p> +</div> +<div class="listingblock"> +<div class="content"> +<pre>first steps for the next release + +hi @ all, + +if there are no objections, i'll start with the first steps for the next release (review, documentation,...). +it would be great to start with the release procedure next week. + +regards, +[name]</pre> +</div> +</div> +<div class="ulist"> +<ul> +<li> +<p>Check the documentation</p> +</li> +<li> +<p>Check <a href="https://analysis.apache.org/dashboard/index/87921"; class="bare">https://analysis.apache.org/dashboard/index/87921</a></p> +</li> +<li> +<p>Check diff with tag of [version-1]</p> +</li> +<li> +<p>Check the jenkins builds</p> +</li> +<li> +<p>Create release notes and commit them to deltaspike/readme/ (format [ReleaseNotes][version].txt)</p> +</li> +</ul> +</div> +<div class="paragraph"> +<p>test at least:</p> +</div> +<div class="listingblock"> +<div class="content"> +<pre>mvn clean install -POWB +mvn clean install -PWeld +mvn clean install -Prat +mvn clean install -Ptomee-build-managed +mvn clean install -Pjbossas-build-managed-7 +mvn clean install -Pwildfly-build-managed +mvn clean install -Pglassfish-build-managed-3</pre> +</div> +</div> +<div class="paragraph"> +<p>deploy a demo app esp. with jsf-impl-ee6 to an ee6 server and check the logs (if there are no optional ee7+ classes) +(<a href="https://github.com/os890/ee6-ds-demo"; class="bare">https://github.com/os890/ee6-ds-demo</a> can be used for it e.g.)</p> +</div> +</div> +</div> +<div class="sect1"> +<h2 id="_first_steps">First steps</h2> +<div class="sectionbody"> +<div class="listingblock"> +<div class="content"> +<pre>//install a version of git which is compatible with the release-plugin (e.g. v1.8.3.2) +git checkout -b deltaspike-[release version] + +mvn release:prepare -Pdistribution -DreleaseProfiles=distribution + +//hint: don't use -DdryRun=true -- since it can break the next step +mvn release:perform -Pdistribution -DreleaseProfiles=distribution + +//!!!check the created commits including user-name and email + +//login to https://repository.apache.org/ and go to "Staging Repositories" +//check esp. .../org/apache/deltaspike/deltaspike-project/[version]/deltaspike-project-[version]-source-release.zip +//close the repository + +//push the release-branch and tag to a 3rd party git repo +git remote add vote https://github.com/[user]/deltaspike-vote +git push -u vote master +git push vote deltaspike-[release version] +git push vote --tags</pre> +</div> +</div> +</div> +</div> +<h1 id="_vote" class="sect0">Vote</h1> +<div class="sect1"> +<h2 id="_start_the_vote">Start the vote</h2> +<div class="sectionbody"> +<div class="paragraph"> +<p>e.g.:</p> +</div> +<div class="listingblock"> +<div class="content"> +<pre>[VOTE] Release of Apache DeltaSpike [version] + + +Hi, + +I was running the needed tasks to get the ... release of Apache DeltaSpike out. +The artifacts are deployed to Nexus [1] (and [2]). + +The tag is available at [3] and will get pushed to the ASF repository once the vote passed. + +Please take a look at the ... artifacts and vote! + +Please note: +This vote is "majority approval" with a minimum of three +1 votes (see [4]). + +------------------------------------------------ +[ ] +1 for community members who have reviewed the bits +[ ] +0 +[ ] -1 for fatal flaws that should cause these bits not to be released, and why.............. +------------------------------------------------ + +Thanks, +[name] + +[1] https://repository.apache.org/content/repositories/... +[2] https://repository.apache.org/content/repositories/.../org/apache/deltaspike/deltaspike-project/[version]/deltaspike-project-[version]-source-release.zip +[3] https://github.com/[user]/deltaspike-vote/tree/deltaspike-project-[version] +[4] http://www.apache.org/foundation/voting.html#ReleaseVotes</pre> +</div> +</div> +</div> +</div> +<h1 id="_announce_the_vote" class="sect0">Announce the vote</h1> +<div class="ulist"> +<ul> +<li> +<p>Create a link to the release notes at <a href="http://s.apache.org"; class="bare">http://s.apache.org</a> (format DeltaSpike_[version])</p> +</li> +<li> +<p>Tweet about the vote via @DeltaSpikeTeam.</p> +</li> +</ul> +</div> +<h1 id="_perform_the_final_release" class="sect0">Perform the final release</h1> +<div class="sect1"> +<h2 id="_close_the_vote">Close the vote</h2> +<div class="sectionbody"> +<div class="paragraph"> +<p>After 72 hours close the vote.</p> +</div> +<div class="paragraph"> +<p>e.g.:</p> +</div> +<div class="listingblock"> +<div class="content"> +<pre>Result (was: Re: [VOTE] Release of Apache DeltaSpike [version]) + +thank you for voting! + +X binding +1 votes (pmc): +[list] + +Y non-binding +1 votes: +[list] + +Z -1 votes +[list]</pre> +</div> +</div> +<div class="paragraph"> +<p>If the binding majority approved the vote continue.</p> +</div> +<div class="ulist"> +<ul> +<li> +<p>Login to <a href="https://repository.apache.org/"; class="bare">https://repository.apache.org/</a> and release the repository</p> +</li> +<li> +<p>Merge release branch into master and push the branch and tag to the ASF repository</p> +</li> +</ul> +</div> +<div class="paragraph"> +<p>Always do a merge in this case (not a rebase):</p> +</div> +<div class="listingblock"> +<div class="content"> +<pre>git checkout master +git merge deltaspike-[version] +git push origin deltaspike-[version] +git push origin deltaspike-project-[version] +git push origin master</pre> +</div> +</div> +<div class="ulist"> +<ul> +<li> +<p>Create the release at jira</p> +</li> +<li> +<p>Close the corresponding tickets of the version</p> +</li> +<li> +<p>Wait some hours and check <a href="http://repo2.maven.org/maven2/org/apache/deltaspike"; class="bare">http://repo2.maven.org/maven2/org/apache/deltaspike</a></p> +</li> +</ul> +</div> +</div> +</div> +<div class="sect1"> +<h2 id="_upload_artifacts">Upload artifacts</h2> +<div class="sectionbody"> +<div class="listingblock"> +<div class="content"> +<pre>svn co https://dist.apache.org/repos/dist/release/deltaspike +mkdir [version] +//add and commit the artifacts (at least *source-release.zip + asc, md5, sha1)</pre> +</div> +</div> +</div> +</div> +<div class="sect1"> +<h2 id="_update_download_links">Update download links</h2> +<div class="sectionbody"> +<div class="paragraph"> +<p>/deltaspike/site/trunk/content/download.mdtext</p> +</div> +</div> +</div> +<div class="sect1"> +<h2 id="_announce_the_release">Announce the Release</h2> +<div class="sectionbody"> +<div class="sect2"> +<h3 id="_e_mails">E-Mails</h3> +<div class="listingblock"> +<div class="content"> +<pre>[ANNOUNCE] Release of Apache DeltaSpike [version] + +The Apache DeltaSpike team is pleased to announce the 6th release of DeltaSpike. + +Apache DeltaSpike is not a CDI-container, but a portable CDI extension. + +Documentation: +http://deltaspike.apache.org/documentation.html + +Download: +http://deltaspike.apache.org/download.html + +Release Notes: +http://s.apache.org/DeltaSpike_06 + +Enjoy! + +[name]</pre> +</div> +</div> +<div class="paragraph"> +<p>Write the e-mails to:</p> +</div> +<div class="ulist"> +<ul> +<li> +<p><a href="mailto:[email protected]";>[email protected]</a></p> +</li> +<li> +<p><a href="mailto:[email protected]";>[email protected]</a></p> +</li> +<li> +<p><a href="mailto:[email protected]";>[email protected]</a></p> +</li> +</ul> +</div> +</div> +<div class="sect2"> +<h3 id="_twitter">Twitter</h3> +<div class="paragraph"> +<p>e.g.:</p> +</div> +<div class="listingblock"> +<div class="content"> +<pre>[ANNOUNCE] The Apache #DeltaSpike team is pleased to announce http://s.apache.org/DeltaSpike_[version]. Feel free to test it! Feedback is very welcome!</pre> +</div> +</div> +</div> +<div class="sect2"> +<h3 id="_news">News</h3> +<div class="paragraph"> +<p>Add the release to <a href="http://deltaspike.apache.org/news.html"; class="bare">http://deltaspike.apache.org/news.html</a></p> +</div> +</div> +</div> +</div> + </div> + + <hr> + + <footer> + <p>Copyright © 2011-2014 The Apache Software Foundation, Licensed under the Apache License, Version 2.0.</p> + <p>Apache and the Apache feather logo are trademarks of The Apache Software Foundation.</p> + </footer> + + </div> + <!-- /.container --> + +</body> +</html> \ No newline at end of file
