This is an automated email from the ASF dual-hosted git repository. szetszwo pushed a commit to branch RATIS-5 in repository https://gitbox.apache.org/repos/asf/ratis-hadoop-projects.git
commit f206cea0217520098fe3019f7c66a50ca176c628 Author: Márton Elek <[email protected]> AuthorDate: Fri Nov 24 13:23:24 2017 +0100 RATIS-5. Initial (wip) version of ratis site. --- .gitignore | 5 + README.md | 14 +++ config.toml | 86 ++++++++++++++ content/community.md | 50 ++++++++ content/download.md | 52 ++++++++ content/getting_started.md | 18 +++ content/post/0.1.0.md | 37 ++++++ content/source.md | 19 +++ layouts/index.html | 215 +++++++++++++++++++++++++++++++++ static/asf_feather.png | Bin 0 -> 1209 bytes static/style.css | 289 +++++++++++++++++++++++++++++++++++++++++++++ 11 files changed, 785 insertions(+) diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..fca6b23 --- /dev/null +++ b/.gitignore @@ -0,0 +1,5 @@ + +### Hugo ### +hugo.exe +/public/ + diff --git a/README.md b/README.md new file mode 100644 index 0000000..2330400 --- /dev/null +++ b/README.md @@ -0,0 +1,14 @@ + + + + + +## Check the site + + +## Development + +``` +hugo serve +``` + diff --git a/config.toml b/config.toml new file mode 100644 index 0000000..48eca20 --- /dev/null +++ b/config.toml @@ -0,0 +1,86 @@ +# +# 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. +# +baseurl = "https://ratis.apache.org" +title = "Apache Ratis" +copyright = "© 2017 Apache Software Foundation" +enableEmoji = true +footnotereturnlinkcontents = "<sup>^</sup>" +uglyurls = true + + +[[menu.main]] + name = "Download" + url = "releases.html" + weight = 1 + + +[[menu.main]] + name = "Documentation" + identifier = "documentation" + weight = 2 + +[[menu.main]] + name = "Latest" + parent = "documentation" + url = "http://hadoop.apache.org/docs/current/" + +[[menu.main]] + name = "Stable" + parent = "documentation" + url = "http://hadoop.apache.org/docs/stable/" + + + + +[[menu.main]] + name = "Community" + identifier = "community" + weight = 3 + + + +[[menu.main]] + name = "Development" + identifier = "development" + weight = 4 + +[[menu.main]] + name = "How to Contribute" + url = "https://wiki.apache.org/hadoop/HowToContribute" + parent = "development" + +[[menu.main]] + name = "Help" + identifier = "help" + weight = 5 + +[[menu.main]] + name = "Buy Stuff" + url = "http://www.cafepress.com/hadoop" + parent = "help" + +[[menu.main]] + name = "Sponsorshop" + url = "http://www.apache.org/foundation/sponsorship.html" + parent = "help" + +[[menu.main]] + name = "Thanks" + url = "http://www.apache.org/foundation/thanks.html" + parent = "help" + + +# Configure the English version of the website. +[languages.en] + languageCode = "en-us" diff --git a/content/community.md b/content/community.md new file mode 100644 index 0000000..5a725d6 --- /dev/null +++ b/content/community.md @@ -0,0 +1,50 @@ +--- +title: Community +--- +<!--- + 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. +--> + +### Mailing list + +#### Developers + +If you'd like to contribute to Apache Ratis, please subscribe to the +Ratis developer mailing list. + +The Rais developer mailing list is: <[email protected]>. + +- [Subscribe to List](mailto: [email protected]) +- [Unsubscribe from + List](mailto: [email protected]) +- [Archives](http://mail-archives.apache.org/mod_mbox/ratis-dev/) + + +#### 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 : <[email protected]>. + +- [Subscribe to List](mailto: [email protected]) +- [Unsubscribe from List](mailto: [email protected]) +- [Archives](http://mail-archives.apache.org/mod_mbox/ratis-user/) + +In order to post to the list, it is necessary to first subscribe to it. + +### Slack + +TODO \ No newline at end of file diff --git a/content/download.md b/content/download.md new file mode 100644 index 0000000..289479c --- /dev/null +++ b/content/download.md @@ -0,0 +1,52 @@ +--- +title: Download +--- +<!--- + 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. +--> + +Ratis is a *library* which is supposed to be used from java code. + + +{{< highlight xml>}} +<dependency> + <artifactId>ratis-server</artifactId> + <groupId>org.apache.ratis</groupId> +</dependency> +{{< /highlight >}} + + +You also need to include *one* of the transports: + +{{< highlight xml>}} +<dependency> + <artifactId>ratis-netty</artifactId> + <groupId>org.apache.ratis</groupId> +</dependency> +{{< /highlight >}} + +{{< highlight xml>}} + <dependency> + <groupId>org.apache.ratis</groupId> + <artifactId>ratis-grpc</artifactId> +</dependency> +{{< /highlight >}} + +{{< highlight xml>}} + <dependency> + <groupId>org.apache.ratis</groupId> + <artifactId>ratis-hadoop-shaded</artifactId> + </dependency> +{{< /highlight >}} + +Please not that hadoop dependencies are shaded, so it's safe to use hadoop transport with different versions of hadoop. \ No newline at end of file diff --git a/content/getting_started.md b/content/getting_started.md new file mode 100644 index 0000000..c0e039f --- /dev/null +++ b/content/getting_started.md @@ -0,0 +1,18 @@ +--- +title: Gettig started +--- +<!--- + 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. +--> + +TBD \ No newline at end of file diff --git a/content/post/0.1.0.md b/content/post/0.1.0.md new file mode 100644 index 0000000..8e109c7 --- /dev/null +++ b/content/post/0.1.0.md @@ -0,0 +1,37 @@ +--- +title: release 0.14.1 available +date: 2007-09-04 +--- +<!--- + 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. +--> + +New features in release 0.14 include: + +- Better checksums in HDFS. Checksums are no longer stored in parallel +HDFS files, but are stored directly by datanodes alongside blocks. +This is more efficient for the namenode and also improves data +integrity. +- Pipes: A C++ API for MapReduce +- Eclipse Plugin, including HDFS browsing, job monitoring, etc. +- File modification times in HDFS. + +There are many other improvements, bug fixes, optimizations and new +features. Performance and reliability are better than ever. + +When upgrading an existing HDFS filesystem to a 0.14.x release from a +0.13.x or earlier release, you should first start HDFS with +'bin/start-dfs.sh -upgrade'. See the [Hadoop 0.14 +Upgrade](http://wiki.apache.org/hadoop/Hadoop_0.14_Upgrade) page for +details. + diff --git a/content/source.md b/content/source.md new file mode 100644 index 0000000..8543c01 --- /dev/null +++ b/content/source.md @@ -0,0 +1,19 @@ +--- +title: Source +--- +<!--- + 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. +--> + +Source code is available from the [Apache git](git://git.apache.org/incubator-ratis.git) repository or +from the [github mirror](https://github.com/apache/incubator-ratis). \ No newline at end of file diff --git a/layouts/index.html b/layouts/index.html new file mode 100644 index 0000000..07833e5 --- /dev/null +++ b/layouts/index.html @@ -0,0 +1,215 @@ +<!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="The Apache Cassandra database is the right choice when you need scalability and high availability without compromising performance. Linear scalability and proven fault-tolerance on commodity hardware or cloud infrastructure make it the perfect platform for mission-critical data. Cassandra's support for replicating across multiple datacenters is best-in-class, providing lower latency for your users and the peace of mind of knowing that you can survive [...] +"> + <meta name="keywords" content="raft, java, ratis, library"/> + <meta name="robots" content="index,follow"/> + <meta name="language" content="en"/> + + <title>Apache Ratis</title> + + <link rel="canonical" href="http://ratis.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> +<!-- breadcrumbs --> +<div class="topnav"> + <div class="container breadcrumb-container"> + <ul class="breadcrumb"> + <li> + <div class="dropdown"> + <img class="asf-logo" src="./asf_feather.png"/> + <a data-toggle="dropdown" href="#">Apache Software Foundation <span class="caret"></span></a> + <ul class="dropdown-menu" role="menu" aria-labelledby="dLabel"> + <li><a href="http://www.apache.org">Apache Homepage</a></li> + <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> + </li> + + + <li>Apache Ratis</li> + + + </ul> + </div> + + <!-- navbar --> + <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="#cassandra-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><!-- /.navbar-header --> + + <div id="cassandra-menu" class="collapse navbar-collapse"> + <ul class="nav navbar-nav navbar-right"> + <li><a href="./">Home</a></li> + <li><a href="#download">Download</a></li> + <li><a href="#source">Source</a></li> + <li><a href="#community">Community</a></li> + </ul> + </div><!-- /#cassandra-menu --> + + + <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 Ratis</a> + </p> + <p> + + <a class="changelog" + href="#source">Source code + </a> + </p> + </div><!-- /.jumbotron --> + + </div> + </nav><!-- /.navbar --> +</div><!-- /.topnav --> + +<div class="feature-list-group"> + <div class="container"> + <div class="row header"> + <h3>What is Apache Ratis?</h3> + <p class="lead"> + Apache Ratis is a higly customizable RAFT protocol implementation in java. + </p> + </div> + + <div class="row feature-list"> + <div class="col-md-4 col-sm-4 feature-item"> + <span class="glyphicon glyphicon-transfer" aria-hidden="true"></span> + <i class="fa fa-5x fa-fw m-y-3 text-info fa-child"></i> + <h4>Pluggable transport</h4> + <p> + Transport layer of Ratis is separated from the RAFT implementation and can be used with any + transport. + </p> + <p> + By default gRPC, Netty+Protobuf and Hadoop RPC based transports are provided. + </p> + <p></p> + </div> + <div class="col-md-4 col-sm-4 feature-item"> + <span class="glyphicon glyphicon-log-in" aria-hidden="true"></span> + <h4>Pluggable state machine</h4> + <p> + Ratis is a RAFT library which can use for many use cases. A custom state machine should be defined + by the + user of the library and Ratis will replicate the state between the servers. + </p> + </div> + <div class="col-md-4 col-sm-4 feature-item"> + <span class="glyphicon glyphicon-tasks" aria-hidden="true"></span> + <h4>Pluggable raft log</h4> + <p>RAFT log is also pluggable, users may provide their own log implementation. The default + implementation + stores log in local files</p> + <p> + Application could choose to not written all the data to log and state machine data and log data can + be separately managed + </p> + </div> + + + </div><!-- /.feature-list --> + + + </div><!-- /.container --> +</div><!-- /.feature-list-group --> + + +<a name="download"></a> +<div class="download bg-light"> + <div class="container"> + <div class="row header"> + <h2>Latest news</h2> + {{ range where .Data.Pages "Section" "post" }} + <div class="panel-heading clearfix"><a class="pull-left" href="">{{.Title}}</a> + <small class="pull-right">{{dateFormat "2006 Jan 2 " .Date}}</small> + </div> + {{end}} + </div> + </div> +</div> + +<a name="download"></a> +<div class="download"> + <div class="container"> + <div class="row header"> + {{range where .Site.Pages "Title" "Download"}} + <h2>{{.Title}}</h2> + {{.Content}} + {{end}} + </div> + </div> +</div> + +<a name="community"></a> +<div class="community bg-light"> + <div class="container"> + <div class="row header"> + {{range where .Site.Pages "Title" "Community"}} + <h2>{{.Title}}</h2> + {{.Content}} + {{end}} + </div> + </div> +</div> + +<a name="source"></a> +<div class="source"> + <div class="container"> + <div class="row header"> + {{range where .Site.Pages "Title" "Source"}} + <h2>{{.Title}}</h2> + {{.Content}} + {{end}} + </div> + </div> +</div> + +<footer> + <div class="container"> + + <div class="col-md-12 trademark"> + <p>© 2017 <a href="http://apache.org">The Apache Software Foundation</a>. + Apache, the Apache feather logo, are trademarks of The Apache Software Foundation. + <p> + </div> + </div><!-- /.container --> +</footer> + +<!-- Javascript. Placed here so pages load faster --> +<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/static/asf_feather.png b/static/asf_feather.png new file mode 100644 index 0000000..c0ebf11 Binary files /dev/null and b/static/asf_feather.png differ diff --git a/static/style.css b/static/style.css new file mode 100644 index 0000000..8dce57e --- /dev/null +++ b/static/style.css @@ -0,0 +1,289 @@ +/* + * Main website stylesheet + */ +/* Navigation bars. */ +.topnav { + background-color: #2f3030; } + .topnav .breadcrumb { + background-color: #2f3030; + padding: 8px 0px; + margin: auto; + color: #f5f5f5; } + .topnav .breadcrumb .asf-logo { + margin-right: 4px; + margin-top: -4px; + margin-bottom: -8px; + height: 30px; } + .topnav a { + color: #f5f5f5; } + .topnav a:hover, .topnav a:focus { + color: #f5d35f; + text-decoration: none; } + .topnav .navbar { + background-color: #474a86; + min-height: 120px; + z-index: 0; + margin-bottom: 0px; } + .topnav .navbar .navbar-brand { + min-height: 120px; } + .topnav .navbar .navbar-brand img { + float: left; } + .topnav .navbar .nav { + padding: 30px 0 0 0; + color: #fff; } + .topnav .navbar .nav li a { + text-align: center; + font-size: 24px; + padding: 5px 0 5px 5px; + margin: 0 10px; + color: #f5f5f5; } + .topnav .navbar .nav li a:hover { + color: #f5d35f; + background: none; } + .topnav .navbar .navbar-header { + height: 120px; } + .topnav .navbar .navbar-toggle { + position: relative; + top: 50%; + transform: translateY(-50%); + margin-top: 0; } + .topnav .navbar .navbar-toggle .icon-bar { + background-color: #FFF; } + .topnav .navbar .navbar-toggle:focus .icon-bar { + background-color: #000; } + .topnav .navbar .navbar-collapse { + border-color: transparent; + box-shadow: none; } + +@media (min-width: 768px) and (max-width: 1024px) { + .navbar .nav li a { + padding: 8px 0 15px 8px; } } +/* Jumbotron part. */ +.jumbotron { + background: none; + max-width: 748px; + margin: 30px auto 40px auto; + padding: 0px; } + .jumbotron h1 { + font-size: 40px; + font-family: HelveticaNeue-Light,Helvetica,Arial,sans-serif; + line-height: 1.2; + color: #f5f5f5; + text-align: center; + padding: 0; + margin-bottom: 28px; } + .jumbotron .lead { + line-height: 1.25; + color: white; + font-size: 15px; + font-weight: 100; + letter-spacing: 0.8px; + margin-bottom: 48px; } + .jumbotron p { + text-align: center; + margin-bottom: 0px; } + .jumbotron .btn.download { + border-radius: 8px; + padding: 11px 28px; + margin-bottom: 4px; + color: #2f3030; } + .jumbotron .btn.download:hover, .jumbotron .btn.download:focus { + color: #f5d35f; } + .jumbotron a.changelog { + font-size: 15px; + display: inline-block; + color: #D9F0FF; } + .jumbotron a.changelog:hover, .jumbotron a.changelog:focus { + color: #f5d35f; + text-decoration: none; } + + .bg-dark { + background-color: #83c9f4; + } + + .bg-light { + background-color: #f1f9ff; + } +/* Features list. */ +.feature-list-group { + padding-top: 20px; + padding-bottom: 61px; } + .feature-list-group .header { + text-align: center; } + .feature-list-group .header h3 { + font-size: 30px; + font-weight: 200; + text-align: center; + margin-bottom: 26px; } + .feature-list-group .header .lead { + color: #777777; + font-weight: normal; + line-height: 1.42857143; + margin-bottom: 55px; } + .feature-list-group .feature-list { + margin-bottom: 25px; } + .feature-list-group .feature-item h4 { + color: #2f3030; + font-family: HelveticaNeue-Medium,Helvetica,Arial,sans-serif; + font-size: 14pt; + text-transform: uppercase; + margin-bottom: 16px; } + .feature-list-group .feature-item p { + font-family: HelveticaNeue-Light,Helvetica,Arial,sans-serif; + } + .feature-list-group .feature-item .glyphicon { + font-size: 70px; + padding: 20px; + padding-bottom: 20px; + display:block; + text-align:center; + color: #6ca5c8; + } + +@media (max-width: 767px) { + .jumbotron > .lead { + font-weight: 200; } + + .feature-list-group { + padding: 36px 9px 6px 9px; } + + .feature-list { + margin-bottom: 0px; } + + .feature-item { + margin-bottom: 48px; } } +footer { + margin-top: 38px; + padding-top: 10px; + padding-bottom: 20px; } + +.social-blk { + float: right; } + +.nopadding { + padding: 0 !important; + margin: 0 !important; } + +.splash { + display: block; } + +.author_contact { + display: inline-block; } + +.author_gravatar { + display: inline; + padding: 0 20px 20px 5px; } + +.share { + display: block; } + +@media (max-width: 767px) { + .social-blk { + float: left; + width: 100%; + margin-bottom: 32px; } } +pre { + overflow: auto; + overflow-y: hidden; + /* fixes display issues on Chrome browsers */ } + pre code { + overflow: auto; + overflow-y: hidden; +} + +td.linenos pre { + padding: 5px 0px; + border: 0; + background-color: transparent; + color: #aaa; } + +table.highlighttable { + margin-left: 0.5em; } + +table.highlighttable td { + padding: 0 0.5em 0 0.5em; } + +div.code-block-caption { + padding: 2px 5px; + font-size: small; } + +div.code-block-caption code { + background-color: transparent; } + +div.code-block-caption + div > div.highlight > pre { + margin-top: 0; } + +div.code-block-caption span.caption-number { + padding: 0.1em 0.3em; + font-style: italic; } + +div.literal-block-wrapper { + padding: 1em 1em 0; } + +div.literal-block-wrapper div.highlight { + margin: 0; } + +code.descname { + background-color: transparent; + font-weight: bold; + font-size: 1.2em; } + +code.descclassname { + background-color: transparent; } + +code.xref, a code { + background-color: transparent; + font-weight: bold; } + +h1 code, h2 code, h3 code, h4 code, h5 code, h6 code { + background-color: transparent; } + +.viewcode-link { + float: right; } + +.viewcode-back { + float: right; + font-family: sans-serif; } + +div.viewcode-block:target { + margin: -1px -10px; + padding: 0 10px; } + +img { + max-width: 100%; } + +body { + font-size: 14pt; + background-color: #fff; +} + +.content .container { + margin-top: 20px; } + +#wipwarning { + font-size: 14px; + border: 1px solid #ebccd1; + border-radius: 4px; + color: #a94442; + background-color: #f2dede; + padding: 10px 30px; + margin: 30px 20px; } + +.biglink { + font-size: 120%; } + +.linkdescr { + font-size: 90%; } + +.doc-landing-table { + margin: 10px 30px 20px 30px; + width: 90%; } + .doc-landing-table td { + padding-top: 10px; } + .doc-landing-table .right-column { + padding-left: 100px; } + +.doc-landing-metainfos { + margin: 10px 30px 0px 30px; } + .doc-landing-metainfos p { + margin-bottom: 10px; }
