原文链接 : http://zeppelin.apache.org/docs/0.7.2/development/howtocontribute.html

译文链接 : http://cwiki.apachecn.org/pages/viewpage.action?pageId=10031118

贡献者 : 小瑶 ApacheCN Apache中文网

注意

Apache Zeppelin 是 Apache2 License 软件。对 Zeppelin （源代码，文档，图像，网站）的任何贡献意味着您同意许可协议作为 Apache2 license。

配置

以下是您需要 构建 和 测试 Zeppelin 的一些工具。

Software Configuration Management ( SCM ) ( 软件配置管理 )

由于 Zeppeli 使用 Git 作为其 SCM 系统，因此您需要在开发机器中安装 git 客户端。

Integrated Development Environment ( IDE ) ( 集成开发环境 )

您可以随意使用任何您喜欢的 IDE ，或者您最喜爱的命令行编辑器。

Build Tools ( 构建工具 )

要构建代码，请安装

  • Oracle Java 7
  • Apache Maven

Getting the source code ( 获得源代码 )

首先，您需要 Zeppelin 源代码。 Zeppelin 的官方位置是 http://git.apache.org/zeppelin.git 。

git access

使用 git 获取开发机器上的源代码。

  1. git clone git：//git.apache.org/zeppelin.git zeppelin

您可能还想针对特定的分支开发。例如，对于 branch-0.5.6 

  1. git clone -b branch-0.5.6 git://git.apache.org/zeppelin.git zeppelin

Apache Zeppelin 遵循Fork&Pull 作为源代码管理工作流程。如果您不仅要构建 Zeppelin ，还可以进行任何更改，那么您需要 fork Zeppelin github 镜像存储库并进行 pull 请求。

Build ( 建立 )

  1. mvn install

跳过测试

  1. mvn install -DskipTests

用特定的 spark / hadoop 版本来构建

  1. mvn install -Dspark.version=x.x.x -Dhadoop.version=x.x.x

为了进一步

Run Zeppelin server in development mode ( 在开发模式下运行 Zeppelin 服务器 )

  1. cd zeppelin-server
  2. HADOOP_HOME=YOUR_HADOOP_HOME JAVA_HOME=YOUR_JAVA_HOME mvn exec:java -Dexec.mainClass="org.apache.zeppelin.server.ZeppelinServer" -Dexec.args=""

注意

确保您首先在 zeppelin 根目录上运行 mvn clean install -DskipTests ，否则您的服务器构建将无法在本地重现中找到所需的依赖关系。

或使用 daemon script ( 守护程序脚本 )

  1. bin/zeppelin-daemon start

服务器将在 http：// localhost：8080 上运行。

Generating Thrift Code ( 生成 Thrift 代码 )

Thrift 生成 Zeppelin 代码的一些部分。对于大多数的 Zeppelin 更改，您不需要担心这一点。但是如果您修改任何 Thrift IDL 文件（例如 zeppelin-interpreter / src / main / thrift / *.thrift ），那么您还需要重新生成这些文件，并将其更新的版本作为补丁的一部分提交。

要重新生成代码，请安装 thrift-0.9.2 ，然后运行以下命令生成 thrift 代码。

  1. cd <zeppelin_home>/zeppelin-interpreter/src/main/thrift
  2. ./genthrift.sh

Where to Start ( 从哪儿开始 )

你可以找到 beginner & newbie) ( 初学者和新手 )的问题.

Stay involved ( 保持参与 )

贡献者应加入 Zeppelin mailing lists 。

  • dev@zeppelin.apache.org适用于想向 Zeppelin 提供代码的人员。订阅，取消订阅，存档。
    如果您有任何问题，请在 JIRA 中创建一张 ticket 。