bookkeeper-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From git-site-r...@apache.org
Subject [bookkeeper] branch asf-site updated: Updated site at revision d06fad2
Date Fri, 26 Jan 2018 19:14:12 GMT
This is an automated email from the ASF dual-hosted git repository.

git-site-role pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/bookkeeper.git


The following commit(s) were added to refs/heads/asf-site by this push:
     new b518d8c  Updated site at revision d06fad2
b518d8c is described below

commit b518d8c58dda1b2530894ce0bb5e810f6c51ed46
Author: jenkins <builds@apache.org>
AuthorDate: Fri Jan 26 19:14:10 2018 +0000

    Updated site at revision d06fad2
---
 .../index.html                                     | 339 +++++++++++++++++++++
 content/community/bookkeeper_proposals/index.html  |   6 +-
 2 files changed, 344 insertions(+), 1 deletion(-)

diff --git a/content/bps/BP-26-move-distributedlog-core-library/index.html b/content/bps/BP-26-move-distributedlog-core-library/index.html
new file mode 100644
index 0000000..f4273bd
--- /dev/null
+++ b/content/bps/BP-26-move-distributedlog-core-library/index.html
@@ -0,0 +1,339 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>Apache BookKeeper&trade; - BP-26: Move distributedlog library as part
of bookkeeper</title>
+
+<meta charset="utf-8">
+<meta http-equiv="X-UA-Compatible" content="IE=edge">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+
+<link rel="stylesheet" href="/css/normalize.css">
+<link rel="stylesheet" href="/css/tippy.css">
+<link rel="stylesheet" href="/css/style.css">
+
+<link rel="shortcut icon" href="/img/favicon.ico">
+
+<script src="/js/tippy.min.js"></script>
+
+<script type="text/javascript">
+  var shiftWindow = function() { scrollBy(0, -25); };
+  window.addEventListener("hashchange", shiftWindow);
+  window.addEventListener("pageshow", shiftWindow);
+  function load() { if (window.location.hash) shiftWindow(); }
+</script>
+  </head>
+  <body class="body">
+    <main class="main">
+      
+<nav class="navbar bk-topnav">
+  <div class="navbar-brand">
+    <a class="navbar-item bk-brand" href="/">
+      Apache BookKeeper&trade;
+    </a>
+
+    <div class="navbar-burger burger" data-target="bkNav">
+      <span></span>
+      <span></span>
+      <span></span>
+    </div>
+  </div>
+
+  <div id="bkNav" class="navbar-menu">
+    <div class="navbar-start">
+      <div class="navbar-item has-dropdown is-hoverable">
+        <a class="navbar-link">Documentation</a>
+        <div class="navbar-dropdown is-boxed">
+          <a class="navbar-item" href="/docs/latest/overview/overview">
+            Version 4.7.0-SNAPSHOT
+            <span class="tag is-warning">Development</span>
+          </a>
+          <a class="navbar-item" href="/docs/latest/api/javadoc">
+            <span class="icon bk-javadoc-icon">
+              <img src="/img/java-icon.svg">
+            </span>
+            Javadoc
+          </a>
+          <hr class="dropdown-divider">
+          
+          <a class="navbar-item" href="/docs/4.6.1/overview/overview">
+            Release 4.6.1
+            
+          </a>
+          
+          <a class="navbar-item" href="/docs/4.6.0/overview/overview">
+            Release 4.6.0
+            
+          </a>
+          
+          <a class="navbar-item" href="/docs/4.5.1/overview/overview">
+            Release 4.5.1
+            
+          </a>
+          
+          <a class="navbar-item" href="/docs/4.5.0/overview/overview">
+            Release 4.5.0
+            <span class="tag is-success">Stable</span>
+          </a>
+          
+          
+          <a class="navbar-item" href="/archives/docs/r4.4.0">
+            Release 4.4.0
+            
+          </a>
+          
+          <a class="navbar-item" href="/archives/docs/r4.3.2">
+            Release 4.3.2
+            
+          </a>
+          
+          <a class="navbar-item" href="/archives/docs/r4.3.1">
+            Release 4.3.1
+            
+          </a>
+          
+          <a class="navbar-item" href="/archives/docs/r4.3.0">
+            Release 4.3.0
+            
+          </a>
+          
+          <a class="navbar-item" href="/archives/docs/r4.2.4">
+            Release 4.2.4
+            
+          </a>
+          
+          <a class="navbar-item" href="/archives/docs/r4.2.3">
+            Release 4.2.3
+            
+          </a>
+          
+          <a class="navbar-item" href="/archives/docs/r4.2.2">
+            Release 4.2.2
+            
+          </a>
+          
+          <a class="navbar-item" href="/archives/docs/r4.2.1">
+            Release 4.2.1
+            
+          </a>
+          
+          <a class="navbar-item" href="/archives/docs/r4.2.0">
+            Release 4.2.0
+            
+          </a>
+          
+          <a class="navbar-item" href="/archives/docs/r4.1.0">
+            Release 4.1.0
+            
+          </a>
+          
+          <a class="navbar-item" href="/archives/docs/r4.0.0">
+            Release 4.0.0
+            
+          </a>
+          
+        </div>
+      </div>
+
+      <div class="navbar-item has-dropdown is-hoverable">
+        <a class="navbar-link">Community</a>
+        <div class="navbar-dropdown is-boxed">
+          <a class="navbar-item" href="/community/mailing-lists">Mailing lists</a>
+          <a class="navbar-item" href="/community/slack">Slack</a>
+          <a class="navbar-item" href="https://github.com/apache/bookkeeper/issues">Github
Issues</a>
+          <a class="navbar-item" href="/community/releases">Release Management</a>
+          <a class="navbar-item" href="/community/meeting">Community Meetings</a>
+          <hr class="dropdown-divider">
+          <a class="navbar-item" href="/community/contributing">Contribution Guide</a>
+          <a class="navbar-item" href="/community/coding_guide">Coding Guide</a>
+          <a class="navbar-item" href="/community/testing">Testing Guide</a>
+          <a class="navbar-item" href="/community/issue-report">Issue Report Guide</a>
+          <a class="navbar-item" href="/community/release_guide">Release Guide</a>
+          <hr class="dropdown-divider">
+          <a class="navbar-item" href="/community/presentations">Presentations</a>
+          <a class="navbar-item" href="/community/bookkeeper_proposals">BookKeeper
Proposals</a>
+        </div>
+      </div>
+
+      <div class="navbar-item has-dropdown is-hoverable">
+        <a class="navbar-link">Project</a>
+        <div class="navbar-dropdown is-boxed">
+          <a class="navbar-item" href="/project/who">Who are we?</a>
+          <a class="navbar-item" href="/project/bylaws">Bylaws</a>
+          <a class="navbar-item" href="http://www.apache.org/licenses/">License</a>
+          <hr class="dropdown-divider">
+          <a class="navbar-item" href="/project/privacy">Privacy policy</a>
+          <a class="navbar-item" href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
+          <a class="navbar-item" href="http://www.apache.org/foundation/thanks.html">Thanks</a>
+        </div>
+      </div>
+    </div>
+
+    <div class="navbar-end">
+      <div class="navbar-item">
+        <div class="field is-grouped">
+          <p class="control">
+            <a class="button bk-twitter" href="https://twitter.com/asfbookkeeper">
+              <span class="icon">
+                <i class="fa fa-twitter"></i>
+              </span>
+              <span>Twitter</span>
+            </a>
+          </p>
+          <p class="control">
+            <a class="button" href="https://github.com/apache/bookkeeper">
+              <span class="icon">
+                <i class="fa fa-github"></i>
+              </span>
+              <span>GitHub</span>
+            </a>
+          </p>
+          <p class="control">
+            <a class="button is-primary" href="/releases">
+              <span class="icon">
+                <i class="fa fa-download"></i>
+              </span>
+              <span>Download</span>
+            </a>
+          </p>
+        </div>
+      </div>
+    </div>
+  </div>
+</nav>
+
+
+      <div class="bk-community-container">
+  <div class="columns">
+    <div class="column is-12">
+      <header class="docs-title">
+        <nav class="level">
+          <div class="level-left">
+            <div class="level-item">
+              <h1 class="title">BP-26: Move distributedlog library as part of bookkeeper</h1>
+            </div>
+          </div>
+          
+        </nav>
+
+        
+      </header>
+
+      <hr />
+
+      <div class="content is-medium">
+        <section class="bk-community-content">
+          <h3 id="motivation">Motivation</h3>
+
+<p>DistributedLog is an extension of Apache BookKeeper, which offers <em>reopenable</em>
log streams as its storage primitives.
+It is tightly built over bookkeeper ledgers, and provides an easier-to-use abstraction and
api to use. Applications
+can use <em>named</em> log streams rather than <em>numbered</em>
ledgers to store their data. For example, users can use log streams
+as files to storge objects, checkpoints and other more general filesystem related use cases.</p>
+
+<p>Moving the distributedlog core library as part of bookkeeper would have following
benefits:</p>
+
+<ul>
+  <li>It provides more generic “reopenable” log abstraction. It lowers the barrier
for people to use bookkeeper to store
+data, and bring in more use cases into bookkeeper ecosystem.</li>
+  <li>Using ledgers to build continous log stream has been a pattern that been reimplemented
multiple times at multiple places,
+from older projects like HDFS namenode log manager, Hedwig to the newer projects like DistributedLog
and Pulsar.</li>
+  <li>Most of the distributedlog usage is using the distributedlog library which only
depends Apache BookKeeper and there is no
+additional components introduced. To simplify those usages, it is better to release distributedlog
library along with
+bookkeeper. It provides a better integration and release procedure.</li>
+</ul>
+
+<p>This proposal proposes “moving the distributedlog library code base as part of
bookkeeper and continuing the library
+development in bookkeeper”.</p>
+
+<h3 id="public-interfaces">Public Interfaces</h3>
+
+<p>This is a new library moved in bookkeeper. It will <em>NOT</em> touch
any existing bookkeeper modules and ledger api.</p>
+
+<h3 id="proposed-changes">Proposed Changes</h3>
+
+<p>This proposal will <em>ONLY</em> move following library-only modules
from distributedlog repo:</p>
+
+<ul>
+  <li>distributedlog-core: the log stream library that build over bookkeeper ledgr
api. It doesn’t introduce any service components. Library only.</li>
+  <li>distributedlog-io/dlfs: A hdfs filesystem api wrapper over the log stream api,
to provide filesystem-like usage over bookkeeper.</li>
+</ul>
+
+<p>This proposal will <em>NOT</em> move other service components like “distributedlog-proxy”.</p>
+
+<p>The steps to make this change are described as following:</p>
+
+<ul>
+  <li>the proposed modules (<code class="highlighter-rouge">distributedlog-core</code>
and <code class="highlighter-rouge">distributedlog-io/dlfs</code>) will be moved
under <code class="highlighter-rouge">stream/distributedlog</code> directory at
apache bookkeeper repo.</li>
+  <li>a new “stream” profile will be added to the root <code class="highlighter-rouge">pom.xml</code>
file. The distributedlog module will only be build when “-Pstream” is specified
+in the maven build command. This allows users who only use ledger api skip building distributedlog
module.</li>
+  <li>the distributedlog api, javadoc api and some tutorials will be integrated with
current bookkeeper website to provide integrated experiences
+when users browse bookkeeper website.</li>
+</ul>
+
+<h3 id="compatibility-deprecation-and-migration-plan">Compatibility, Deprecation, and
Migration Plan</h3>
+
+<p>This doesn’t change existing modules or api. so no compatibility, deprecation
and migration plan for bookkeeper users.</p>
+
+<p>For distributedlog users, the distributedlog library will begin release under groupId
<code class="highlighter-rouge">org.apache.bookkeeper</code> instead of <code
class="highlighter-rouge">org.apache.distributedlog</code>.
+API documentation will be updated to reflect this.</p>
+
+<h3 id="test-plan">Test Plan</h3>
+
+<p>N/A</p>
+
+<h3 id="rejected-alternatives">Rejected Alternatives</h3>
+
+<p>N/A</p>
+
+        </section>
+
+        
+      </div>
+    </div>
+  </div>
+</div>
+    </main>
+
+    <footer class="footer">
+  <div class="container">
+    <div class="content has-text-centered">
+      <p>
+        Copyright &copy; 2016 - 2018 <a href="https://www.apache.org/">The Apache
Software Foundation</a>,<br /> licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache
License, version 2.0</a>.
+      </p>
+    </div>
+  </div>
+</footer>
+
+  </body>
+
+  <script src="/js/app.js"></script>
+
+  
+  <!--
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+      http://www.apache.org/licenses/LICENSE-2.0
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+-->
+<script>
+  (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+  (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+  m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+  })(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
+
+  ga('create', 'UA-104419626-1', 'auto');
+  ga('send', 'pageview');
+
+</script>
+
+  
+</html>
diff --git a/content/community/bookkeeper_proposals/index.html b/content/community/bookkeeper_proposals/index.html
index 8c31cce..a62cc52 100644
--- a/content/community/bookkeeper_proposals/index.html
+++ b/content/community/bookkeeper_proposals/index.html
@@ -347,7 +347,7 @@ of the thread is of the format <code class="highlighter-rouge">[DISCUSS]
BP-&lt;
 
 <p>This section lists all the <em>bookkeeper proposals</em> made to BookKeeper.</p>
 
-<p><em>Next Proposal Number: 26</em></p>
+<p><em>Next Proposal Number: 27</em></p>
 
 <h3 id="inprogress">Inprogress</h3>
 
@@ -383,6 +383,10 @@ of the thread is of the format <code class="highlighter-rouge">[DISCUSS]
BP-&lt;
       <td style="text-align: left"><a href="https://cwiki.apache.org/confluence/display/BOOKKEEPER/BP-18%3A+LedgerType%2C+Flags+and+StorageHints">BP-18:
LedgerType, Flags and StorageHints</a></td>
       <td style="text-align: left">Accepted</td>
     </tr>
+    <tr>
+      <td style="text-align: left"><a href="../../bps/BP-26-move-distributedlog-core-library">BP-26:
Move distributedlog library as part of bookkeeper</a></td>
+      <td style="text-align: left">Accepted</td>
+    </tr>
   </tbody>
 </table>
 

-- 
To stop receiving notification emails like this one, please contact
git-site-role@apache.org.

Mime
View raw message