Repository: incubator-hivemall-site Updated Branches: refs/heads/asf-site 5aea172d3 -> ff2b380fe
Updated release guide Project: http://git-wip-us.apache.org/repos/asf/incubator-hivemall-site/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-hivemall-site/commit/ff2b380f Tree: http://git-wip-us.apache.org/repos/asf/incubator-hivemall-site/tree/ff2b380f Diff: http://git-wip-us.apache.org/repos/asf/incubator-hivemall-site/diff/ff2b380f Branch: refs/heads/asf-site Commit: ff2b380febf83a0fed88d74e3741979bd5d7d415 Parents: 5aea172 Author: Makoto Yui <[email protected]> Authored: Wed Feb 14 16:47:35 2018 +0900 Committer: Makoto Yui <[email protected]> Committed: Wed Feb 14 16:47:35 2018 +0900 ---------------------------------------------------------------------- release-guide.html | 112 +++++++++++++++++------- release-setup.html | 2 +- verify_howto.html | 228 ++++++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 308 insertions(+), 34 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-hivemall-site/blob/ff2b380f/release-guide.html ---------------------------------------------------------------------- diff --git a/release-guide.html b/release-guide.html index 0a47c00..f3e48c4 100644 --- a/release-guide.html +++ b/release-guide.html @@ -84,7 +84,7 @@ <div id="breadcrumbs"> <ul class="breadcrumb"> - <li id="publishDate">Last Published: 2018-01-25<span class="divider">|</span> + <li id="publishDate">Last Published: 2018-02-14<span class="divider">|</span> </li> <li id="projectVersion">Version: 0.5.0-incubating-SNAPSHOT</li> </ul> @@ -170,8 +170,6 @@ git pull # or, git reset --hard asf/master <div class="source"> <div class="source"><pre class="prettyprint">version=X.Y.Z -# RC should start at 1 and increment if early release candidates fail to release -rc=1 # echo "${version}-incubating-SNAPSHOT" ./bin/set_version.sh --pom --version "${version}-incubating-SNAPSHOT" @@ -191,14 +189,15 @@ rc=1 next_version=X.(Y+1).Z # Confirm that version and rc is defined. -echo "Release version: ${version}-incubating-rc${rc}" +echo "Release version: ${version}-incubating" echo "Development version: ${next_version}-incubating-SNAPSHOT" mvn -Papache-release release:prepare \ -DautoVersionSubmodules=true -DdryRun=true \ -Darguments='-Dmaven.test.skip.exec=true' -DskipTests=true -Dmaven.test.skip=true \ - -Dtag=v${version}-rc${rc} -DreleaseVersion=${version}-incubating-rc${rc} -DdevelopmentVersion=${next_version}-incubating-SNAPSHOT -</pre></div></div></div> + -Dtag=v${version}-rc${rc} -DreleaseVersion=${version}-incubating -DdevelopmentVersion=${next_version}-incubating-SNAPSHOT +</pre></div></div> +<p><b>Note:</b> <tt>-rcX</tt> is only used for git tag. Release candidates do NOT have <tt>-rcX</tt> for artifact versions in pom. Release candidates are just for voting.</p></div> <div class="section"> <h3><a name="PUBLISH_A_SNAPSHOT"></a>PUBLISH A SNAPSHOT</h3> @@ -242,17 +241,17 @@ rc=1 next_version=X.(Y+1).Z # Confirm that version and rc is defined. -echo ${version}-incubating-rc${rc} -# X.Y.Z-incubating-rc1 +echo "${version}-incubating (Release Candidates ${rc})" +# 0.5.0-incubating (Release Candidates 3) </pre></div></div> <p><b>2)</b> Update version strings in source codes.</p> <div class="source"> -<div class="source"><pre class="prettyprint">./bin/set_version.sh --version "${version}-incubating-rc${rc}" +<div class="source"><pre class="prettyprint">./bin/set_version.sh --version "${version}-incubating" # Check list of files to be committed. -git stauts -git commit -a -m "Bumped version string to ${version}-incubating-rc${rc}" +git status +git commit -a -m "Bumped version string to ${version}-incubating" </pre></div></div> <p><b>3)</b> Prepare sets the version numbers in POM and creates a tag.</p> @@ -260,7 +259,7 @@ git commit -a -m "Bumped version string to ${version}-incubating-rc${rc}&qu <div class="source"><pre class="prettyprint">mvn -Papache-release release:clean release:prepare \ -DautoVersionSubmodules=true -DdryRun=false \ -Darguments='-Dmaven.test.skip.exec=true' -DskipTests=true -Dmaven.test.skip=true \ - -Dtag=v${version}-rc${rc} -DreleaseVersion=${version}-incubating-rc${rc} -DdevelopmentVersion=${next_version}-incubating-SNAPSHOT + -Dtag=v${version}-rc${rc} -DreleaseVersion=${version}-incubating -DdevelopmentVersion=${next_version}-incubating-SNAPSHOT </pre></div></div> <p><b>4)</b> Update version strings for the development iteration</p> @@ -356,7 +355,10 @@ cd hivemall # Download release artifacts wget -e robots=off --no-check-certificate \ -r -np --reject=html,txt,tmp -nH --cut-dirs=7 \ - https://repository.apache.org/content/repositories/orgapachehivemall-1001/org/apache/hivemall/hivemall/${version}-incubating-rc${rc}/ + https://repository.apache.org/content/repositories/orgapachehivemall-1001/org/apache/hivemall/hivemall/${version}-incubating/ + +# Rename directory for RC +mv ${version}-incubating ${version}-incubating-rc${rc} # Put ChangeLog cd ${version}-incubating-rc${rc} @@ -390,16 +392,16 @@ svn commit -m "Put hivemall version ${version}-incubating-rc${rc} artifacts </ul></div></div> <div class="section"> <h2><a name="PPMC_voting"></a>PPMC voting</h2> -<p>Create a VOTE email thread on <tt>[email protected]</tt> to record votes as replies.</p> +<p>Create a VOTE email thread on <a class="externalLink" href="mailto:[email protected]";>[email protected]</a> to record votes as replies.</p> <div class="source"> <div class="source"><pre class="prettyprint">To: [email protected] CC: [email protected] -Subject: [VOTE] Apache Hivemall <release version> Release +Subject: [VOTE] Release Apache Hivemall (Incubating) v0.5.0 Release Candidate #3 Hi all, -Apache Hivmeall 0.5.0 release candidate #1 (the first Apache release!) is now available for a vote within dev community. +Apache Hivmeall 0.5.0 release candidate #1 is now available for a vote within dev community. Links to various release artifacts are given below. Please review and cast your vote. @@ -418,12 +420,16 @@ Links to various release artifacts are given below. Please review and cast your - For information about the contents of this release, see: https://dist.apache.org/repos/dist/dev/incubator/hivemall/0.5.0-incubating-rc1/ChangeLog.html -You can find Podling releases policies in - https://incubator.apache.org/policy/incubation.html#releases - http://www.apache.org/legal/release-policy.html +Find Podling releases policies in + https://incubator.apache.org/policy/incubation.html#releases + http://www.apache.org/legal/release-policy.html + +Artifacts verification how-to can be found in + http://hivemall.incubator.apache.org/verify_artifacts.html The vote will be open for at least 72 hours and until necessary number of votes are reached. -At lease three +1 from PPMC members are required and we welcome your vote. + +At lease three +1 from PPMC members are required and we welcome your vote! [ ] +1 approve (Release this package as Apache Hivemall 0.5.0-incubating-rc1) [ ] +0 no opinion @@ -431,47 +437,87 @@ At lease three +1 from PPMC members are required and we welcome your vote. Here is my +1 (binding). +Regards, +Makoto +</pre></div></div> +<p>Once 72 hours has passed (which is generally preferred) and/or at least three +1 (binding) votes have been cast with no -1 (binding) votes, send an email closing the vote and pronouncing the release candidate a success.</p> + +<div class="source"> +<div class="source"><pre class="prettyprint">To: [email protected] +Subject: [RESULT][VOTE]: Release Apache Hivemall (Incubating) <release version> + +Hi all, + +The Apache Hivemall <release version> vote is now closed and has passed as follows: + +From PPMC members: ++1 myui (Makoto) ++1 maropu (Takeshi) ++1 lewuathe (Kai) ++1 takuti (Takuya) ++1 ozawa (Tsuyoshi) + +From Mentors: ++1 daniel (IPMC) + +Other non-binding votes: ++1 Kento (committer) + +I will send a vote mail to incubator-general mail list to collect three IPMC +1's votes. +https://incubator.apache.org/policy/incubation.html#releases. + +If voting succeeds, v0.5.0 will be released based on v0.5.0-rc2 with removing rc2. + +Thanks all of the voters. + Thanks, Makoto +on behalf of Apache Hivemall PPMC </pre></div></div></div> <div class="section"> <h2><a name="IPMC_Voting"></a>IPMC Voting</h2> -<p>What if vote succeed, then vote in <tt>[email protected]</tt>.</p> +<p>What if vote succeed, then vote in <a class="externalLink" href="mailto:[email protected]";>[email protected]</a>. Three +1 Incubator PMC votes are required as described in <a class="externalLink" href="https://incubator.apache.org/policy/incubation.html#releases";>this page</a>.</p> <div class="source"> <div class="source"><pre class="prettyprint">To: [email protected] -Subject: [VOTE] Apache Hivemall <release version> Release +Subject: [VOTE] Release Apache Hivemall (Incubating) v0.5.0-RC2 Hi all, -The Apache Hivemall community has voted on and approved a proposal to release Apache Hivemall 0.5.0-rc1 (the first Apache release). Apache Hivemall is a library for machine learning for Apache Hive/Spark/Pig, incubating since 2016-09-13. +The Apache Hivemall community has approved a proposal to release Apache Hivemall v0.5.0 by v0.5.0-RC2. We now kindly request that the Incubator PMC members review and vote on this incubator release candidate. The PPMC vote thread is located here: - <link to the dev voting thread> + https://www.mail-archive.com/[email protected]/msg00450.html (vote) + https://www.mail-archive.com/[email protected]/msg00460.html (vote result) Links to various release artifacts are given below. - The source tarball, including signatures, digests, ChangeLog, etc.: - https://dist.apache.org/repos/dist/dev/incubator/hivemall/0.5.0-incubating-rc1/ - - KEYS file for verification: - https://dist.apache.org/repos/dist/dev/incubator/hivemall/KEYS + https://dist.apache.org/repos/dist/dev/incubator/hivemall/0.5.0-incubating-rc2/ + - Sources for the release: + https://dist.apache.org/repos/dist/dev/incubator/hivemall/0.5.0-incubating-rc2/hivemall-0.5.0-incubating-rc2-source-release.zip - Git tag for the release: - https://git-wip-us.apache.org/repos/asf?p=incubator-hivemall.git;a=shortlog;h=refs/tags/v0.5.0-rc1 + https://git-wip-us.apache.org/repos/asf?p=incubator-hivemall.git;a=shortlog;h=refs/tags/v0.5.0-rc2 - The Nexus Staging URL: - https://repository.apache.org/content/repositories/orgapachehivemall-1001/ + https://repository.apache.org/content/repositories/orgapachehivemall-1002/ + - KEYS file for verification: + https://dist.apache.org/repos/dist/dev/incubator/hivemall/KEYS - For information about the contents of this release, see: - https://dist.apache.org/repos/dist/dev/incubator/hivemall/0.5.0-incubating-rc1/ChangeLog.html + https://dist.apache.org/repos/dist/dev/incubator/hivemall/0.5.0-incubating-rc2/ChangeLog.html + +Artifacts verification how-to can be found in + http://hivemall.incubator.apache.org/verify_artifacts.html Please vote accordingly: -[ ] +1 approve (Release this package as Apache Hivemall 0.5.0-incubating-rc1) +[ ] +1 approve [ ] -1 disapprove (and reason why) The vote will be open for at least 72 hours. -Thanks, +Regards, Makoto on behalf of Apache Hivemall PPMC </pre></div></div> @@ -479,7 +525,7 @@ on behalf of Apache Hivemall PPMC <div class="source"> <div class="source"><pre class="prettyprint">To: [email protected] -Subject: [RESULT][VOTE]: Apache Hivemall <release version> Release +Subject: [RESULT][VOTE]: Release Apache Hivemall (Incubating) <release version> Hi all, http://git-wip-us.apache.org/repos/asf/incubator-hivemall-site/blob/ff2b380f/release-setup.html ---------------------------------------------------------------------- diff --git a/release-setup.html b/release-setup.html index d83d7f2..c1de50b 100644 --- a/release-setup.html +++ b/release-setup.html @@ -84,7 +84,7 @@ <div id="breadcrumbs"> <ul class="breadcrumb"> - <li id="publishDate">Last Published: 2018-01-25<span class="divider">|</span> + <li id="publishDate">Last Published: 2018-02-14<span class="divider">|</span> </li> <li id="projectVersion">Version: 0.5.0-incubating-SNAPSHOT</li> </ul> http://git-wip-us.apache.org/repos/asf/incubator-hivemall-site/blob/ff2b380f/verify_howto.html ---------------------------------------------------------------------- diff --git a/verify_howto.html b/verify_howto.html new file mode 100644 index 0000000..ae6a2b8 --- /dev/null +++ b/verify_howto.html @@ -0,0 +1,228 @@ +<!DOCTYPE html> +<!-- + | Generated by Apache Maven Doxia Site Renderer 1.7.1 + | Rendered using Apache Maven Fluido Skin 1.6 +--> +<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en"> + <head> + <meta charset="UTF-8" /> + <meta name="viewport" content="width=device-width, initial-scale=1.0" /> + <meta http-equiv="Content-Language" content="en" /> + <title>Apache Hivemall – 1. Preparation</title> + <link rel="stylesheet" href="./css/apache-maven-fluido-1.6.min.css" /> + <link rel="stylesheet" href="./css/site.css" /> + <link rel="stylesheet" href="./css/print.css" media="print" /> + <script type="text/javascript" src="./js/apache-maven-fluido-1.6.min.js"></script> + </head> + <body class="topBarEnabled"> + <a href="https://github.com/apache/incubator-hivemall";> + <img style="position: absolute; top: 0; right: 0; border: 0; z-index: 10000;" + src="https://s3.amazonaws.com/github/ribbons/forkme_right_red_aa0000.png"; + alt="Fork me on GitHub"> + </a> + <div id="topbar" class="navbar navbar-fixed-top navbar-inverse"> + <div class="navbar-inner"> + <div class="container"><div class="nav-collapse"> + <ul class="nav"> + <li class="dropdown"> + <a href="#" class="dropdown-toggle" data-toggle="dropdown">Project <b class="caret"></b></a> + <ul class="dropdown-menu"> + <li><a href="index.html" title="Home">Home</a></li> + <li><a href="download.html" title="Download">Download</a></li> + <li><a href="license.html" title="Licenses">Licenses</a></li> + <li><a href="team-list.html" title="Team">Team</a></li> + <li><a href="poweredby.html" title="Powered By">Powered By</a></li> + <li><a href="http://incubator.apache.org/projects/hivemall.html"; title="Incubation Status">Incubation Status</a></li> + </ul> + </li> + <li class="dropdown"> + <a href="#" class="dropdown-toggle" data-toggle="dropdown">Documentation <b class="caret"></b></a> + <ul class="dropdown-menu"> + <li><a href="userguide/index.html" title="User Guide">User Guide</a></li> + <li><a href="overview.html" title="Overview">Overview</a></li> + <li><a href="https://cwiki.apache.org/confluence/display/HIVEMALL"; target="_blank" title="Wiki">Wiki</a></li> + <li><a href="faq.html" title="FAQ">FAQ</a></li> + </ul> + </li> + <li class="dropdown"> + <a href="#" class="dropdown-toggle" data-toggle="dropdown">Get Involved <b class="caret"></b></a> + <ul class="dropdown-menu"> + <li><a href="mail-lists.html" title="Mailing Lists">Mailing Lists</a></li> + <li><a href="https://issues.apache.org/jira/browse/HIVEMALL"; target="_blank" title="Issues (Jira)">Issues (Jira)</a></li> + <li><a href="repository.html" title="Source (Git)">Source (Git)</a></li> + <li><a href="https://travis-ci.org/apache/incubator-hivemall"; target="_blank" title="Travis CI">Travis CI</a></li> + <li><a href="contributing.html" title="Contributing">Contributing</a></li> + <li><a href="release-guide.html" title="Release Guide">Release Guide</a></li> + </ul> + </li> + <li class="dropdown"> + <a href="#" class="dropdown-toggle" data-toggle="dropdown">ASF <b class="caret"></b></a> + <ul class="dropdown-menu"> + <li><a href="http://www.apache.org/foundation/how-it-works.html"; target="_blank" title="How Apache Works">How Apache Works</a></li> + <li><a href="http://www.apache.org/foundation/"; target="_blank" title="Foundation">Foundation</a></li> + <li><a href="http://www.apache.org/foundation/sponsorship.html"; target="_blank" title="Sponsoring Apache">Sponsoring Apache</a></li> + <li><a href="http://www.apache.org/foundation/thanks.html"; target="_blank" title="Thanks">Thanks</a></li> + </ul> + </li> + </ul> + <ul class="nav pull-right"><li> + <a href="https://twitter.com/ApacheHivemall"; class="twitter-follow-button" data-show-count="false" data-align="right" data-size="large" data-show-screen-name="true" data-lang="en">Follow ApacheHivemall</a> + <script type="text/javascript">!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src="//platform.twitter.com/widgets.js";fjs.parentNode.insertBefore(js,fjs);}}(document,"script","twitter-wjs");</script> + </li></ul> + </div> + </div> + </div> + </div> + <div class="container"> + <div id="banner"> + <div class="pull-left"><div id="bannerLeft"><h2>Apache Hivemall</h2> +</div> +</div> + <div class="pull-right"></div> + <div class="clear"><hr/></div> + </div> + + <div id="breadcrumbs"> + <ul class="breadcrumb"> + <li id="publishDate">Last Published: 2018-02-14<span class="divider">|</span> +</li> + <li id="projectVersion">Version: 0.5.0-incubating-SNAPSHOT</li> + </ul> + </div> + <div id="bodyColumn" > +<!-- + 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. +--> +<!-- toc --><h1>1. Preparation</h1> +<div class="section"> +<h2><a name="Install_required_softwares"></a>Install required softwares</h2> +<p>GPG and Maven, JDK 7 is mandatory for verification.</p> + +<div class="source"> +<div class="source"><pre class="prettyprint">brew install gpg gpg-agent pinentry-mac +brew install maven +brew install md5sha1sum +</pre></div></div></div> +<div class="section"> +<h2><a name="Import_GPG_KEYS"></a>Import GPG KEYS</h2> + +<div class="source"> +<div class="source"><pre class="prettyprint"># Download GPG KEYS +wget https://dist.apache.org/repos/dist/dev/incubator/hivemall/KEYS + +# import KEYS for GPG verification +gpg --import KEYS +</pre></div></div> +<h1>2. Download all release artifacts</h1> + +<div class="source"> +<div class="source"><pre class="prettyprint">VERSION=0.5.0 +RC_NUMBER=3 + +wget -e robots=off --no-check-certificate \ + -r -np --reject=html,txt,tmp -nH --cut-dirs=5 \ + https://dist.apache.org/repos/dist/dev/incubator/hivemall/${VERSION}-incubating-rc${RC_NUMBER}/ +</pre></div></div> +<h1>3. Verify SHA1, MD5, and GPG signatures.</h1> + +<div class="source"> +<div class="source"><pre class="prettyprint">cd ${VERSION}-incubating-rc${RC_NUMBER}/ + +for f in `find . -type f -iname '*.sha1'`; do + echo -n "Verifying ${f%.*} ... " + sha1sum ${f%.*} | cut -f1 -d' ' | diff -Bw - ${f} + if [ $? -eq 0 ]; then + echo 'Valid' + else + echo "SHA1 is Invalid: ${f}" >&2 + exit 1 + fi +done +echo +for f in `find . -type f -iname '*.md5'`; do + echo -n "Verifying ${f%.*} ... " + md5sum ${f%.*} | cut -f1 -d' ' | diff -Bw - ${f} + if [ $? -eq 0 ]; then + echo 'Valid' + else + echo "MD5 is Invalid: ${f%.*}" >&2 + exit 1 + fi +done +echo +for f in `find . -type f -iname '*.asc'`; do + gpg --verify ${f} + if [ $? -eq 0 ]; then + echo "GPG signature is correct: ${f%.*}" + else + echo "GPG signature is Invalid: ${f%.*}" >&2 + exit 1 + fi + echo +done +</pre></div></div> +<h1>4. Build, Test, and Verify source</h1> + +<div class="source"> +<div class="source"><pre class="prettyprint">unzip hivemall-${VERSION}-incubating-source-release.zip +cd hivemall-${VERSION}-incubating + +# workaround for Maven sign-release-artifacts plugin +export GPG_TTY=$(tty) + +# JDK 7 is required for packaging +export JAVA_HOME=`/usr/libexec/java_home -v 1.7` + +# Java 8 is required for building Spark 2.2 module +export JAVA8_HOME=`/usr/libexec/java_home -v 1.8` + +# Try to create artifacts +export MAVEN_OPTS=-XX:MaxPermSize=256m + +# Try to create artifacts +# RAT license check and unit tests will be issued +mvn -Papache-release clean install + +# Verify Signatures of Release Artifacts +cd target/ +for file in `find . -type f -iname '*.asc'`; do + gpg --verify ${file} +done +</pre></div></div></div> + </div> + </div> + <hr/> + <footer> + <div class="container"> + <div class="row"> +<p> + <small> + Apache Hivemall is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by <a href="http://incubator.apache.org/";>the Apache Incubator</a>. + Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, + and decision making process have stabilized in a manner consistent with other successful ASF projects. + While incubation status is not necessarily a reflection of the completeness or stability of the code, + it does indicate that the project has yet to be fully endorsed by the ASF. + </small> + </p> + </div> + <p id="poweredBy" class="pull-right"> <a href="http://incubator.apache.org/projects/hivemall.html"; title="Apache Incubator" class="builtBy"><img class="builtBy" alt="Apache Incubator" src="http://incubator.apache.org/images/egg-logo.png"; /></a> + </p> + </div> + </footer> + </body> +</html>
![https://s3.amazonaws.com/github/ribbons/forkme_right_red_aa0000.png"](https://s3.amazonaws.com/github/ribbons/forkme_right_red_aa0000.png"){kind=link}
![http://incubator.apache.org/images/egg-logo.png"](http://incubator.apache.org/images/egg-logo.png"){kind=link}