blob: eb4808fefda9c4082dc27cccadb0e97fdd8218f3 [file] [log] [blame]
<!doctype html>
<!--
Minimal Mistakes Jekyll Theme 4.4.1 by Michael Rose
Copyright 2017 Michael Rose - mademistakes.com | @mmistakes
Free for personal and commercial use under the MIT license
https://github.com/mmistakes/minimal-mistakes/blob/master/LICENSE.txt
-->
<html lang="en" class="no-js">
<head>
<meta charset="utf-8">
<!-- begin SEO -->
<title>Release verification guide for ServiceComb - Apache ServiceComb</title>
<meta name="description" content="How to verify Apache Release">
<meta name="author" content="Yangyong Zheng">
<meta property="og:locale" content="en">
<meta property="og:site_name" content="Apache ServiceComb">
<meta property="og:title" content="Release verification guide for ServiceComb">
<link rel="canonical" href="https://github.com/pages/apache/incubator-servicecomb-website/developers/release-validation-guide/">
<meta property="og:url" content="https://github.com/pages/apache/incubator-servicecomb-website/developers/release-validation-guide/">
<meta property="og:description" content="How to verify Apache Release">
<meta name="twitter:site" content="@ServiceComb">
<meta name="twitter:title" content="Release verification guide for ServiceComb">
<meta name="twitter:description" content="How to verify Apache Release">
<meta name="twitter:url" content="">
<meta name="twitter:card" content="summary">
<meta name="twitter:creator" content="@">
<script type="application/ld+json">
{
"@context" : "http://schema.org",
"@type" : "Person",
"name" : "Apache ServiceComb",
"url" : "https://github.com/pages/apache/incubator-servicecomb-website",
"sameAs" : null
}
</script>
<meta name="google-site-verification" content="HvJjNd7vvJ-yjSTHlBiIWEYxp_Hrz-PYEY5Idz9LRcA" />
<!-- end SEO -->
<link href="/feed.xml" type="application/atom+xml" rel="alternate" title="Apache ServiceComb Feed">
<!-- http://t.co/dKP3o1e -->
<meta name="HandheldFriendly" content="True">
<meta name="MobileOptimized" content="320">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<script>
document.documentElement.className = document.documentElement.className.replace(/\bno-js\b/g, '') + ' js ';
</script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/clipboard.js/1.7.1/clipboard.min.js"></script>
<script src="/assets/vendor/prism/prism.js"></script>
<script type="text/javascript" async
src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-MML-AM_CHTML">
</script>
<link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/4.0.0-beta/css/bootstrap.min.css" integrity="sha384-/Y6pD6FV/Vv2HJnA6t+vslU6fwYXjCFtcEpHbNJ0lyAFsXTsjBbfaDjzALeQsN6M" crossorigin="anonymous">
<script src="https://code.jquery.com/jquery-3.2.1.slim.min.js" integrity="sha384-KJ3o2DKtIkvYIK3UENzmM7KCkRr/rE9/Qpg6aAZGJwFDMVNA/GpGFF93hXpG5KkN" crossorigin="anonymous"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.11.0/umd/popper.min.js" integrity="sha384-b/U6ypiBEHpOf/4+1nzFpr53nxSS+GLCkfwBdFNTxtclqqenISfwAzpKaMNFNmj4" crossorigin="anonymous"></script>
<script src="https://maxcdn.bootstrapcdn.com/bootstrap/4.0.0-beta/js/bootstrap.min.js" integrity="sha384-h0AbiXch4ZDo7tp9hKZ4TsHbi047NrKGLO3SEJAg45jXxnGIfYzk4Si90RDIqNm1" crossorigin="anonymous"></script>
<!-- For all browsers -->
<link rel="stylesheet" href="/assets/css/main.css?v=1">
<link rel="stylesheet" href="/assets/vendor/prism/prism.css?v=1">
<!--[if lte IE 9]>
<style>
/* old IE unsupported flexbox fixes */
.greedy-nav .site-title {
padding-right: 3em;
}
.greedy-nav button {
position: absolute;
top: 0;
right: 0;
height: 100%;
}
</style>
<![endif]-->
<meta http-equiv="cleartype" content="on">
<!-- start custom head snippets -->
<!-- insert favicons. use http://realfavicongenerator.net/ -->
<link href="https://fonts.cat.net/css?family=Roboto:400,500,700|Source+Code+Pro" rel="stylesheet">
<script src="/assets/js/custom.js"></script>
<!-- end custom head snippets -->
</head>
<body class="layout--single">
<!--[if lt IE 9]>
<div class="notice--danger align-center" style="margin: 0;">You are using an <strong>outdated</strong> browser. Please <a href="http://browsehappy.com/">upgrade your browser</a> to improve your experience.</div>
<![endif]-->
<div class="masthead" onmouseleave="$('#childrenShow').css('display', 'none')">
<div class="masthead__inner-wrap">
<div class="masthead__menu">
<nav id="site-nav" class="greedy-nav">
<a class="site-title active" href="/"><img src="https://www.apache.org/img/servicecomb.png"></a>
<ul class="visible-links">
<li class="masthead__menu-item" onmouseenter="$('#childrenShow').css('display', 'none')">
<a href="/">Home</a>
</li>
<li class="masthead__menu-item" onmouseenter="$('#childrenShow').css('display', 'none')">
<a href="/developers/">Projects</a>
</li>
<li class="def-nav-li" onmouseenter="$('#childrenShow').css('display', 'block')">
<a href="/docs/users/">Documentation</a>
<ul id="childrenShow" class="def-children-show-en" onmouseleave="$('#childrenShow').css('display', 'none')">
<li><a href="/docs/getting-started/" class="">Getting started</a></li>
<li><a href="/docs/users/" class="">Docs</a></li>
<li><a href="/slides/" class="">Video</a></li>
<li><a href="/faqs/" class="">FAQ</a></li>
</ul>
</li>
<li class="masthead__menu-item" onmouseenter="$('#childrenShow').css('display', 'none')">
<a class="active" href="/developers/contributing">Community</a>
</li>
<li class="masthead__menu-item" onmouseenter="$('#childrenShow').css('display', 'none')">
<a href="/year-archive/">Blogs</a>
</li>
<li class="masthead__menu-item" onmouseenter="$('#childrenShow').css('display', 'none')">
<a class="active" href="/release/">Downloads</a>
</li>
</ul>
<button><div class="navicon"></div></button>
<ul class="hidden-links hidden"></ul>
<div class="nav-lang">
<a href=/cn/developers/release-validation-guide/>中文</a>
</div>
</nav>
</div>
</div>
</div>
<div id="main" role="main">
<div class="sidebar sticky">
<div class="back-to-home"><a href="/">Home</a> > Release verification guide for ServiceComb</div>
<nav class="nav__list">
<input id="ac-toc" name="accordion-toc" type="checkbox" />
<label for="ac-toc">Toggle Menu</label>
<ul class="nav__items">
<li>
<a href="/developers/"><span class="nav__sub-title nav__sub-title-with-url">Projects</span></a>
</li>
<li>
<a href="/developers/team/"><span class="nav__sub-title nav__sub-title-with-url">Team</span></a>
</li>
<li>
<a href="/developers/contributing"><span class="nav__sub-title nav__sub-title-with-url">Contributing to Apache ServiceComb</span></a>
</li>
<li>
<a href="/developers/becomming-a-commiter"><span class="nav__sub-title nav__sub-title-with-url">Becoming A Committer of Apache ServiceComb</span></a>
</li>
<li>
<a href="/developers/setup-develop-environment/"><span class="nav__sub-title nav__sub-title-with-url">Develop Environment Setup</span></a>
</li>
<li>
<a href="/developers/submit-codes/"><span class="nav__sub-title nav__sub-title-with-url">Code Submit Guide</span></a>
</li>
<li>
<a href="/developers/use-jira/"><span class="nav__sub-title nav__sub-title-with-url">How to Use JIRA</span></a>
</li>
<li>
<a href="/developers/setup-committer-rights/"><span class="nav__sub-title nav__sub-title-with-url">Set Up Write Access for Committer</span></a>
</li>
<li>
<a href="/developers/release-guide/"><span class="nav__sub-title nav__sub-title-with-url">How to Release in Apache</span></a>
</li>
<li>
<a href="/developers/release-validation-guide/"><span class="nav__sub-title nav__sub-title-with-url">How to verify Apache Release</span></a>
</li>
<li>
<a href="/developers/sonarcloud-how-to/"><span class="nav__sub-title nav__sub-title-with-url">How to Use SonarCloud</span></a>
</li>
</ul>
</nav>
</div>
<article class="page" itemscope itemtype="http://schema.org/CreativeWork">
<meta itemprop="headline" content="Release verification guide for ServiceComb">
<meta itemprop="description" content="How to verify Apache Release">
<meta itemprop="dateModified" content="June 12, 2018">
<div class="page__inner-wrap">
<header>
<h1 class="page__title" itemprop="headline">Release verification guide for ServiceComb
</h1>
</header>
<section class="page__content" itemprop="text">
<aside class="sidebar__right">
<nav class="toc">
<!-- <header><h4 class="nav__title"><i class="fa fa-file-text"></i> On This Page</h4></header> -->
<ul class="toc__menu" id="markdown-toc">
<li><a href="#verify-java-chassis" id="markdown-toc-verify-java-chassis">Verify Java Chassis</a> <ul>
<li><a href="#prerequisite" id="markdown-toc-prerequisite">Prerequisite</a></li>
<li><a href="#verify-the-hash-and-the-signature" id="markdown-toc-verify-the-hash-and-the-signature">Verify the Hash and the Signature</a></li>
<li><a href="#verify-the-source-code" id="markdown-toc-verify-the-source-code">Verify the source code</a></li>
<li><a href="#verify-the-staging-repository" id="markdown-toc-verify-the-staging-repository">Verify the Staging Repository</a></li>
<li><a href="#verify-integration-with-spring-cloud" id="markdown-toc-verify-integration-with-spring-cloud">Verify integration with Spring Cloud</a></li>
<li><a href="#verify-samplesoptional" id="markdown-toc-verify-samplesoptional">Verify Samples(Optional)</a></li>
</ul>
</li>
</ul>
</nav>
</aside>
<p>As apache project, when ServiceComb release new version, need make a vote and invite users and developers to verify its availability, this guide will introduce how to do this work.</p>
<h2 id="verify-java-chassis">Verify Java Chassis</h2>
<h3 id="prerequisite">Prerequisite</h3>
<ol>
<li>Make sure your network is available;</li>
<li>Please check these components had installed:
<ul>
<li><a href="http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html">JDK1.8</a></li>
<li><a href="https://maven.apache.org/download.cgi">Maven 3.x</a></li>
<li><a href="https://www.docker.com/get-docker">Docker</a></li>
</ul>
</li>
</ol>
<blockquote>
<p>Hint: If the OS of environment is Windows, need install <a href="https://docs.docker.com/machine/install-machine/">Docker Machine</a></p>
</blockquote>
<h3 id="verify-the-hash-and-the-signature">Verify the Hash and the Signature</h3>
<p>Please find the URL of <strong>Release Candidate</strong> in Vote mail, for example:</p>
<div class="language-text highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Release Candidate : https://dist.apache.org/repos/dist/dev/incubator/servicecomb/incubator-servicecomb-java-chassis/1.0.0-m2/rc-01/
</code></pre></div></div>
<p>Open this URL in browser, download the source code end with <code class="highlighter-rouge">src.zip</code>, signature file end with <code class="highlighter-rouge">src.zip.asc</code> and hash file end with <code class="highlighter-rouge">src.zip.sha512</code>, please keep these three files in same folder.</p>
<p>Please find URL of <strong>Key</strong> in Vote mail, for example:</p>
<div class="language-text highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Keys to verify the Release Candidate : https://dist.apache.org/repos/dist/dev/incubator/servicecomb/KEYS
</code></pre></div></div>
<p>Open this URL in browser, copy contents into KEYS file, then import:</p>
<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>gpg <span class="nt">--import</span> KEYS
</code></pre></div></div>
<p>Then <code class="highlighter-rouge">Mohammad Asif Siddiqui (ServiceComb Code Signing Key) &lt;asifdxtreme@apache.org&gt;</code> will output if imported successfully.</p>
<p>Verify the Signature:</p>
<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>gpg <span class="nt">--verify</span> xxx-src.zip.asc xxx-src.zip
</code></pre></div></div>
<p>Then <code class="highlighter-rouge">Good signature from "Mohammad Asif Siddiqui (ServiceComb Code Signing Key) &lt;asifdxtreme@apache.org&gt;"</code> will output if verified successfully.</p>
<p>Verify the Hash:</p>
<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">sha512sum</span> <span class="nt">-c</span> xxx-src.zip.sha512
</code></pre></div></div>
<p>Then <code class="highlighter-rouge">OK</code> will output if verified successfully.</p>
<h3 id="verify-the-source-code">Verify the source code</h3>
<p>Unzip the source code:</p>
<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>unzip xxx-src.zip
</code></pre></div></div>
<p>Run test case under source code root:</p>
<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>mvn clean <span class="nb">install</span> <span class="nt">-Pdocker</span> <span class="nt">-Pit</span> <span class="nt">-Pdemo-run-release</span>
</code></pre></div></div>
<blockquote>
<p>Hint: If the OS of environment is Windows:</p>
<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>mvn clean <span class="nb">install</span> <span class="nt">-Pdocker</span> <span class="nt">-Pit</span> <span class="nt">-Pdocker-machine</span> <span class="nt">-Pdemo-run-release</span>
</code></pre></div> </div>
</blockquote>
<p>Wait all test case check passed, may use 10~30 minutes.</p>
<h3 id="verify-the-staging-repository">Verify the Staging Repository</h3>
<p>First need delete all ServiceComb cache in local maven repo:</p>
<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">rm</span> <span class="nt">-rf</span> /root/.m2/repository/org/apache/servicecomb/
</code></pre></div></div>
<blockquote>
<p>Hint: If not the root, please change the path of .m2</p>
</blockquote>
<p>Please find URL of <strong>Staging Repository</strong> in Vote mail, for example:</p>
<div class="language-text highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Staging Repository : https://repository.apache.org/content/repositories/orgapacheservicecomb-xxxx/
</code></pre></div></div>
<p>Then add this Staging Repository address into <code class="highlighter-rouge">settings.xml</code> of maven:</p>
<div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">&lt;settings&gt;</span>
<span class="nt">&lt;profiles&gt;</span>
<span class="nt">&lt;profile&gt;</span>
<span class="nt">&lt;repositories&gt;</span>
<span class="nt">&lt;repository&gt;</span>
<span class="nt">&lt;releases</span> <span class="nt">/&gt;</span>
<span class="nt">&lt;snapshots&gt;</span>
<span class="nt">&lt;enabled&gt;</span>false<span class="nt">&lt;/enabled&gt;</span>
<span class="nt">&lt;/snapshots&gt;</span>
<span class="nt">&lt;id&gt;</span>repo.apache.staging<span class="nt">&lt;/id&gt;</span>
<span class="nt">&lt;url&gt;</span>{Staging Repository URL in Vote mail}<span class="nt">&lt;/url&gt;</span>
<span class="nt">&lt;/repository&gt;</span>
<span class="nt">&lt;/repositories&gt;</span>
<span class="nt">&lt;pluginRepositories&gt;</span>
<span class="nt">&lt;pluginRepository&gt;</span>
<span class="nt">&lt;releases</span> <span class="nt">/&gt;</span>
<span class="nt">&lt;snapshots&gt;</span>
<span class="nt">&lt;enabled&gt;</span>false<span class="nt">&lt;/enabled&gt;</span>
<span class="nt">&lt;/snapshots&gt;</span>
<span class="nt">&lt;id&gt;</span>repo.apache.staging<span class="nt">&lt;/id&gt;</span>
<span class="nt">&lt;url&gt;</span>{Staging Repository URL in Vote mail}<span class="nt">&lt;/url&gt;</span>
<span class="nt">&lt;/pluginRepository&gt;</span>
<span class="nt">&lt;/pluginRepositories&gt;</span>
<span class="nt">&lt;id&gt;</span>staging<span class="nt">&lt;/id&gt;</span>
<span class="nt">&lt;/profile&gt;</span>
<span class="nt">&lt;/profiles&gt;</span>
<span class="nt">&lt;/settings&gt;</span>
</code></pre></div></div>
<p>After that, enter <strong>demo folder under the source code(not root folder of source code)</strong> and run:</p>
<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>mvn clean <span class="nb">install</span> <span class="nt">-Pdocker</span> <span class="nt">-Pstaging</span> <span class="nt">-Pdemo-run-release</span>
</code></pre></div></div>
<blockquote>
<p>Hint: If the OS of environment is Windows:</p>
<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>mvn clean <span class="nb">install</span> <span class="nt">-Pdocker</span> <span class="nt">-Pstaging</span> <span class="nt">-Pdocker-machine</span> <span class="nt">-Pdemo-run-release</span>
</code></pre></div> </div>
</blockquote>
<p><strong>When test cases are running, we can see the Java Chassis dependencies will download from Apache Staging Repository that had configured:</strong></p>
<div class="language-text highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Downloading: https://repository.apache.org/content/repositories/orgapacheservicecomb-xxxx/xxxx.pom
</code></pre></div></div>
<p>Wait all test case check passed, may use 5~15 minutes.</p>
<h3 id="verify-integration-with-spring-cloud">Verify integration with Spring Cloud</h3>
<p>Please clone the latest source code of Company demo project from https://github.com/ServiceComb/ServiceComb-Company-WorkShop , then checkout branch of 1.x :</p>
<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>git clone https://github.com/ServiceComb/ServiceComb-Company-WorkShop.git
git checkout 1.x
</code></pre></div></div>
<p>Modify the configuration of <code class="highlighter-rouge">&lt;java-chassis.version&gt;</code> in <code class="highlighter-rouge">pom.xml</code> under source code root folder to current releasing version, such as 1.0.0-m2 :</p>
<div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">&lt;properties&gt;</span>
<span class="nt">&lt;java-chassis.version&gt;</span>1.0.0-m2<span class="nt">&lt;/java-chassis.version&gt;</span>
<span class="nt">&lt;/properties&gt;</span>
</code></pre></div></div>
<p>Run test case under source code root:</p>
<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>mvn clean verify <span class="nt">-Pdocker</span> <span class="nt">-Pstaging</span>
</code></pre></div></div>
<blockquote>
<p>Hint: If the OS of environment is Windows:</p>
<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>mvn clean verify <span class="nt">-Pdocker</span> <span class="nt">-Pstaging</span> <span class="nt">-Pdocker-machine</span>
</code></pre></div> </div>
</blockquote>
<p>Wait all test case check passed, may use 5~10 minutes.</p>
<h3 id="verify-samplesoptional">Verify Samples(Optional)</h3>
<p>Download <a href="https://github.com/apache/servicecomb-samples">samples code</a>. There are many samples here, choose
some of them and change the version and do verifications. See each README of samples for details.</p>
</section>
<footer class="page__meta">
<p class="page__taxonomy">
<strong><i class="fa fa-fw fa-tags" aria-hidden="true"></i> Tags: </strong>
<span itemprop="keywords">
<a href="/tags/#release" class="page__taxonomy-item" rel="tag">release</a><span class="sep">, </span>
<a href="/tags/#verification" class="page__taxonomy-item" rel="tag">verification</a>
</span>
</p>
</footer>
</div>
</article>
</div>
<script async src="//pagead2.googlesyndication.com/pagead/js/adsbygoogle.js"></script>
<div align="center" style="margin: 0 0;">
<ins class="adsbygoogle"
style="display:block; border-bottom: initial;"
data-ad-client="ca-pub-7328585512091257"
data-ad-slot="3049671934"
data-ad-format="auto"></ins>
</div>
<div class="page__footer">
<footer>
<!-- start custom footer snippets -->
<!-- end custom footer snippets -->
<div class="container">
<div class="row justify-content-md-center">
<div class="col">
<ul>
<p class="header">Resources</p>
<li><a href="/docs/getting-started/">Getting started</a></li>
<li><a href="/docs/users/">User Guide</a></li>
<li><a href="/slides/">Slides</a></li>
<li><a href="/users/faq/">Common Questions</a></li>
</ul>
</div>
<div class="col">
<ul>
<p class="header">ASF</p>
<li><a href="http://www.apache.org">Foundation</a></li>
<li><a href="http://www.apache.org/licenses/">License</a></li>
<li><a href="http://www.apache.org/events/current-event">Events</a></li>
<li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li>
<li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
</ul>
</div>
<div class="col">
<ul>
<p class="header">Contribute</p>
<li><a href="http://issues.apache.org/jira/browse/SCB">Report a Doc Issue</a></li>
<li><a href="https://github.com/apache/servicecomb-website/edit/master/_developers/release_validation_guide.md">Edit This Page on Github</a></li>
<li><a href="/developers/submit-codes/">Code Submit Guide</a></li>
<li><a href="/security">Security</a></li>
</ul>
</div>
<div class="col">
<ul class="social-icons">
<p class="header">Community</p>
<li>
<a href="mailto:dev-subscribe@servicecomb.incubator.apache.org" rel="nofollow"><span class="mail">Mailing List</span></a>
</li>
<li>
<a href="https://github.com/apache?q=ServiceComb" target="_blank"><span class="github">Github</span></a>
</li>
<li>
<a href="https://twitter.com/ServiceComb" target="_blank"><span class="twitter">Twitter</span></a>
</li>
<li>
<a href="/feed.xml" target="_blank"><span class="rss">Feed</span></a>
</li>
</ul>
</div>
</div>
</div>
<div class="page__footer-bottom">
<div>&copy; 2020 Apache ServiceComb. Powered by <a href="http://jekyllrb.com" rel="nofollow">Jekyll</a> &amp; <a href="https://mademistakes.com/work/minimal-mistakes-jekyll-theme/" rel="nofollow">Minimal Mistakes</a>.</div>
<div>All other marks mentioned may be trademarks or registered trademarks of their respective owners.</div>
</div>
</footer>
</div>
<script src="/assets/js/main.min.js"></script>
<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
ga('create', 'UA-101622733-1', 'auto');
ga('send', 'pageview');
</script>
</body>
</html>