This is an automated email from the ASF dual-hosted git repository. szetszwo pushed a commit to branch asf-site in repository https://gitbox.apache.org/repos/asf/ratis-hadoop-projects.git
commit 46051ffc5335d57de5dc0eb8c07fcc2d619e77f0 Author: Xiaoyu Yao <[email protected]> AuthorDate: Fri Feb 28 15:43:51 2020 +0100 HDDS-818. OzoneConfiguration uses an existing XMLRoot value Closes #55 --- categories.html | 3 +- categories/index.xml | 2 +- community.html | 42 ++------ getting_started.html | 72 +++++--------- index.html | 170 +++++++++++--------------------- index.xml | 44 ++++++--- logservice.html | 176 +++++++++------------------------ logservice/index.html | 22 +---- logservice/index.xml | 8 +- logservice/lifecycle.html | 52 +--------- logservice/security.html | 194 +++++++++++++++++++++++++++++++++++++ logservice/testing.html | 87 +++-------------- logservice/testing/docker.html | 50 ++-------- logservice/testing/index.html | 20 +--- logservice/testing/index.xml | 4 +- logservice/testing/vagrant.html | 20 +--- post.html | 78 ++++++--------- post/0.1.0-alpha.html | 20 +--- post/0.2.0.html | 21 +--- post/0.3.0.html | 20 +--- categories.html => post/0.4.0.html | 19 ++-- categories.html => post/0.5.0.html | 19 ++-- post/index.xml | 26 ++++- sitemap.xml | 38 +++++--- source.html | 19 +--- tags.html | 3 +- tags/index.xml | 2 +- 27 files changed, 515 insertions(+), 716 deletions(-) diff --git a/categories.html b/categories.html index 9070da1..671b348 100644 --- a/categories.html +++ b/categories.html @@ -102,6 +102,7 @@ </div> + </section> </div> @@ -109,7 +110,7 @@ <div class="container"> <div class="col-md-12 trademark"> - <p>© 2019 <a href="http://apache.org";>The Apache Software Foundation</a>, + <p>© 2020 <a href="http://apache.org";>The Apache Software Foundation</a>, Apache, Apache Ratis, the Apache feather logo, Apache Ratis logo, Apache Incubator logo are trademarks of The Apache Software Foundation. <p> </div> diff --git a/categories/index.xml b/categories/index.xml index 0e9373b..3486325 100644 --- a/categories/index.xml +++ b/categories/index.xml @@ -1,4 +1,4 @@ -<?xml version="1.0" encoding="utf-8" standalone="yes" ?> +<?xml version="1.0" encoding="utf-8" standalone="yes"?> <rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom";> <channel> <title>Categories on Apache Ratis</title> diff --git a/community.html b/community.html index f261c81..367e7d4 100644 --- a/community.html +++ b/community.html @@ -93,55 +93,29 @@ <div class="container"> <h1>Community</h1> - - -<!--- - Licensed 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. See accompanying LICENSE file. ---> - +<!-- raw HTML omitted --> +<!-- raw HTML omitted --> <h3 id="mailing-list">Mailing list</h3> - <h4 id="developers">Developers</h4> - -<p>If you’d like to contribute to Apache Ratis, please subscribe to the Ratis developer mailing list.</p> - +<p>If you'd like to contribute to Apache Ratis, please subscribe to the Ratis developer mailing list.</p> <p>The Ratis developer mailing list is: <a href="mailto:[email protected]";>[email protected]</a>.</p> - <ul> -<li><a href="mailto: [email protected]">Subscribe to List</a></li> -<li><a href="mailto: [email protected]">Unsubscribe from List</a></li> +<li>[Subscribe to List](mailto: <a href="mailto:[email protected]";>[email protected]</a>)</li> +<li>[Unsubscribe from List](mailto: <a href="mailto:[email protected]";>[email protected]</a>)</li> <li><a href="http://mail-archives.apache.org/mod_mbox/ratis-dev/";>Archives</a></li> </ul> - <h4 id="user">User</h4> - <p>The user@ mailing list is the preferred mailing list for end-user questions and discussion.</p> - <p>Please use dev mailing list to address developers on a specific technical question.</p> - <p>The Ratis user mailing list is: <a href="mailto:[email protected]";>[email protected]</a>.</p> - <ul> -<li><a href="mailto: [email protected]">Subscribe to List</a></li> -<li><a href="mailto: [email protected]">Unsubscribe from List</a></li> +<li>[Subscribe to List](mailto: <a href="mailto:[email protected]";>[email protected]</a>)</li> +<li>[Unsubscribe from List](mailto: <a href="mailto:[email protected]";>[email protected]</a>)</li> <li><a href="http://mail-archives.apache.org/mod_mbox/ratis-user/";>Archives</a></li> </ul> - <p>To post to the list, it is necessary to subscribe to it.</p> - <h3 id="slack">Slack</h3> - <p>There is also a slack instance for discussion at <a href="https://apacheratisdev.slack.com";>https://apacheratisdev.slack.com</a>. Please write to the mailing list if you need an invite.</p> @@ -151,7 +125,7 @@ Please write to the mailing list if you need an invite.</p> <div class="container"> <div class="col-md-12 trademark"> - <p>© 2019 <a href="http://apache.org";>The Apache Software Foundation</a>, + <p>© 2020 <a href="http://apache.org";>The Apache Software Foundation</a>, Apache, Apache Ratis, the Apache feather logo, Apache Ratis logo, Apache Incubator logo are trademarks of The Apache Software Foundation. <p> </div> diff --git a/getting_started.html b/getting_started.html index 8dd6e9f..78f2baf 100644 --- a/getting_started.html +++ b/getting_started.html @@ -93,66 +93,42 @@ <div class="container"> <h1>Getting started</h1> - - -<!--- - Licensed 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. See accompanying LICENSE file. ---> - -<p>Ratis is a <a href="https://raft.github.io/";>Raft</a> protocol <em>library</em> in Java. It’s not a standalone server application like Zookeeper or Consul.</p> - +<!-- raw HTML omitted --> +<!-- raw HTML omitted --> +<p>Ratis is a <a href="https://raft.github.io/%22";>Raft</a> protocol <em>library</em> in Java. It's not a standalone server application like Zookeeper or Consul.</p> <h3 id="examples">Examples</h3> - <p>To demonstrate how to use Ratis from the code, Please look at the following examples.</p> - <ul> -<li><p><a href="https://github.com/apache/incubator-ratis/tree/master/ratis-examples/src/main/java/org/apache/ratis/examples/arithmetic";>Arithmetic example</a>: This is a simple distributed calculator that replicates the values defined and allows user to perform arithmetic operations on these replicated values.</p></li> - -<li><p><a href="https://github.com/apache/incubator-ratis/tree/master/ratis-examples/src/main/java/org/apache/ratis/examples/filestore";>FileStore example</a>: This is an example of using Ratis for reading and writing files.</p></li> +<li> +<p><a href="https://github.com/apache/incubator-ratis/tree/master/ratis-examples/src/main/java/org/apache/ratis/examples/arithmetic";>Arithmetic example</a>: This is a simple distributed calculator that replicates the values defined and allows user to perform arithmetic operations on these replicated values.</p> +</li> +<li> +<p><a href="https://github.com/apache/incubator-ratis/tree/master/ratis-examples/src/main/java/org/apache/ratis/examples/filestore";>FileStore example</a>: This is an example of using Ratis for reading and writing files.</p> +</li> </ul> - -<!-- TODO: We should have the following as documentation in the github. --> - +<!-- raw HTML omitted --> <p>The source code of the examples could be found in the <a href="https://github.com/apache/incubator-ratis/blob/master/ratis-examples/";>ratis-examples</a> sub-project.</p> - <h3 id="maven-usage">Maven usage</h3> - <p>To use in our project you can access the latest binaries from maven central:</p> - -<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-xml" data-lang="xml"><span style="color:#f92672"><dependency></span> - <span style="color:#f92672"><artifactId></span>ratis-server<span style="color:#f92672"></artifactId></span> - <span style="color:#f92672"><groupId></span>org.apache.ratis<span style="color:#f92672"></groupId></span> +<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-xml" data-lang="xml"><span style="color:#f92672"><dependency</span><span style="color:#f92672">></span> + <span style="color:#f92672"><artifactId</span><span style="color:#f92672">></span>ratis-server<span style="color:#f92672"></artifactId></span> + <span style="color:#f92672"><groupId</span><span style="color:#f92672">></span>org.apache.ratis<span style="color:#f92672"></groupId></span> <span style="color:#f92672"></dependency></span></code></pre></div> - <p>You also need to include <em>one</em> of the transports:</p> - -<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-xml" data-lang="xml"><span style="color:#f92672"><dependency></span> - <span style="color:#f92672"><artifactId></span>ratis-grpc<span style="color:#f92672"></artifactId></span> - <span style="color:#f92672"><groupId></span>org.apache.ratis<span style="color:#f92672"></groupId></span> +<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-xml" data-lang="xml"><span style="color:#f92672"><dependency</span><span style="color:#f92672">></span> + <span style="color:#f92672"><artifactId</span><span style="color:#f92672">></span>ratis-grpc<span style="color:#f92672"></artifactId></span> + <span style="color:#f92672"><groupId</span><span style="color:#f92672">></span>org.apache.ratis<span style="color:#f92672"></groupId></span> <span style="color:#f92672"></dependency></span></code></pre></div> - -<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-xml" data-lang="xml"> <span style="color:#f92672"><dependency></span> - <span style="color:#f92672"><artifactId></span>ratis-netty<span style="color:#f92672"></artifactId></span> - <span style="color:#f92672"><groupId></span>org.apache.ratis<span style="color:#f92672"></groupId></span> +<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-xml" data-lang="xml"> <span style="color:#f92672"><dependency</span><span style="color:#f92672">></span> + <span style="color:#f92672"><artifactId</span><span style="color:#f92672">></span>ratis-netty<span style="color:#f92672"></artifactId></span> + <span style="color:#f92672"><groupId</span><span style="color:#f92672">></span>org.apache.ratis<span style="color:#f92672"></groupId></span> <span style="color:#f92672"></dependency></span></code></pre></div> - -<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-xml" data-lang="xml"><span style="color:#f92672"><dependency></span> - <span style="color:#f92672"><artifactId></span>ratis-hadoop<span style="color:#f92672"></artifactId></span> - <span style="color:#f92672"><groupId></span>org.apache.ratis<span style="color:#f92672"></groupId></span> +<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-xml" data-lang="xml"><span style="color:#f92672"><dependency</span><span style="color:#f92672">></span> + <span style="color:#f92672"><artifactId</span><span style="color:#f92672">></span>ratis-hadoop<span style="color:#f92672"></artifactId></span> + <span style="color:#f92672"><groupId</span><span style="color:#f92672">></span>org.apache.ratis<span style="color:#f92672"></groupId></span> <span style="color:#f92672"></dependency></span></code></pre></div> - -<p>Please note that Apache Hadoop dependencies are shaded, so it’s safe to use hadoop transport with different versions of Hadoop.</p> +<p>Please note that Apache Hadoop dependencies are shaded, so it's safe to use hadoop transport with different versions of Hadoop.</p> </div> @@ -160,7 +136,7 @@ <div class="container"> <div class="col-md-12 trademark"> - <p>© 2019 <a href="http://apache.org";>The Apache Software Foundation</a>, + <p>© 2020 <a href="http://apache.org";>The Apache Software Foundation</a>, Apache, Apache Ratis, the Apache feather logo, Apache Ratis logo, Apache Incubator logo are trademarks of The Apache Software Foundation. <p> </div> diff --git a/index.html b/index.html index 2f64ad8..aa85315 100644 --- a/index.html +++ b/index.html @@ -4,7 +4,7 @@ <html> <head> - <meta name="generator" content="Hugo 0.54.0" /> + <meta name="generator" content="Hugo 0.62.0" /> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <meta name="viewport" content="width=device-width, initial-scale=1"> @@ -183,16 +183,8 @@ <div class="row header"> <h2>Latest news</h2> - <div class="panel-heading clearfix"><a class="pull-left" href="/post/0.3.0.html">Release 0.3.0 is available</a> - <small class="pull-right">2019 Apr 21 </small> - </div> - - <div class="panel-heading clearfix"><a class="pull-left" href="/post/0.2.0.html">Release 0.2.0 is available</a> - <small class="pull-right">2018 Jul 15 </small> - </div> - - <div class="panel-heading clearfix"><a class="pull-left" href="/post/0.1.0-alpha.html">Release 0.1.0-alpha is available</a> - <small class="pull-right">2017 May 2 </small> + <div class="panel-heading clearfix"><a class="pull-left" href="/post.html">Posts</a> + <small class="pull-right">2020 Feb 4 </small> </div> </div> @@ -225,6 +217,24 @@ </thead> <tr> + <td>0.5.0</td> + <td>2020 Feb 4 </td> + <td><a href="https://www.apache.org/dist/incubator/ratis/0.5.0/";> + https://www.apache.org/dist/incubator/ratis/0.5.0/</a> + </td> + <td><a href="post/0.5.0.html">Announcement</a></td> + </tr> + + <tr> + <td>0.4.0</td> + <td>2019 Sep 12 </td> + <td><a href="https://www.apache.org/dist/incubator/ratis/0.4.0/";> + https://www.apache.org/dist/incubator/ratis/0.4.0/</a> + </td> + <td><a href="post/0.4.0.html">Announcement</a></td> + </tr> + + <tr> <td>0.3.0</td> <td>2019 Apr 21 </td> <td><a href="https://www.apache.org/dist/incubator/ratis/0.3.0/";> @@ -242,15 +252,6 @@ <td><a href="post/0.2.0.html">Announcement</a></td> </tr> - <tr> - <td>0.1.0-alpha</td> - <td>2017 May 2 </td> - <td><a href="https://www.apache.org/dist/incubator/ratis/0.1.0-alpha/";> - https://www.apache.org/dist/incubator/ratis/0.1.0-alpha/</a> - </td> - <td><a href="post/0.1.0-alpha.html">Announcement</a></td> - </tr> - </table> </p> @@ -270,66 +271,42 @@ <div class="row header"> <h2>Getting started</h2> - - -<!--- - Licensed 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. See accompanying LICENSE file. ---> - -<p>Ratis is a <a href="https://raft.github.io/";>Raft</a> protocol <em>library</em> in Java. It’s not a standalone server application like Zookeeper or Consul.</p> - + <!-- raw HTML omitted --> +<!-- raw HTML omitted --> +<p>Ratis is a <a href="https://raft.github.io/%22";>Raft</a> protocol <em>library</em> in Java. It's not a standalone server application like Zookeeper or Consul.</p> <h3 id="examples">Examples</h3> - <p>To demonstrate how to use Ratis from the code, Please look at the following examples.</p> - <ul> -<li><p><a href="https://github.com/apache/incubator-ratis/tree/master/ratis-examples/src/main/java/org/apache/ratis/examples/arithmetic";>Arithmetic example</a>: This is a simple distributed calculator that replicates the values defined and allows user to perform arithmetic operations on these replicated values.</p></li> - -<li><p><a href="https://github.com/apache/incubator-ratis/tree/master/ratis-examples/src/main/java/org/apache/ratis/examples/filestore";>FileStore example</a>: This is an example of using Ratis for reading and writing files.</p></li> +<li> +<p><a href="https://github.com/apache/incubator-ratis/tree/master/ratis-examples/src/main/java/org/apache/ratis/examples/arithmetic";>Arithmetic example</a>: This is a simple distributed calculator that replicates the values defined and allows user to perform arithmetic operations on these replicated values.</p> +</li> +<li> +<p><a href="https://github.com/apache/incubator-ratis/tree/master/ratis-examples/src/main/java/org/apache/ratis/examples/filestore";>FileStore example</a>: This is an example of using Ratis for reading and writing files.</p> +</li> </ul> - -<!-- TODO: We should have the following as documentation in the github. --> - +<!-- raw HTML omitted --> <p>The source code of the examples could be found in the <a href="https://github.com/apache/incubator-ratis/blob/master/ratis-examples/";>ratis-examples</a> sub-project.</p> - <h3 id="maven-usage">Maven usage</h3> - <p>To use in our project you can access the latest binaries from maven central:</p> - -<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-xml" data-lang="xml"><span style="color:#f92672"><dependency></span> - <span style="color:#f92672"><artifactId></span>ratis-server<span style="color:#f92672"></artifactId></span> - <span style="color:#f92672"><groupId></span>org.apache.ratis<span style="color:#f92672"></groupId></span> +<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-xml" data-lang="xml"><span style="color:#f92672"><dependency</span><span style="color:#f92672">></span> + <span style="color:#f92672"><artifactId</span><span style="color:#f92672">></span>ratis-server<span style="color:#f92672"></artifactId></span> + <span style="color:#f92672"><groupId</span><span style="color:#f92672">></span>org.apache.ratis<span style="color:#f92672"></groupId></span> <span style="color:#f92672"></dependency></span></code></pre></div> - <p>You also need to include <em>one</em> of the transports:</p> - -<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-xml" data-lang="xml"><span style="color:#f92672"><dependency></span> - <span style="color:#f92672"><artifactId></span>ratis-grpc<span style="color:#f92672"></artifactId></span> - <span style="color:#f92672"><groupId></span>org.apache.ratis<span style="color:#f92672"></groupId></span> +<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-xml" data-lang="xml"><span style="color:#f92672"><dependency</span><span style="color:#f92672">></span> + <span style="color:#f92672"><artifactId</span><span style="color:#f92672">></span>ratis-grpc<span style="color:#f92672"></artifactId></span> + <span style="color:#f92672"><groupId</span><span style="color:#f92672">></span>org.apache.ratis<span style="color:#f92672"></groupId></span> <span style="color:#f92672"></dependency></span></code></pre></div> - -<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-xml" data-lang="xml"> <span style="color:#f92672"><dependency></span> - <span style="color:#f92672"><artifactId></span>ratis-netty<span style="color:#f92672"></artifactId></span> - <span style="color:#f92672"><groupId></span>org.apache.ratis<span style="color:#f92672"></groupId></span> +<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-xml" data-lang="xml"> <span style="color:#f92672"><dependency</span><span style="color:#f92672">></span> + <span style="color:#f92672"><artifactId</span><span style="color:#f92672">></span>ratis-netty<span style="color:#f92672"></artifactId></span> + <span style="color:#f92672"><groupId</span><span style="color:#f92672">></span>org.apache.ratis<span style="color:#f92672"></groupId></span> <span style="color:#f92672"></dependency></span></code></pre></div> - -<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-xml" data-lang="xml"><span style="color:#f92672"><dependency></span> - <span style="color:#f92672"><artifactId></span>ratis-hadoop<span style="color:#f92672"></artifactId></span> - <span style="color:#f92672"><groupId></span>org.apache.ratis<span style="color:#f92672"></groupId></span> +<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-xml" data-lang="xml"><span style="color:#f92672"><dependency</span><span style="color:#f92672">></span> + <span style="color:#f92672"><artifactId</span><span style="color:#f92672">></span>ratis-hadoop<span style="color:#f92672"></artifactId></span> + <span style="color:#f92672"><groupId</span><span style="color:#f92672">></span>org.apache.ratis<span style="color:#f92672"></groupId></span> <span style="color:#f92672"></dependency></span></code></pre></div> - -<p>Please note that Apache Hadoop dependencies are shaded, so it’s safe to use hadoop transport with different versions of Hadoop.</p> +<p>Please note that Apache Hadoop dependencies are shaded, so it's safe to use hadoop transport with different versions of Hadoop.</p> </div> @@ -342,55 +319,29 @@ <div class="row header"> <h2>Community</h2> - - -<!--- - Licensed 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. See accompanying LICENSE file. ---> - + <!-- raw HTML omitted --> +<!-- raw HTML omitted --> <h3 id="mailing-list">Mailing list</h3> - <h4 id="developers">Developers</h4> - -<p>If you’d like to contribute to Apache Ratis, please subscribe to the Ratis developer mailing list.</p> - +<p>If you'd like to contribute to Apache Ratis, please subscribe to the Ratis developer mailing list.</p> <p>The Ratis developer mailing list is: <a href="mailto:[email protected]";>[email protected]</a>.</p> - <ul> -<li><a href="mailto: [email protected]">Subscribe to List</a></li> -<li><a href="mailto: [email protected]">Unsubscribe from List</a></li> +<li>[Subscribe to List](mailto: <a href="mailto:[email protected]";>[email protected]</a>)</li> +<li>[Unsubscribe from List](mailto: <a href="mailto:[email protected]";>[email protected]</a>)</li> <li><a href="http://mail-archives.apache.org/mod_mbox/ratis-dev/";>Archives</a></li> </ul> - <h4 id="user">User</h4> - <p>The user@ mailing list is the preferred mailing list for end-user questions and discussion.</p> - <p>Please use dev mailing list to address developers on a specific technical question.</p> - <p>The Ratis user mailing list is: <a href="mailto:[email protected]";>[email protected]</a>.</p> - <ul> -<li><a href="mailto: [email protected]">Subscribe to List</a></li> -<li><a href="mailto: [email protected]">Unsubscribe from List</a></li> +<li>[Subscribe to List](mailto: <a href="mailto:[email protected]";>[email protected]</a>)</li> +<li>[Unsubscribe from List](mailto: <a href="mailto:[email protected]";>[email protected]</a>)</li> <li><a href="http://mail-archives.apache.org/mod_mbox/ratis-user/";>Archives</a></li> </ul> - <p>To post to the list, it is necessary to subscribe to it.</p> - <h3 id="slack">Slack</h3> - <p>There is also a slack instance for discussion at <a href="https://apacheratisdev.slack.com";>https://apacheratisdev.slack.com</a>. Please write to the mailing list if you need an invite.</p> @@ -405,22 +356,9 @@ Please write to the mailing list if you need an invite.</p> <div class="row header"> <h2>Source</h2> - <!--- - Licensed 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. See accompanying LICENSE file. ---> - + <!-- raw HTML omitted --> +<!-- raw HTML omitted --> <p>Source code is part of every release, you can download the source bundles from download section and build the project according to the included instructions.</p> - <p>The versioned source code history is available from the <a href="https://gitbox.apache.org/repos/asf?p=incubator-ratis.git";>Apache git</a> repository or from the <a href="https://github.com/apache/incubator-ratis";>github mirror</a>. It is only for development and not intended for use by the general public. Only the source code from the released artifacts are checked by the Project Management Committee.</p> @@ -461,7 +399,7 @@ Only the source code from the released artifacts are checked by the Project Mana <div class="container"> <div class="col-md-12 trademark"> - <p>© 2019 <a href="http://apache.org";>The Apache Software Foundation</a>, + <p>© 2020 <a href="http://apache.org";>The Apache Software Foundation</a>, Apache, Apache Ratis, the Apache feather logo, Apache Ratis logo, Apache Incubator logo are trademarks of The Apache Software Foundation. <p> </div> diff --git a/index.xml b/index.xml index 14092f9..fee0e4b 100644 --- a/index.xml +++ b/index.xml @@ -1,4 +1,4 @@ -<?xml version="1.0" encoding="utf-8" standalone="yes" ?> +<?xml version="1.0" encoding="utf-8" standalone="yes"?> <rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom";> <channel> <title>Apache Ratis</title> @@ -6,12 +6,34 @@ <description>Recent content on Apache Ratis</description> <generator>Hugo -- gohugo.io</generator> <language>en-us</language> - <lastBuildDate>Sun, 21 Apr 2019 00:00:00 +0000</lastBuildDate> + <lastBuildDate>Tue, 04 Feb 2020 00:00:00 +0000</lastBuildDate> <atom:link href="https://ratis.incubator.apache.org/index.xml"; rel="self" type="application/rss+xml" /> <item> + <title>Release 0.5.0 is available</title> + <link>https://ratis.incubator.apache.org/post/0.5.0.html</link> + <pubDate>Tue, 04 Feb 2020 00:00:00 +0000</pubDate> + + <guid>https://ratis.incubator.apache.org/post/0.5.0.html</guid> + <description>Download +It contains more than 94 improvements and bug fixes based on various Apache Hadoop Ozone use cases. See the changes between 0.4.0 and 0.5.0 releases. +It has been tested with Apache Hadoop Ozone where Apache Ratis is used to replicate raw data.</description> + </item> + + <item> + <title>Release 0.4.0 is available</title> + <link>https://ratis.incubator.apache.org/post/0.4.0.html</link> + <pubDate>Thu, 12 Sep 2019 00:00:00 +0000</pubDate> + + <guid>https://ratis.incubator.apache.org/post/0.4.0.html</guid> + <description>Download +It contains more than 89 improvements and bug fixes based on various Apache Hadoop Ozone use cases. See the changes between 0.3.0 and 0.4.0 releases. +It has been tested with Apache Hadoop Ozone where Apache Ratis is used to replicate raw data.</description> + </item> + + <item> <title>Release 0.3.0 is available</title> <link>https://ratis.incubator.apache.org/post/0.3.0.html</link> <pubDate>Sun, 21 Apr 2019 00:00:00 +0000</pubDate> @@ -51,9 +73,9 @@ Key features: <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate> <guid>https://ratis.incubator.apache.org/community.html</guid> - <description>Mailing list Developers If you&rsquo;d like to contribute to Apache Ratis, please subscribe to the Ratis developer mailing list. + <description>Mailing list Developers If you'd like to contribute to Apache Ratis, please subscribe to the Ratis developer mailing list. The Ratis developer mailing list is: [email protected]. - Subscribe to List Unsubscribe from List Archives User The user@ mailing list is the preferred mailing list for end-user questions and discussion. + [Subscribe to List](mailto: [email protected]) [Unsubscribe from List](mailto: [email protected]) Archives User The user@ mailing list is the preferred mailing list for end-user questions and discussion. Please use dev mailing list to address developers on a specific technical question. The Ratis user mailing list is: user@ratis.</description> </item> @@ -65,7 +87,7 @@ The Ratis user mailing list is: user@ratis.</description> <guid>https://ratis.incubator.apache.org/logservice/testing/docker.html</guid> <description>The Docker orchestration is comprised of the following: - A Docker image which has the necessary software to run the LogService A docker-compose.yml file which can launch the necessary containers for a full-fledged LogService &ldquo;cluster&rdquo; Scripts to build the Docker image and launch a client environment to interact with a running cluster via Compose. Building the Docker image $ mvn clean package assembly:single -DskipTests $ cd ratis-logservice &amp;&amp; .</description> + A Docker image which has the necessary software to run the LogService A docker-compose.yml file which can launch the necessary containers for a full-fledged LogService &ldquo;cluster&rdquo; Scripts to build the Docker image and launch a client environment to interact with a running cluster via Compose. Building the Docker image $ mvn clean package assembly:single -DskipTests $ cd ratis-logservice &amp;&amp; ./build-docker.sh The above will create a Docker image tagged a [...] </item> <item> @@ -74,10 +96,10 @@ The Ratis user mailing list is: user@ratis.</description> <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate> <guid>https://ratis.incubator.apache.org/getting_started.html</guid> - <description>Ratis is a Raft protocol library in Java. It&rsquo;s not a standalone server application like Zookeeper or Consul. + <description>Ratis is a Raft protocol library in Java. It's not a standalone server application like Zookeeper or Consul. Examples To demonstrate how to use Ratis from the code, Please look at the following examples. - Arithmetic example: This is a simple distributed calculator that replicates the values defined and allows user to perform arithmetic operations on these replicated values. - FileStore example: This is an example of using Ratis for reading and writing files.</description> + Arithmetic example: This is a simple distributed calculator that replicates the values defined and allows user to perform arithmetic operations on these replicated values. + FileStore example: This is an example of using Ratis for reading and writing files.</description> </item> <item> @@ -102,14 +124,14 @@ Like Ratis, the LogService is designed to be embedded into another application a <item> <title>LogService Security</title> - <link>https://ratis.incubator.apache.org/logservice/security/</link> + <link>https://ratis.incubator.apache.org/logservice/security.html</link> <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate> - <guid>https://ratis.incubator.apache.org/logservice/security/</guid> + <guid>https://ratis.incubator.apache.org/logservice/security.html</guid> <description>This document aims to describe what the intended security deployment model of the Ratis LogService. We will use integration into Apache HBase as an exemplar. Background TLS is technology capable of giving us &ldquo;strong authentication&rdquo; over network communication. One-way TLS can provide encrypted communication while two-way or &ldquo;mutual&rdquo; TLS can provide encrypted communication and authentication. -One feature of Ratis is that it is decoupled from the RPC transport in use.</description> +One feature of Ratis is that it is decoupled from the RPC transport in use. gRPC is the foremost transport, and can be configured to use one-way or two-way/mutual TLS.</description> </item> <item> diff --git a/logservice.html b/logservice.html index 5c62a69..b16c1e2 100644 --- a/logservice.html +++ b/logservice.html @@ -98,266 +98,179 @@ <h1 id="title"> Archive</h1> <ul id="list"> - <h1><a href="/logservice/lifecycle.html">Lifecycle</a></h1> + <h1><a href="/logservice/testing.html"></a></h1> <p><small>0001 Jan 1 </small></p> -<!--- - Licensed 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. See accompanying LICENSE file. ---> + + <h1><a href="/logservice/lifecycle.html">Lifecycle</a></h1> + <p><small>0001 Jan 1 </small></p> + <!-- raw HTML omitted --> +<!-- raw HTML omitted --> <p>The LogService is a system which manages a collection of logs. Each of these logs has a defined state which allows certain operations on that log or corresponds to actions that the system is taking on that log.</p> - <h3 id="open">OPEN</h3> - <p>This is the first state for a Log which is created in the LogService. A Log which is OPEN can be read from or written to. This Log has a corresponding Raft Group (a quorum of servers) who are participating in the hosting of this Log.</p> - <p>The only transition out from this state is to the CLOSED state.</p> - <h3 id="closed">CLOSED</h3> - <p>The CLOSED state indicates that a Log is no longer accepting writes. The Log is still available to be read from the Raft Group.</p> - <p>A log can be transitioned from OPEN to CLOSED via the client API, but it can also be done automatically by the LogService. When a node which was participating in the Raft Group for this Log becomes unreachable, we consider this Group to be unhealthy and proactively close it to prevent any additional writes which may block due to too few nodes to accept a write.</p> - <p>The transition from OPEN to CLOSED is one-way: a Log cannot transition back to the OPEN state from the CLOSED state. A CLOSED log may be deleted from the system.</p> - <p>From the CLOSED state, a log can be transitioned to the ARCHIVING state or the DELETED state.</p> - <h3 id="deleted">DELETED</h3> - <p>This is a simple state that is short lived. It tracks the clean up of any state from the hosting this Log. There are no transitions out of this state.</p> - <h3 id="archiving">ARCHIVING</h3> - <p>The ARCHIVING state is reached by the archive API call from the LogService client. An archival of a log is equivalent to an export of that log from the beginning of the log file to a known location. See below for a tangent on exporting versus archiving.</p> - <p>This state indicates that the LogService is in the process of copying all records in the Log from the starting offset of the archival request to the specified location (a user-provided location or a preconfigured location). We expect the location to be in some remote storage system such as HDFS or S3.</p> - <p>The only transition out from this state is to ARCHIVED.</p> - <h3 id="archived">ARCHIVED</h3> - <p>A Log can only reach the ARCHIVED state from the ARCHIVING state. This state is automatically transitioned into when the archival of a log is done in its entirety.</p> - <p>The action of archiving a log is an asynchronous process, managed by the leader of the Raft Group, thus watching for this state on a log indicates when the asynchronous archival is complete and the log can be safely read from the archived location.</p> - <p>The only transition out from this state is to DELETED.</p> - <h2 id="archive-and-export">Archive and Export</h2> - <p>The archive and export API calls are very similar in nature but have important distinctions in their implementation. As mentioned above, an archival of a log is an export of the entire log to a specific location.</p> - <p>An archival of a log is specification of export in that:</p> - <ul> <li>An archival of a log requires it to be CLOSED.</li> <li>An archived log cannot receive new writes.</li> </ul> - <p>An export of a log is more generic in that:</p> - <ul> <li>A log does not need to be CLOSED to be exported.</li> <li>A log can be repeatedly exported (e.g. to multiple locations).</li> <li>More data can be appended to a log that was exported (but new data would not be reflected in the exported version of the log).</li> </ul> - <h2 id="visualization">Visualization</h2> - -<p>To get a visual understanding of the log states, please see the image below: -<p> - <img src="lifecycle.svg" alt="Graphviz view of the logstates"/>“ -</p></p> +<p>To get a visual understanding of the log states, please see the image below:</p> +<!-- raw HTML omitted --> <h1><a href="/logservice/">LogService</a></h1> <p><small>0001 Jan 1 </small></p> - <!--- - Licensed 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. See accompanying LICENSE file. ---> - + <!-- raw HTML omitted --> +<!-- raw HTML omitted --> <p>The Ratis LogService is an distributed, log implementation built on top of Apache Ratis. The LogService is a “recipe” on top of Apache Ratis, providing a higher-level API as compared to Ratis itself. The LogService provides the ability to create named, durable, append-only data structures with the ability to perform linear reads.</p> - <p>Like Ratis, the LogService is designed to be embedded into another application as a library, as opposed to a standalone daemon. On a confusing note, there are Java daemons provided for the LogService, but these are solely to be used for testing.</p> - <ul> <li><a href="https://ratis.incubator.apache.org/logservice/testing/";>Testing</a></li> <li><a href="https://ratis.incubator.apache.org/logservice/lifecycle.html";>Log Lifecycle</a></li> -<li><a href="https://ratis.incubator.apache.org/logservice/security/";>Security</a></li> +<li><a href="https://ratis.incubator.apache.org/logservice/security.html";>Security</a></li> </ul> - <h1><a href="/logservice/security/">LogService Security</a></h1> + <h1><a href="/logservice/security.html">LogService Security</a></h1> <p><small>0001 Jan 1 </small></p> - - -<!--- - Licensed 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. See accompanying LICENSE file. ---> - + <!-- raw HTML omitted --> +<!-- raw HTML omitted --> <p>This document aims to describe what the intended security deployment model of the Ratis LogService.</p> - <p>We will use integration into Apache HBase as an exemplar.</p> - <h2 id="background">Background</h2> - <p>TLS is technology capable of giving us “strong authentication” over network communication. One-way TLS can provide encrypted communication while two-way or “mutual” TLS can provide encrypted communication and authentication.</p> - <p>One feature of Ratis is that it is decoupled from the RPC transport in use. gRPC is the foremost transport, and can be configured to use one-way or two-way/mutual TLS. gRPC is the only transport for Ratis which supports TLS today.</p> - <p>However, the majority of components under the “Hadoop Umbrella” rely on Kerberos to guarantee strong authentication. In this respect, use of TLS is jarring. However, gRPC does not support SPNEGO (which allows Kerberos authentication) which all but requires the use of two authentication mechanisms when combining Ratis with other projects (like HBase).</p> - <p>We anticipate the use of the Ratis LogService as an “embedded WAL” inside of HBase RegionServers and Masters will result in HBase services using Kerberos authentication to talk to HDFS as well as TLS for Ratis-internal communication (intra-server Ratis communication and client-server Ratis communication).</p> - <h2 id="mutual-tls">Mutual TLS</h2> - <p>Mutual TLS relies on a common certificate authority (CA) to issue all certificates which forms a circle of trust. Certificates generated by the same CA can be used to set up a mutual TLS connection. A certificate generated by one CA cannot be used to set up a mutal TLS connection to a service using a certificate generated by a different CA outside of the circle of trust. [1]</p> - <p>To control the clients and servers with one instance of the LogService, we want to use a single CA to generate certificates for clients and servers. We will consider this as an invariant going forward.</p> - <h2 id="hbase-examplar">HBase Examplar</h2> - <p>We expect the following material to be provided for every HBase service using Ratis:</p> - <ul> <li>File containing an X.509 certificate in PEM format</li> <li>File containing the PKCS private key in PEM format</li> <li>File containing the X.509 certificate for the CA</li> </ul> - <p>OpenSSL is capable of creating each of these; however, for this document, we will assume that you already have these pre-made. The server certificate and private key are unique to every host participating in the HBase cluster. The server certificate and truststore are not sensitive, but the private key is sensitive and should be protected like a password.</p> - <p>Every component in HBase using the Ratis LogService would need to ensure that each LogService StateMachine is configured to use the server keystore and truststore. The LogService state machines would need to constructed with the appropriate configuration options to specify this TLS material:</p> - -<pre><code class="language-java">RaftProperties properties = ...; - -GrpcConfigKeys.TLS.tlsEnabled(properties); -GrpcConfigKeys.TLS.mutualAuthnEnabled(properties); -properties.set(GrpcConfigKeys.TLS.PRIVATE_KEY_FILE_KEY, "/path/to/server-private-key.pem"); -properties.set(GrpcConfigKeys.TLS.TRUST_STORE_KEY, "/path/to/ca.crt"); -properties.set(GrpcConfigKeys.TLS.CERT_CHAIN_FILE_KEY, "/path/to/server.crt"); - -RaftServer.Builder builder = RaftServer.newBuilder(); -... -builder.setProperties(properties); - -RaftServer server = builder.build(); -</code></pre> - -<p>Clients to the StateMachine would construct a similar configuration:</p> - -<pre><code class="language-java">RaftProperties properties = ...; - -GrpcConfigKeys.TLS.tlsEnabled(properties); -GrpcConfigKeys.TLS.mutualAuthnEnabled(properties); -properties.set(GrpcConfigKeys.TLS.PRIVATE_KEY_FILE_KEY, "/path/to/client-private-key.pem"); -properties.set(GrpcConfigKeys.TLS.TRUST_STORE_KEY, "/path/to/ca.crt"); -properties.set(GrpcConfigKeys.TLS.CERT_CHAIN_FILE_KEY, "/path/to/client.crt"); - -RaftClient.Builder builder = RaftClient.newBuilder(); -... -builder.setProperties(properties); - -RaftClient client = builder.build(); -</code></pre> - -<p>With Mutual TLS, there is no notion of a “client” or “server” only certificate. In the above example code, +<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-java" data-lang="java">RaftProperties properties <span style="color:#f92672">=</span> <span style="color:#f92672">.</span><span style="color:#f92672">.</span><span style="color:#f92672">.</span><span style="color:#f92672">;</span> + +GrpcConfigKeys<span style="color:#f92672">.</span><span style="color:#a6e22e">TLS</span><span style="color:#f92672">.</span><span style="color:#a6e22e">tlsEnabled</span><span style="color:#f92672">(</span>properties<span style="color:#f92672">)</span><span style="color:#f92672">;</span> +GrpcConfigKeys<span style="color:#f92672">.</span><span style="color:#a6e22e">TLS</span><span style="color:#f92672">.</span><span style="color:#a6e22e">mutualAuthnEnabled</span><span style="color:#f92672">(</span>properties<span style="color:#f92672">)</span><span style="color:#f92672">;</span> +properties<span style="color:#f92672">.</span><span style="color:#a6e22e">set</span><span style="color:#f92672">(</span>GrpcConfigKeys<span style="color:#f92672">.</span><span style="color:#a6e22e">TLS</span><span style="color:#f92672">.</span><span style="color:#a6e22e">PRIVATE_KEY_FILE_KEY</span><span style="color:#f92672">,</span> <span style="color:#e6db74">"/path/to/server-private-key.pem"</span><span style="color:#f92672">)</span><span style="color:#f92672">;</span> +properties<span style="color:#f92672">.</span><span style="color:#a6e22e">set</span><span style="color:#f92672">(</span>GrpcConfigKeys<span style="color:#f92672">.</span><span style="color:#a6e22e">TLS</span><span style="color:#f92672">.</span><span style="color:#a6e22e">TRUST_STORE_KEY</span><span style="color:#f92672">,</span> <span style="color:#e6db74">"/path/to/ca.crt"</span><span style="color:#f92672">)</span><span style="color:#f92672">;</span> +properties<span style="color:#f92672">.</span><span style="color:#a6e22e">set</span><span style="color:#f92672">(</span>GrpcConfigKeys<span style="color:#f92672">.</span><span style="color:#a6e22e">TLS</span><span style="color:#f92672">.</span><span style="color:#a6e22e">CERT_CHAIN_FILE_KEY</span><span style="color:#f92672">,</span> <span style="color:#e6db74">"/path/to/server.crt"</span><span style="color:#f92672">)</span><span style="color:#f92672">;</span> + +RaftServer<span style="color:#f92672">.</span><span style="color:#a6e22e">Builder</span> builder <span style="color:#f92672">=</span> RaftServer<span style="color:#f92672">.</span><span style="color:#a6e22e">newBuilder</span><span style="color:#f92672">(</span><span style="color:#f92672">)</span><span style="color:#f92672">;</span> +<span style="color:#f92672">.</span><span style="color:#f92672">.</span><span style="color:#f92672">.</span> +builder<span style="color:#f92672">.</span><span style="color:#a6e22e">setProperties</span><span style="color:#f92672">(</span>properties<span style="color:#f92672">)</span><span style="color:#f92672">;</span> + +RaftServer server <span style="color:#f92672">=</span> builder<span style="color:#f92672">.</span><span style="color:#a6e22e">build</span><span style="color:#f92672">(</span><span style="color:#f92672">)</span><span style="color:#f92672">;</span> +</code></pre></div><p>Clients to the StateMachine would construct a similar configuration:</p> +<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-java" data-lang="java">RaftProperties properties <span style="color:#f92672">=</span> <span style="color:#f92672">.</span><span style="color:#f92672">.</span><span style="color:#f92672">.</span><span style="color:#f92672">;</span> + +GrpcConfigKeys<span style="color:#f92672">.</span><span style="color:#a6e22e">TLS</span><span style="color:#f92672">.</span><span style="color:#a6e22e">tlsEnabled</span><span style="color:#f92672">(</span>properties<span style="color:#f92672">)</span><span style="color:#f92672">;</span> +GrpcConfigKeys<span style="color:#f92672">.</span><span style="color:#a6e22e">TLS</span><span style="color:#f92672">.</span><span style="color:#a6e22e">mutualAuthnEnabled</span><span style="color:#f92672">(</span>properties<span style="color:#f92672">)</span><span style="color:#f92672">;</span> +properties<span style="color:#f92672">.</span><span style="color:#a6e22e">set</span><span style="color:#f92672">(</span>GrpcConfigKeys<span style="color:#f92672">.</span><span style="color:#a6e22e">TLS</span><span style="color:#f92672">.</span><span style="color:#a6e22e">PRIVATE_KEY_FILE_KEY</span><span style="color:#f92672">,</span> <span style="color:#e6db74">"/path/to/client-private-key.pem"</span><span style="color:#f92672">)</span><span style="color:#f92672">;</span> +properties<span style="color:#f92672">.</span><span style="color:#a6e22e">set</span><span style="color:#f92672">(</span>GrpcConfigKeys<span style="color:#f92672">.</span><span style="color:#a6e22e">TLS</span><span style="color:#f92672">.</span><span style="color:#a6e22e">TRUST_STORE_KEY</span><span style="color:#f92672">,</span> <span style="color:#e6db74">"/path/to/ca.crt"</span><span style="color:#f92672">)</span><span style="color:#f92672">;</span> +properties<span style="color:#f92672">.</span><span style="color:#a6e22e">set</span><span style="color:#f92672">(</span>GrpcConfigKeys<span style="color:#f92672">.</span><span style="color:#a6e22e">TLS</span><span style="color:#f92672">.</span><span style="color:#a6e22e">CERT_CHAIN_FILE_KEY</span><span style="color:#f92672">,</span> <span style="color:#e6db74">"/path/to/client.crt"</span><span style="color:#f92672">)</span><span style="color:#f92672">;</span> + +RaftClient<span style="color:#f92672">.</span><span style="color:#a6e22e">Builder</span> builder <span style="color:#f92672">=</span> RaftClient<span style="color:#f92672">.</span><span style="color:#a6e22e">newBuilder</span><span style="color:#f92672">(</span><span style="color:#f92672">)</span><span style="color:#f92672">;</span> +<span style="color:#f92672">.</span><span style="color:#f92672">.</span><span style="color:#f92672">.</span> +builder<span style="color:#f92672">.</span><span style="color:#a6e22e">setProperties</span><span style="color:#f92672">(</span>properties<span style="color:#f92672">)</span><span style="color:#f92672">;</span> + +RaftClient client <span style="color:#f92672">=</span> builder<span style="color:#f92672">.</span><span style="color:#a6e22e">build</span><span style="color:#f92672">(</span><span style="color:#f92672">)</span><span style="color:#f92672">;</span> +</code></pre></div><p>With Mutual TLS, there is no notion of a “client” or “server” only certificate. In the above example code, as long as the certificate and private key are generated using the same certificate authority, any should function.</p> - <p>For the LogService, this client setup would be hidden behind the facade of the LogService client API.</p> - <p>The HBase WALProvider implementation that uses the Ratis LogService would be providing the location of this TLS material via the HBase configuration (hbase-site.xml), passing it down into the WALProvider implementation. As the WALProvider is the broker that doles out readers and writers, and would also, presumably manage the creation of the StateMachines, it can set up the proper Ratis configuration from the HBase configuration.</p> - -<p>[1] There are scenarios with shared trust across CA’s that enable other scenarios but these are ignored for the purpose +<p>[1] There are scenarios with shared trust across CA's that enable other scenarios but these are ignored for the purpose of this document.</p> @@ -366,6 +279,7 @@ of this document.</p> </div> + </section> </div> @@ -373,7 +287,7 @@ of this document.</p> <div class="container"> <div class="col-md-12 trademark"> - <p>© 2019 <a href="http://apache.org";>The Apache Software Foundation</a>, + <p>© 2020 <a href="http://apache.org";>The Apache Software Foundation</a>, Apache, Apache Ratis, the Apache feather logo, Apache Ratis logo, Apache Incubator logo are trademarks of The Apache Software Foundation. <p> </div> diff --git a/logservice/index.html b/logservice/index.html index 6cba5b5..61d83db 100644 --- a/logservice/index.html +++ b/logservice/index.html @@ -93,33 +93,19 @@ <div class="container"> <h1>LogService</h1> -<!--- - Licensed 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. See accompanying LICENSE file. ---> - +<!-- raw HTML omitted --> +<!-- raw HTML omitted --> <p>The Ratis LogService is an distributed, log implementation built on top of Apache Ratis. The LogService is a “recipe” on top of Apache Ratis, providing a higher-level API as compared to Ratis itself. The LogService provides the ability to create named, durable, append-only data structures with the ability to perform linear reads.</p> - <p>Like Ratis, the LogService is designed to be embedded into another application as a library, as opposed to a standalone daemon. On a confusing note, there are Java daemons provided for the LogService, but these are solely to be used for testing.</p> - <ul> <li><a href="https://ratis.incubator.apache.org/logservice/testing/";>Testing</a></li> <li><a href="https://ratis.incubator.apache.org/logservice/lifecycle.html";>Log Lifecycle</a></li> -<li><a href="https://ratis.incubator.apache.org/logservice/security/";>Security</a></li> +<li><a href="https://ratis.incubator.apache.org/logservice/security.html";>Security</a></li> </ul> </div> @@ -128,7 +114,7 @@ daemons provided for the LogService, but these are solely to be used for testing <div class="container"> <div class="col-md-12 trademark"> - <p>© 2019 <a href="http://apache.org";>The Apache Software Foundation</a>, + <p>© 2020 <a href="http://apache.org";>The Apache Software Foundation</a>, Apache, Apache Ratis, the Apache feather logo, Apache Ratis logo, Apache Incubator logo are trademarks of The Apache Software Foundation. <p> </div> diff --git a/logservice/index.xml b/logservice/index.xml index f40c922..000a406 100644 --- a/logservice/index.xml +++ b/logservice/index.xml @@ -1,4 +1,4 @@ -<?xml version="1.0" encoding="utf-8" standalone="yes" ?> +<?xml version="1.0" encoding="utf-8" standalone="yes"?> <rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom";> <channel> <title>Apache Ratis</title> @@ -32,14 +32,14 @@ Like Ratis, the LogService is designed to be embedded into another application a <item> <title>LogService Security</title> - <link>https://ratis.incubator.apache.org/logservice/security/</link> + <link>https://ratis.incubator.apache.org/logservice/security.html</link> <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate> - <guid>https://ratis.incubator.apache.org/logservice/security/</guid> + <guid>https://ratis.incubator.apache.org/logservice/security.html</guid> <description>This document aims to describe what the intended security deployment model of the Ratis LogService. We will use integration into Apache HBase as an exemplar. Background TLS is technology capable of giving us &ldquo;strong authentication&rdquo; over network communication. One-way TLS can provide encrypted communication while two-way or &ldquo;mutual&rdquo; TLS can provide encrypted communication and authentication. -One feature of Ratis is that it is decoupled from the RPC transport in use.</description> +One feature of Ratis is that it is decoupled from the RPC transport in use. gRPC is the foremost transport, and can be configured to use one-way or two-way/mutual TLS.</description> </item> </channel> diff --git a/logservice/lifecycle.html b/logservice/lifecycle.html index b8931de..b706d61 100644 --- a/logservice/lifecycle.html +++ b/logservice/lifecycle.html @@ -93,113 +93,71 @@ <div class="container"> <h1>Lifecycle</h1> - - -<!--- - Licensed 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. See accompanying LICENSE file. ---> - +<!-- raw HTML omitted --> +<!-- raw HTML omitted --> <p>The LogService is a system which manages a collection of logs. Each of these logs has a defined state which allows certain operations on that log or corresponds to actions that the system is taking on that log.</p> - <h3 id="open">OPEN</h3> - <p>This is the first state for a Log which is created in the LogService. A Log which is OPEN can be read from or written to. This Log has a corresponding Raft Group (a quorum of servers) who are participating in the hosting of this Log.</p> - <p>The only transition out from this state is to the CLOSED state.</p> - <h3 id="closed">CLOSED</h3> - <p>The CLOSED state indicates that a Log is no longer accepting writes. The Log is still available to be read from the Raft Group.</p> - <p>A log can be transitioned from OPEN to CLOSED via the client API, but it can also be done automatically by the LogService. When a node which was participating in the Raft Group for this Log becomes unreachable, we consider this Group to be unhealthy and proactively close it to prevent any additional writes which may block due to too few nodes to accept a write.</p> - <p>The transition from OPEN to CLOSED is one-way: a Log cannot transition back to the OPEN state from the CLOSED state. A CLOSED log may be deleted from the system.</p> - <p>From the CLOSED state, a log can be transitioned to the ARCHIVING state or the DELETED state.</p> - <h3 id="deleted">DELETED</h3> - <p>This is a simple state that is short lived. It tracks the clean up of any state from the hosting this Log. There are no transitions out of this state.</p> - <h3 id="archiving">ARCHIVING</h3> - <p>The ARCHIVING state is reached by the archive API call from the LogService client. An archival of a log is equivalent to an export of that log from the beginning of the log file to a known location. See below for a tangent on exporting versus archiving.</p> - <p>This state indicates that the LogService is in the process of copying all records in the Log from the starting offset of the archival request to the specified location (a user-provided location or a preconfigured location). We expect the location to be in some remote storage system such as HDFS or S3.</p> - <p>The only transition out from this state is to ARCHIVED.</p> - <h3 id="archived">ARCHIVED</h3> - <p>A Log can only reach the ARCHIVED state from the ARCHIVING state. This state is automatically transitioned into when the archival of a log is done in its entirety.</p> - <p>The action of archiving a log is an asynchronous process, managed by the leader of the Raft Group, thus watching for this state on a log indicates when the asynchronous archival is complete and the log can be safely read from the archived location.</p> - <p>The only transition out from this state is to DELETED.</p> - <h2 id="archive-and-export">Archive and Export</h2> - <p>The archive and export API calls are very similar in nature but have important distinctions in their implementation. As mentioned above, an archival of a log is an export of the entire log to a specific location.</p> - <p>An archival of a log is specification of export in that:</p> - <ul> <li>An archival of a log requires it to be CLOSED.</li> <li>An archived log cannot receive new writes.</li> </ul> - <p>An export of a log is more generic in that:</p> - <ul> <li>A log does not need to be CLOSED to be exported.</li> <li>A log can be repeatedly exported (e.g. to multiple locations).</li> <li>More data can be appended to a log that was exported (but new data would not be reflected in the exported version of the log).</li> </ul> - <h2 id="visualization">Visualization</h2> - -<p>To get a visual understanding of the log states, please see the image below: -<p> - <img src="lifecycle.svg" alt="Graphviz view of the logstates"/>“ -</p></p> +<p>To get a visual understanding of the log states, please see the image below:</p> +<!-- raw HTML omitted --> </div> @@ -207,7 +165,7 @@ an archival of a log is an export of the entire log to a specific location.</p> <div class="container"> <div class="col-md-12 trademark"> - <p>© 2019 <a href="http://apache.org";>The Apache Software Foundation</a>, + <p>© 2020 <a href="http://apache.org";>The Apache Software Foundation</a>, Apache, Apache Ratis, the Apache feather logo, Apache Ratis logo, Apache Incubator logo are trademarks of The Apache Software Foundation. <p> </div> diff --git a/logservice/security.html b/logservice/security.html new file mode 100644 index 0000000..b3b1581 --- /dev/null +++ b/logservice/security.html @@ -0,0 +1,194 @@ + +<!DOCTYPE html> + +<html> + +<head> + <meta charset="utf-8"> + <meta http-equiv="X-UA-Compatible" content="IE=edge"> + <meta name="viewport" content="width=device-width, initial-scale=1"> + <meta name="description" content="Open source Java implementation for RAFT consensus protocol."> + <meta name="keywords" content="raft, java, ratis, library"/> + <meta name="robots" content="index,follow"/> + <meta name="language" content="en"/> + + <title>Apache Ratis</title> + + <base href="https://ratis.incubator.apache.org/";> + + <link rel="canonical" href="http://ratis.incubator.apache.org/";> + + <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.6/css/bootstrap.min.css"; + integrity="sha384-1q8mTJOASx8j1Au+a5WDVnPi2lkFfwwEAa8hDDdjZlpLegxhjVME1fgjWPGmkzs7" crossorigin="anonymous"> + <link rel="stylesheet" href="style.css"> + +</head> + +<body> + + +<div class="topnav"> + <div class="container"> + <ul class="breadcrumb col-md-6"> + <li> + <img class="asf-logo" src="asf_feather.png" alt="ASF feather"/> + <a href="https://www.apache.org";>Apache Software Foundation</a> + </li> + <li> + <img class="asf-logo" src="logo-white.png" alt="Ratis logo"/> + <a href="https://ratis.incubator.apache.org/";>Apache Ratis™</a> + </li> + </ul> + <div class="col-md-6"> + <ul class="pull-right breadcrumb"> + <li><a href="http://www.apache.org/licenses/";>License</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> + <li><a href="http://www.apache.org/security/";>Security</a></li> + </ul> + </div> + </div> + + <nav class="navbar navbar-default navbar-static-top" role="navigation"> + <div class="container"> + <div class="navbar-header"> + <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" + data-target="#ratis-menu" aria-expanded="false"> + <span class="sr-only">Toggle navigation</span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + </button> + </div> + + <div id="ratis-menu" class="collapse navbar-collapse"> + <ul class="nav navbar-nav navbar-right"> + <li><a href="#download">Download</a></li> + <li><a href="#gettingstarted">Getting started</a></li> + <li><a href="#source">Source</a></li> + <li><a href="#community">Community</a></li> + <li><a href="#resources">Resources</a></li> + </ul> + </div> + + + <div class="jumbotron"> + <h1> + Open source Java implementation for Raft consensus protocol. + </h1> + <p> + <a class="btn btn-default download" role="button" href="#download">Download Apache Ratis</a> + </p> + <p> + + <a class="changelog" + href="#gettingstarted">Getting started + </a> + </p> + </div> + </div> + + </nav> +</div> + +<div class="container"> +<h1>LogService Security</h1> +<!-- raw HTML omitted --> +<!-- raw HTML omitted --> +<p>This document aims to describe what the intended security deployment model of the Ratis LogService.</p> +<p>We will use integration into Apache HBase as an exemplar.</p> +<h2 id="background">Background</h2> +<p>TLS is technology capable of giving us “strong authentication” over network communication. One-way TLS can provide +encrypted communication while two-way or “mutual” TLS can provide encrypted communication and authentication.</p> +<p>One feature of Ratis is that it is decoupled from the RPC transport in use. gRPC is the foremost transport, and +can be configured to use one-way or two-way/mutual TLS. gRPC is the only transport for Ratis which +supports TLS today.</p> +<p>However, the majority of components under the “Hadoop Umbrella” rely on Kerberos to guarantee strong authentication. +In this respect, use of TLS is jarring. However, gRPC does not support SPNEGO (which allows Kerberos authentication) +which all but requires the use of two authentication mechanisms when combining Ratis with other projects (like HBase).</p> +<p>We anticipate the use of the Ratis LogService as an “embedded WAL” inside of HBase RegionServers and Masters +will result in HBase services using Kerberos authentication to talk to HDFS as well as TLS for Ratis-internal +communication (intra-server Ratis communication and client-server Ratis communication).</p> +<h2 id="mutual-tls">Mutual TLS</h2> +<p>Mutual TLS relies on a common certificate authority (CA) to issue all certificates which forms a circle +of trust. Certificates generated by the same CA can be used to set up a mutual TLS connection. A certificate +generated by one CA cannot be used to set up a mutal TLS connection to a service using a certificate +generated by a different CA outside of the circle of trust. [1]</p> +<p>To control the clients and servers with one instance of the LogService, we want to use a single CA to generate +certificates for clients and servers. We will consider this as an invariant going forward.</p> +<h2 id="hbase-examplar">HBase Examplar</h2> +<p>We expect the following material to be provided for every HBase service using Ratis:</p> +<ul> +<li>File containing an X.509 certificate in PEM format</li> +<li>File containing the PKCS private key in PEM format</li> +<li>File containing the X.509 certificate for the CA</li> +</ul> +<p>OpenSSL is capable of creating each of these; however, for this document, we will assume +that you already have these pre-made. The server certificate and private key are unique to every +host participating in the HBase cluster. The server certificate and truststore are not sensitive, +but the private key is sensitive and should be protected like a password.</p> +<p>Every component in HBase using the Ratis LogService would need to ensure that each LogService StateMachine is +configured to use the server keystore and truststore. The LogService state machines would need to constructed +with the appropriate configuration options to specify this TLS material:</p> +<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-java" data-lang="java">RaftProperties properties <span style="color:#f92672">=</span> <span style="color:#f92672">.</span><span style="color:#f92672">.</span><span style="color:#f92672">.</span><span style="color:#f92672">;</span> + +GrpcConfigKeys<span style="color:#f92672">.</span><span style="color:#a6e22e">TLS</span><span style="color:#f92672">.</span><span style="color:#a6e22e">tlsEnabled</span><span style="color:#f92672">(</span>properties<span style="color:#f92672">)</span><span style="color:#f92672">;</span> +GrpcConfigKeys<span style="color:#f92672">.</span><span style="color:#a6e22e">TLS</span><span style="color:#f92672">.</span><span style="color:#a6e22e">mutualAuthnEnabled</span><span style="color:#f92672">(</span>properties<span style="color:#f92672">)</span><span style="color:#f92672">;</span> +properties<span style="color:#f92672">.</span><span style="color:#a6e22e">set</span><span style="color:#f92672">(</span>GrpcConfigKeys<span style="color:#f92672">.</span><span style="color:#a6e22e">TLS</span><span style="color:#f92672">.</span><span style="color:#a6e22e">PRIVATE_KEY_FILE_KEY</span><span style="color:#f92672">,</span> <span style="color:#e6db74">"/path/to/server-private-key.pem"</span><span style="color:#f92672">)</span><span style="color:#f92672">;</span> +properties<span style="color:#f92672">.</span><span style="color:#a6e22e">set</span><span style="color:#f92672">(</span>GrpcConfigKeys<span style="color:#f92672">.</span><span style="color:#a6e22e">TLS</span><span style="color:#f92672">.</span><span style="color:#a6e22e">TRUST_STORE_KEY</span><span style="color:#f92672">,</span> <span style="color:#e6db74">"/path/to/ca.crt"</span><span style="color:#f92672">)</span><span style="color:#f92672">;</span> +properties<span style="color:#f92672">.</span><span style="color:#a6e22e">set</span><span style="color:#f92672">(</span>GrpcConfigKeys<span style="color:#f92672">.</span><span style="color:#a6e22e">TLS</span><span style="color:#f92672">.</span><span style="color:#a6e22e">CERT_CHAIN_FILE_KEY</span><span style="color:#f92672">,</span> <span style="color:#e6db74">"/path/to/server.crt"</span><span style="color:#f92672">)</span><span style="color:#f92672">;</span> + +RaftServer<span style="color:#f92672">.</span><span style="color:#a6e22e">Builder</span> builder <span style="color:#f92672">=</span> RaftServer<span style="color:#f92672">.</span><span style="color:#a6e22e">newBuilder</span><span style="color:#f92672">(</span><span style="color:#f92672">)</span><span style="color:#f92672">;</span> +<span style="color:#f92672">.</span><span style="color:#f92672">.</span><span style="color:#f92672">.</span> +builder<span style="color:#f92672">.</span><span style="color:#a6e22e">setProperties</span><span style="color:#f92672">(</span>properties<span style="color:#f92672">)</span><span style="color:#f92672">;</span> + +RaftServer server <span style="color:#f92672">=</span> builder<span style="color:#f92672">.</span><span style="color:#a6e22e">build</span><span style="color:#f92672">(</span><span style="color:#f92672">)</span><span style="color:#f92672">;</span> +</code></pre></div><p>Clients to the StateMachine would construct a similar configuration:</p> +<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-java" data-lang="java">RaftProperties properties <span style="color:#f92672">=</span> <span style="color:#f92672">.</span><span style="color:#f92672">.</span><span style="color:#f92672">.</span><span style="color:#f92672">;</span> + +GrpcConfigKeys<span style="color:#f92672">.</span><span style="color:#a6e22e">TLS</span><span style="color:#f92672">.</span><span style="color:#a6e22e">tlsEnabled</span><span style="color:#f92672">(</span>properties<span style="color:#f92672">)</span><span style="color:#f92672">;</span> +GrpcConfigKeys<span style="color:#f92672">.</span><span style="color:#a6e22e">TLS</span><span style="color:#f92672">.</span><span style="color:#a6e22e">mutualAuthnEnabled</span><span style="color:#f92672">(</span>properties<span style="color:#f92672">)</span><span style="color:#f92672">;</span> +properties<span style="color:#f92672">.</span><span style="color:#a6e22e">set</span><span style="color:#f92672">(</span>GrpcConfigKeys<span style="color:#f92672">.</span><span style="color:#a6e22e">TLS</span><span style="color:#f92672">.</span><span style="color:#a6e22e">PRIVATE_KEY_FILE_KEY</span><span style="color:#f92672">,</span> <span style="color:#e6db74">"/path/to/client-private-key.pem"</span><span style="color:#f92672">)</span><span style="color:#f92672">;</span> +properties<span style="color:#f92672">.</span><span style="color:#a6e22e">set</span><span style="color:#f92672">(</span>GrpcConfigKeys<span style="color:#f92672">.</span><span style="color:#a6e22e">TLS</span><span style="color:#f92672">.</span><span style="color:#a6e22e">TRUST_STORE_KEY</span><span style="color:#f92672">,</span> <span style="color:#e6db74">"/path/to/ca.crt"</span><span style="color:#f92672">)</span><span style="color:#f92672">;</span> +properties<span style="color:#f92672">.</span><span style="color:#a6e22e">set</span><span style="color:#f92672">(</span>GrpcConfigKeys<span style="color:#f92672">.</span><span style="color:#a6e22e">TLS</span><span style="color:#f92672">.</span><span style="color:#a6e22e">CERT_CHAIN_FILE_KEY</span><span style="color:#f92672">,</span> <span style="color:#e6db74">"/path/to/client.crt"</span><span style="color:#f92672">)</span><span style="color:#f92672">;</span> + +RaftClient<span style="color:#f92672">.</span><span style="color:#a6e22e">Builder</span> builder <span style="color:#f92672">=</span> RaftClient<span style="color:#f92672">.</span><span style="color:#a6e22e">newBuilder</span><span style="color:#f92672">(</span><span style="color:#f92672">)</span><span style="color:#f92672">;</span> +<span style="color:#f92672">.</span><span style="color:#f92672">.</span><span style="color:#f92672">.</span> +builder<span style="color:#f92672">.</span><span style="color:#a6e22e">setProperties</span><span style="color:#f92672">(</span>properties<span style="color:#f92672">)</span><span style="color:#f92672">;</span> + +RaftClient client <span style="color:#f92672">=</span> builder<span style="color:#f92672">.</span><span style="color:#a6e22e">build</span><span style="color:#f92672">(</span><span style="color:#f92672">)</span><span style="color:#f92672">;</span> +</code></pre></div><p>With Mutual TLS, there is no notion of a “client” or “server” only certificate. In the above example code, +as long as the certificate and private key are generated using the same certificate authority, any +should function.</p> +<p>For the LogService, this client setup would be hidden behind the facade of the LogService client API.</p> +<p>The HBase WALProvider implementation that uses the Ratis LogService would be providing the location of +this TLS material via the HBase configuration (hbase-site.xml), passing it down into the WALProvider +implementation. As the WALProvider is the broker that doles out readers and writers, and would also, presumably +manage the creation of the StateMachines, it can set up the proper Ratis configuration from the HBase configuration.</p> +<p>[1] There are scenarios with shared trust across CA's that enable other scenarios but these are ignored for the purpose +of this document.</p> + +</div> + +<footer> + <div class="container"> + + <div class="col-md-12 trademark"> + <p>© 2020 <a href="http://apache.org";>The Apache Software Foundation</a>, + Apache, Apache Ratis, the Apache feather logo, Apache Ratis logo, Apache Incubator logo are trademarks of The Apache Software Foundation. + <p> + </div> + </div> +</footer> + + +<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.3/jquery.min.js";></script> +<script src="./js/underscore-min.js"></script> +<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.6/js/bootstrap.min.js"; + integrity="sha384-0mSbJDEHialfmuBBQP6A4Qrprq5OVfW37PRR3j5ELqxss1yVqOtnepnHVP9aJ7xS" + crossorigin="anonymous"></script> + + +</body> +</html> + diff --git a/logservice/testing.html b/logservice/testing.html index 0409db6..8a31217 100644 --- a/logservice/testing.html +++ b/logservice/testing.html @@ -101,64 +101,34 @@ <h1><a href="/logservice/testing/docker.html">Docker Testing</a></h1> <p><small>0001 Jan 1 </small></p> - - -<!--- - Licensed 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. See accompanying LICENSE file. ---> - + <!-- raw HTML omitted --> +<!-- raw HTML omitted --> <p>The Docker orchestration is comprised of the following:</p> - <ol> <li>A Docker image which has the necessary software to run the LogService</li> <li>A docker-compose.yml file which can launch the necessary containers for a full-fledged LogService “cluster”</li> <li>Scripts to build the Docker image and launch a client environment to interact with a running cluster via Compose.</li> </ol> - <h2 id="building-the-docker-image">Building the Docker image</h2> - -<pre><code class="language-bash">$ mvn clean package assembly:single -DskipTests -$ cd ratis-logservice && ./build-docker.sh -</code></pre> - -<p>The above will create a Docker image tagged as <code>ratis-logservice:latest</code>.</p> - +<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">$ mvn clean package assembly:single -DskipTests +$ cd ratis-logservice <span style="color:#f92672">&&</span> ./build-docker.sh +</code></pre></div><p>The above will create a Docker image tagged as <code>ratis-logservice:latest</code>.</p> <h2 id="launching-a-cluster-via-compose">Launching a cluster via Compose</h2> - -<pre><code class="language-bash">$ docker-compose up -d -</code></pre> - -<p>The Compose orchestration will launch three MetadataServer containers and three +<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">$ docker-compose up -d +</code></pre></div><p>The Compose orchestration will launch three MetadataServer containers and three Worker containers, all on the same Docker network. The <code>-d</code> option detaches the container logs from your current shell.</p> - <h2 id="connecting-a-client">Connecting a client</h2> - -<pre><code class="language-bash">$ ./client-env.sh +<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">$ ./client-env.sh $ ./bin/shell <...> $ ./bin/load-test <...> -</code></pre> - -<p>The <code>client-env.sh</code> script will launch a Docker container which is on the same +</code></pre></div><p>The <code>client-env.sh</code> script will launch a Docker container which is on the same network as our cluster running in Compose.</p> - <h2 id="debugging-the-cluster">Debugging the cluster</h2> - <p>Use <code>docker logs</code> to inspect the output from a specific container. You must pass the name of the container (obtained via <code>docker-compose ps</code> or <code>docker ps</code>) to <code>docker logs</code>.</p> - <p>You can also “attach” to a container via <code>docker exec</code> to inspect the environment in which the process is running. Again, using the name of a container obtained as described above, use <code>docker exec -it <name> /bin/sh</code> to attach to the container.</p> @@ -168,27 +138,13 @@ described above, use <code>docker exec -it <name> /bin/sh</code> to attach <h1><a href="/logservice/testing/">LogService Testing</a></h1> <p><small>0001 Jan 1 </small></p> - <!--- - Licensed 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. See accompanying LICENSE file. ---> - + <!-- raw HTML omitted --> +<!-- raw HTML omitted --> <p>The LogService presently has two means for testing itself: Docker with Compose orchestration and VirtualBox with Vagrant orchestration.</p> - <p>Docker is suitable for a quick and lightweight orchestration of a full LogService installation. Vagrant, while heavier-weight that the Docker automation, has the added benefit of being able to leverage <a href="http://osrg.github.io/namazu/";>Namazu</a> for failure scenarios. Please find more on each using the below references.</p> - <ul> <li><a href="https://ratis.incubator.apache.org/logservice/testing/docker.html";>Docker</a></li> <li><a href="https://ratis.incubator.apache.org/logservice/testing/vagrant.html";>Vagrant</a></li> @@ -199,24 +155,10 @@ scenarios. Please find more on each using the below references.</p> <h1><a href="/logservice/testing/vagrant.html">Vagrant Testing</a></h1> <p><small>0001 Jan 1 </small></p> - <!--- - Licensed 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. See accompanying LICENSE file. ---> - + <!-- raw HTML omitted --> +<!-- raw HTML omitted --> <p>Please refer to the <a href="https://github.com/apache/incubator-ratis/blob/master/dev-support/vagrant/README.md";>documentation</a> for instructions to use the Vagrant automation.</p> - <p>Starting from the directory <code>dev-support/vagrant/</code>:</p> - <ul> <li>To build all Vagrant boxes, invoke <code>./run_all_tests.sh build</code></li> <li>To remove any generated data, invoke <code>./run_all_tests.sh clean</code></li> @@ -229,6 +171,7 @@ scenarios. Please find more on each using the below references.</p> </div> + </section> </div> @@ -236,7 +179,7 @@ scenarios. Please find more on each using the below references.</p> <div class="container"> <div class="col-md-12 trademark"> - <p>© 2019 <a href="http://apache.org";>The Apache Software Foundation</a>, + <p>© 2020 <a href="http://apache.org";>The Apache Software Foundation</a>, Apache, Apache Ratis, the Apache feather logo, Apache Ratis logo, Apache Incubator logo are trademarks of The Apache Software Foundation. <p> </div> diff --git a/logservice/testing/docker.html b/logservice/testing/docker.html index 2b8d93f..6401e07 100644 --- a/logservice/testing/docker.html +++ b/logservice/testing/docker.html @@ -93,64 +93,34 @@ <div class="container"> <h1>Docker Testing</h1> - - -<!--- - Licensed 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. See accompanying LICENSE file. ---> - +<!-- raw HTML omitted --> +<!-- raw HTML omitted --> <p>The Docker orchestration is comprised of the following:</p> - <ol> <li>A Docker image which has the necessary software to run the LogService</li> <li>A docker-compose.yml file which can launch the necessary containers for a full-fledged LogService “cluster”</li> <li>Scripts to build the Docker image and launch a client environment to interact with a running cluster via Compose.</li> </ol> - <h2 id="building-the-docker-image">Building the Docker image</h2> - -<pre><code class="language-bash">$ mvn clean package assembly:single -DskipTests -$ cd ratis-logservice && ./build-docker.sh -</code></pre> - -<p>The above will create a Docker image tagged as <code>ratis-logservice:latest</code>.</p> - +<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">$ mvn clean package assembly:single -DskipTests +$ cd ratis-logservice <span style="color:#f92672">&&</span> ./build-docker.sh +</code></pre></div><p>The above will create a Docker image tagged as <code>ratis-logservice:latest</code>.</p> <h2 id="launching-a-cluster-via-compose">Launching a cluster via Compose</h2> - -<pre><code class="language-bash">$ docker-compose up -d -</code></pre> - -<p>The Compose orchestration will launch three MetadataServer containers and three +<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">$ docker-compose up -d +</code></pre></div><p>The Compose orchestration will launch three MetadataServer containers and three Worker containers, all on the same Docker network. The <code>-d</code> option detaches the container logs from your current shell.</p> - <h2 id="connecting-a-client">Connecting a client</h2> - -<pre><code class="language-bash">$ ./client-env.sh +<div class="highlight"><pre style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4"><code class="language-bash" data-lang="bash">$ ./client-env.sh $ ./bin/shell <...> $ ./bin/load-test <...> -</code></pre> - -<p>The <code>client-env.sh</code> script will launch a Docker container which is on the same +</code></pre></div><p>The <code>client-env.sh</code> script will launch a Docker container which is on the same network as our cluster running in Compose.</p> - <h2 id="debugging-the-cluster">Debugging the cluster</h2> - <p>Use <code>docker logs</code> to inspect the output from a specific container. You must pass the name of the container (obtained via <code>docker-compose ps</code> or <code>docker ps</code>) to <code>docker logs</code>.</p> - <p>You can also “attach” to a container via <code>docker exec</code> to inspect the environment in which the process is running. Again, using the name of a container obtained as described above, use <code>docker exec -it <name> /bin/sh</code> to attach to the container.</p> @@ -161,7 +131,7 @@ described above, use <code>docker exec -it <name> /bin/sh</code> to attach <div class="container"> <div class="col-md-12 trademark"> - <p>© 2019 <a href="http://apache.org";>The Apache Software Foundation</a>, + <p>© 2020 <a href="http://apache.org";>The Apache Software Foundation</a>, Apache, Apache Ratis, the Apache feather logo, Apache Ratis logo, Apache Incubator logo are trademarks of The Apache Software Foundation. <p> </div> diff --git a/logservice/testing/index.html b/logservice/testing/index.html index a5ecf60..0d51e0c 100644 --- a/logservice/testing/index.html +++ b/logservice/testing/index.html @@ -93,27 +93,13 @@ <div class="container"> <h1>LogService Testing</h1> -<!--- - Licensed 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. See accompanying LICENSE file. ---> - +<!-- raw HTML omitted --> +<!-- raw HTML omitted --> <p>The LogService presently has two means for testing itself: Docker with Compose orchestration and VirtualBox with Vagrant orchestration.</p> - <p>Docker is suitable for a quick and lightweight orchestration of a full LogService installation. Vagrant, while heavier-weight that the Docker automation, has the added benefit of being able to leverage <a href="http://osrg.github.io/namazu/";>Namazu</a> for failure scenarios. Please find more on each using the below references.</p> - <ul> <li><a href="https://ratis.incubator.apache.org/logservice/testing/docker.html";>Docker</a></li> <li><a href="https://ratis.incubator.apache.org/logservice/testing/vagrant.html";>Vagrant</a></li> @@ -125,7 +111,7 @@ scenarios. Please find more on each using the below references.</p> <div class="container"> <div class="col-md-12 trademark"> - <p>© 2019 <a href="http://apache.org";>The Apache Software Foundation</a>, + <p>© 2020 <a href="http://apache.org";>The Apache Software Foundation</a>, Apache, Apache Ratis, the Apache feather logo, Apache Ratis logo, Apache Incubator logo are trademarks of The Apache Software Foundation. <p> </div> diff --git a/logservice/testing/index.xml b/logservice/testing/index.xml index b8405cb..25668f5 100644 --- a/logservice/testing/index.xml +++ b/logservice/testing/index.xml @@ -1,4 +1,4 @@ -<?xml version="1.0" encoding="utf-8" standalone="yes" ?> +<?xml version="1.0" encoding="utf-8" standalone="yes"?> <rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom";> <channel> <title>Apache Ratis</title> @@ -17,7 +17,7 @@ <guid>https://ratis.incubator.apache.org/logservice/testing/docker.html</guid> <description>The Docker orchestration is comprised of the following: - A Docker image which has the necessary software to run the LogService A docker-compose.yml file which can launch the necessary containers for a full-fledged LogService &ldquo;cluster&rdquo; Scripts to build the Docker image and launch a client environment to interact with a running cluster via Compose. Building the Docker image $ mvn clean package assembly:single -DskipTests $ cd ratis-logservice &amp;&amp; .</description> + A Docker image which has the necessary software to run the LogService A docker-compose.yml file which can launch the necessary containers for a full-fledged LogService &ldquo;cluster&rdquo; Scripts to build the Docker image and launch a client environment to interact with a running cluster via Compose. Building the Docker image $ mvn clean package assembly:single -DskipTests $ cd ratis-logservice &amp;&amp; ./build-docker.sh The above will create a Docker image tagged a [...] </item> <item> diff --git a/logservice/testing/vagrant.html b/logservice/testing/vagrant.html index 18fd6a1..31cf8de 100644 --- a/logservice/testing/vagrant.html +++ b/logservice/testing/vagrant.html @@ -93,24 +93,10 @@ <div class="container"> <h1>Vagrant Testing</h1> -<!--- - Licensed 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. See accompanying LICENSE file. ---> - +<!-- raw HTML omitted --> +<!-- raw HTML omitted --> <p>Please refer to the <a href="https://github.com/apache/incubator-ratis/blob/master/dev-support/vagrant/README.md";>documentation</a> for instructions to use the Vagrant automation.</p> - <p>Starting from the directory <code>dev-support/vagrant/</code>:</p> - <ul> <li>To build all Vagrant boxes, invoke <code>./run_all_tests.sh build</code></li> <li>To remove any generated data, invoke <code>./run_all_tests.sh clean</code></li> @@ -123,7 +109,7 @@ <div class="container"> <div class="col-md-12 trademark"> - <p>© 2019 <a href="http://apache.org";>The Apache Software Foundation</a>, + <p>© 2020 <a href="http://apache.org";>The Apache Software Foundation</a>, Apache, Apache Ratis, the Apache feather logo, Apache Ratis logo, Apache Incubator logo are trademarks of The Apache Software Foundation. <p> </div> diff --git a/post.html b/post.html index 22f3d44..e004205 100644 --- a/post.html +++ b/post.html @@ -98,28 +98,38 @@ <h1 id="title">Posts Archive</h1> <ul id="list"> - <h1><a href="/post/0.3.0.html">Release 0.3.0 is available</a></h1> - <p><small>2019 Apr 21 </small></p> + <h1><a href="/post/0.5.0.html">Release 0.5.0 is available</a></h1> + <p><small>2020 Feb 4 </small></p> - <!--- - Licensed 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 + <!-- raw HTML omitted --> +<!-- raw HTML omitted --> +<p><a href="https://ratis.incubator.apache.org/#download";>Download</a></p> +<p>It contains more than 94 improvements and bug fixes based on various Apache Hadoop Ozone use cases. +See the <a href="https://github.com/apache/incubator-ratis/compare/0.4.0-rc4...ratis-0.5.0-rc0";>changes between 0.4.0 and 0.5.0</a> releases.</p> +<p>It has been tested with <a href="https://hadoop.apache.org/ozone/";>Apache Hadoop Ozone</a> where Apache Ratis is used to replicate raw data.</p> - 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. See accompanying LICENSE file. ---> + + <h1><a href="/post/0.4.0.html">Release 0.4.0 is available</a></h1> + <p><small>2019 Sep 12 </small></p> + <!-- raw HTML omitted --> +<!-- raw HTML omitted --> <p><a href="https://ratis.incubator.apache.org/#download";>Download</a></p> +<p>It contains more than 89 improvements and bug fixes based on various Apache Hadoop Ozone use cases. +See the <a href="https://github.com/apache/incubator-ratis/compare/0.3.0...ratis-0.4.0-rc4";>changes between 0.3.0 and 0.4.0</a> releases.</p> +<p>It has been tested with <a href="https://hadoop.apache.org/ozone/";>Apache Hadoop Ozone</a> where Apache Ratis is used to replicate raw data.</p> + + + <h1><a href="/post/0.3.0.html">Release 0.3.0 is available</a></h1> + <p><small>2019 Apr 21 </small></p> + + <!-- raw HTML omitted --> +<!-- raw HTML omitted --> +<p><a href="https://ratis.incubator.apache.org/#download";>Download</a></p> <p>It contains new features such as multi-raft and watch request, as well contains 73 improvements and 72 bug fixes. See the <a href="https://github.com/apache/incubator-ratis/compare/ratis-0.2.0...ratis-0.3.0";>changes between 0.2.0 and 0.3.0</a> releases.</p> - <p>It has been tested with <a href="https://hadoop.apache.org/ozone/";>Apache Hadoop Ozone</a> where Apache Ratis is used to replicate raw data.</p> @@ -127,26 +137,11 @@ See the <a href="https://github.com/apache/incubator-ratis/compare/ratis-0.2.0.. <h1><a href="/post/0.2.0.html">Release 0.2.0 is available</a></h1> <p><small>2018 Jul 15 </small></p> - <!--- - Licensed 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. See accompanying LICENSE file. ---> - + <!-- raw HTML omitted --> +<!-- raw HTML omitted --> <p>0.2.0 is the second Apache release and the first release which provides binary release with example Raft applications.</p> - <p>It contains more than 130 bug fixes and features since the previous release.</p> - <p>This version also heavily tested with <a href="http://ozone.hadoop.apache.org";>Apache Hadoop Ozone</a> where Apache Ratis is used to replicate raw Hadoop data.</p> - <p>The release is available from the downloaded section or (as Ratis is a java library) from the Apache and Maven central maven repositories.</p> @@ -154,24 +149,10 @@ See the <a href="https://github.com/apache/incubator-ratis/compare/ratis-0.2.0.. <h1><a href="/post/0.1.0-alpha.html">Release 0.1.0-alpha is available</a></h1> <p><small>2017 May 2 </small></p> - <!--- - Licensed 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. See accompanying LICENSE file. ---> - + <!-- raw HTML omitted --> +<!-- raw HTML omitted --> <p>This is the first incubator release of Apache Ratis.</p> - <p>Key features:</p> - <ul> <li>Pluggable transports (Hadoop Rpc, GRpc, Netty)</li> <li>Pluggable statemachine</li> @@ -184,6 +165,7 @@ See the <a href="https://github.com/apache/incubator-ratis/compare/ratis-0.2.0.. </div> + </section> </div> @@ -191,7 +173,7 @@ See the <a href="https://github.com/apache/incubator-ratis/compare/ratis-0.2.0.. <div class="container"> <div class="col-md-12 trademark"> - <p>© 2019 <a href="http://apache.org";>The Apache Software Foundation</a>, + <p>© 2020 <a href="http://apache.org";>The Apache Software Foundation</a>, Apache, Apache Ratis, the Apache feather logo, Apache Ratis logo, Apache Incubator logo are trademarks of The Apache Software Foundation. <p> </div> diff --git a/post/0.1.0-alpha.html b/post/0.1.0-alpha.html index 0a88c18..1627f9a 100644 --- a/post/0.1.0-alpha.html +++ b/post/0.1.0-alpha.html @@ -93,24 +93,10 @@ <div class="container"> <h1>Release 0.1.0-alpha is available</h1> -<!--- - Licensed 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. See accompanying LICENSE file. ---> - +<!-- raw HTML omitted --> +<!-- raw HTML omitted --> <p>This is the first incubator release of Apache Ratis.</p> - <p>Key features:</p> - <ul> <li>Pluggable transports (Hadoop Rpc, GRpc, Netty)</li> <li>Pluggable statemachine</li> @@ -123,7 +109,7 @@ <div class="container"> <div class="col-md-12 trademark"> - <p>© 2019 <a href="http://apache.org";>The Apache Software Foundation</a>, + <p>© 2020 <a href="http://apache.org";>The Apache Software Foundation</a>, Apache, Apache Ratis, the Apache feather logo, Apache Ratis logo, Apache Incubator logo are trademarks of The Apache Software Foundation. <p> </div> diff --git a/post/0.2.0.html b/post/0.2.0.html index 095dd59..f033c47 100644 --- a/post/0.2.0.html +++ b/post/0.2.0.html @@ -93,26 +93,11 @@ <div class="container"> <h1>Release 0.2.0 is available</h1> -<!--- - Licensed 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. See accompanying LICENSE file. ---> - +<!-- raw HTML omitted --> +<!-- raw HTML omitted --> <p>0.2.0 is the second Apache release and the first release which provides binary release with example Raft applications.</p> - <p>It contains more than 130 bug fixes and features since the previous release.</p> - <p>This version also heavily tested with <a href="http://ozone.hadoop.apache.org";>Apache Hadoop Ozone</a> where Apache Ratis is used to replicate raw Hadoop data.</p> - <p>The release is available from the downloaded section or (as Ratis is a java library) from the Apache and Maven central maven repositories.</p> </div> @@ -121,7 +106,7 @@ <div class="container"> <div class="col-md-12 trademark"> - <p>© 2019 <a href="http://apache.org";>The Apache Software Foundation</a>, + <p>© 2020 <a href="http://apache.org";>The Apache Software Foundation</a>, Apache, Apache Ratis, the Apache feather logo, Apache Ratis logo, Apache Incubator logo are trademarks of The Apache Software Foundation. <p> </div> diff --git a/post/0.3.0.html b/post/0.3.0.html index e22f3da..19e2fd6 100644 --- a/post/0.3.0.html +++ b/post/0.3.0.html @@ -93,25 +93,11 @@ <div class="container"> <h1>Release 0.3.0 is available</h1> -<!--- - Licensed 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. See accompanying LICENSE file. ---> - +<!-- raw HTML omitted --> +<!-- raw HTML omitted --> <p><a href="https://ratis.incubator.apache.org/#download";>Download</a></p> - <p>It contains new features such as multi-raft and watch request, as well contains 73 improvements and 72 bug fixes. See the <a href="https://github.com/apache/incubator-ratis/compare/ratis-0.2.0...ratis-0.3.0";>changes between 0.2.0 and 0.3.0</a> releases.</p> - <p>It has been tested with <a href="https://hadoop.apache.org/ozone/";>Apache Hadoop Ozone</a> where Apache Ratis is used to replicate raw data.</p> </div> @@ -120,7 +106,7 @@ See the <a href="https://github.com/apache/incubator-ratis/compare/ratis-0.2.0.. <div class="container"> <div class="col-md-12 trademark"> - <p>© 2019 <a href="http://apache.org";>The Apache Software Foundation</a>, + <p>© 2020 <a href="http://apache.org";>The Apache Software Foundation</a>, Apache, Apache Ratis, the Apache feather logo, Apache Ratis logo, Apache Incubator logo are trademarks of The Apache Software Foundation. <p> </div> diff --git a/categories.html b/post/0.4.0.html similarity index 87% copy from categories.html copy to post/0.4.0.html index 9070da1..094d1f9 100644 --- a/categories.html +++ b/post/0.4.0.html @@ -92,24 +92,21 @@ </div> <div class="container"> +<h1>Release 0.4.0 is available</h1> +<!-- raw HTML omitted --> +<!-- raw HTML omitted --> +<p><a href="https://ratis.incubator.apache.org/#download";>Download</a></p> +<p>It contains more than 89 improvements and bug fixes based on various Apache Hadoop Ozone use cases. +See the <a href="https://github.com/apache/incubator-ratis/compare/0.3.0...ratis-0.4.0-rc4";>changes between 0.3.0 and 0.4.0</a> releases.</p> +<p>It has been tested with <a href="https://hadoop.apache.org/ozone/";>Apache Hadoop Ozone</a> where Apache Ratis is used to replicate raw data.</p> -<section id="main"> - <div> - <h1 id="title">Categories Archive</h1> - <ul id="list"> - - </ul> - </div> - - -</section> </div> <footer> <div class="container"> <div class="col-md-12 trademark"> - <p>© 2019 <a href="http://apache.org";>The Apache Software Foundation</a>, + <p>© 2020 <a href="http://apache.org";>The Apache Software Foundation</a>, Apache, Apache Ratis, the Apache feather logo, Apache Ratis logo, Apache Incubator logo are trademarks of The Apache Software Foundation. <p> </div> diff --git a/categories.html b/post/0.5.0.html similarity index 87% copy from categories.html copy to post/0.5.0.html index 9070da1..30c7da3 100644 --- a/categories.html +++ b/post/0.5.0.html @@ -92,24 +92,21 @@ </div> <div class="container"> +<h1>Release 0.5.0 is available</h1> +<!-- raw HTML omitted --> +<!-- raw HTML omitted --> +<p><a href="https://ratis.incubator.apache.org/#download";>Download</a></p> +<p>It contains more than 94 improvements and bug fixes based on various Apache Hadoop Ozone use cases. +See the <a href="https://github.com/apache/incubator-ratis/compare/0.4.0-rc4...ratis-0.5.0-rc0";>changes between 0.4.0 and 0.5.0</a> releases.</p> +<p>It has been tested with <a href="https://hadoop.apache.org/ozone/";>Apache Hadoop Ozone</a> where Apache Ratis is used to replicate raw data.</p> -<section id="main"> - <div> - <h1 id="title">Categories Archive</h1> - <ul id="list"> - - </ul> - </div> - - -</section> </div> <footer> <div class="container"> <div class="col-md-12 trademark"> - <p>© 2019 <a href="http://apache.org";>The Apache Software Foundation</a>, + <p>© 2020 <a href="http://apache.org";>The Apache Software Foundation</a>, Apache, Apache Ratis, the Apache feather logo, Apache Ratis logo, Apache Incubator logo are trademarks of The Apache Software Foundation. <p> </div> diff --git a/post/index.xml b/post/index.xml index da66429..9b5b07e 100644 --- a/post/index.xml +++ b/post/index.xml @@ -1,4 +1,4 @@ -<?xml version="1.0" encoding="utf-8" standalone="yes" ?> +<?xml version="1.0" encoding="utf-8" standalone="yes"?> <rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom";> <channel> <title>Posts on Apache Ratis</title> @@ -6,12 +6,34 @@ <description>Recent content in Posts on Apache Ratis</description> <generator>Hugo -- gohugo.io</generator> <language>en-us</language> - <lastBuildDate>Sun, 21 Apr 2019 00:00:00 +0000</lastBuildDate> + <lastBuildDate>Tue, 04 Feb 2020 00:00:00 +0000</lastBuildDate> <atom:link href="https://ratis.incubator.apache.org/post/index.xml"; rel="self" type="application/rss+xml" /> <item> + <title>Release 0.5.0 is available</title> + <link>https://ratis.incubator.apache.org/post/0.5.0.html</link> + <pubDate>Tue, 04 Feb 2020 00:00:00 +0000</pubDate> + + <guid>https://ratis.incubator.apache.org/post/0.5.0.html</guid> + <description>Download +It contains more than 94 improvements and bug fixes based on various Apache Hadoop Ozone use cases. See the changes between 0.4.0 and 0.5.0 releases. +It has been tested with Apache Hadoop Ozone where Apache Ratis is used to replicate raw data.</description> + </item> + + <item> + <title>Release 0.4.0 is available</title> + <link>https://ratis.incubator.apache.org/post/0.4.0.html</link> + <pubDate>Thu, 12 Sep 2019 00:00:00 +0000</pubDate> + + <guid>https://ratis.incubator.apache.org/post/0.4.0.html</guid> + <description>Download +It contains more than 89 improvements and bug fixes based on various Apache Hadoop Ozone use cases. See the changes between 0.3.0 and 0.4.0 releases. +It has been tested with Apache Hadoop Ozone where Apache Ratis is used to replicate raw data.</description> + </item> + + <item> <title>Release 0.3.0 is available</title> <link>https://ratis.incubator.apache.org/post/0.3.0.html</link> <pubDate>Sun, 21 Apr 2019 00:00:00 +0000</pubDate> diff --git a/sitemap.xml b/sitemap.xml index b694125..1b10670 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -1,8 +1,28 @@ -<?xml version="1.0" encoding="utf-8" standalone="yes" ?> +<?xml version="1.0" encoding="utf-8" standalone="yes"?> <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"; xmlns:xhtml="http://www.w3.org/1999/xhtml";> <url> + <loc>https://ratis.incubator.apache.org/</loc> + <lastmod>2020-02-04T00:00:00+00:00</lastmod> + </url> + + <url> + <loc>https://ratis.incubator.apache.org/post.html</loc> + <lastmod>2020-02-04T00:00:00+00:00</lastmod> + </url> + + <url> + <loc>https://ratis.incubator.apache.org/post/0.5.0.html</loc> + <lastmod>2020-02-04T00:00:00+00:00</lastmod> + </url> + + <url> + <loc>https://ratis.incubator.apache.org/post/0.4.0.html</loc> + <lastmod>2019-09-12T00:00:00+00:00</lastmod> + </url> + + <url> <loc>https://ratis.incubator.apache.org/post/0.3.0.html</loc> <lastmod>2019-04-21T00:00:00+00:00</lastmod> </url> @@ -19,21 +39,16 @@ <url> <loc>https://ratis.incubator.apache.org/logservice.html</loc> + <priority>0</priority> </url> <url> <loc>https://ratis.incubator.apache.org/logservice/testing.html</loc> - </url> - - <url> - <loc>https://ratis.incubator.apache.org/</loc> - <lastmod>2019-04-21T00:00:00+00:00</lastmod> <priority>0</priority> </url> <url> <loc>https://ratis.incubator.apache.org/categories.html</loc> - <priority>0</priority> </url> <url> @@ -57,7 +72,7 @@ </url> <url> - <loc>https://ratis.incubator.apache.org/logservice/security/</loc> + <loc>https://ratis.incubator.apache.org/logservice/security.html</loc> </url> <url> @@ -65,18 +80,11 @@ </url> <url> - <loc>https://ratis.incubator.apache.org/post.html</loc> - <lastmod>2019-04-21T00:00:00+00:00</lastmod> - <priority>0</priority> - </url> - - <url> <loc>https://ratis.incubator.apache.org/source.html</loc> </url> <url> <loc>https://ratis.incubator.apache.org/tags.html</loc> - <priority>0</priority> </url> <url> diff --git a/source.html b/source.html index 1f62e56..cbeea85 100644 --- a/source.html +++ b/source.html @@ -93,22 +93,9 @@ <div class="container"> <h1>Source</h1> -<!--- - Licensed 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. See accompanying LICENSE file. ---> - +<!-- raw HTML omitted --> +<!-- raw HTML omitted --> <p>Source code is part of every release, you can download the source bundles from download section and build the project according to the included instructions.</p> - <p>The versioned source code history is available from the <a href="https://gitbox.apache.org/repos/asf?p=incubator-ratis.git";>Apache git</a> repository or from the <a href="https://github.com/apache/incubator-ratis";>github mirror</a>. It is only for development and not intended for use by the general public. Only the source code from the released artifacts are checked by the Project Management Committee.</p> @@ -119,7 +106,7 @@ Only the source code from the released artifacts are checked by the Project Mana <div class="container"> <div class="col-md-12 trademark"> - <p>© 2019 <a href="http://apache.org";>The Apache Software Foundation</a>, + <p>© 2020 <a href="http://apache.org";>The Apache Software Foundation</a>, Apache, Apache Ratis, the Apache feather logo, Apache Ratis logo, Apache Incubator logo are trademarks of The Apache Software Foundation. <p> </div> diff --git a/tags.html b/tags.html index 7d3b248..7bc6061 100644 --- a/tags.html +++ b/tags.html @@ -102,6 +102,7 @@ </div> + </section> </div> @@ -109,7 +110,7 @@ <div class="container"> <div class="col-md-12 trademark"> - <p>© 2019 <a href="http://apache.org";>The Apache Software Foundation</a>, + <p>© 2020 <a href="http://apache.org";>The Apache Software Foundation</a>, Apache, Apache Ratis, the Apache feather logo, Apache Ratis logo, Apache Incubator logo are trademarks of The Apache Software Foundation. <p> </div> diff --git a/tags/index.xml b/tags/index.xml index 1ae6778..77c7f00 100644 --- a/tags/index.xml +++ b/tags/index.xml @@ -1,4 +1,4 @@ -<?xml version="1.0" encoding="utf-8" standalone="yes" ?> +<?xml version="1.0" encoding="utf-8" standalone="yes"?> <rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom";> <channel> <title>Tags on Apache Ratis</title>
