Contributing to Apache Zeppelin ( Code ) ( 向 Apache Zeppelin 贡献( 代码 ) )
原文链接 : http://zeppelin.apache.org/docs/0.7.2/development/howtocontribute.html
译文链接 : https://www.apachecn.org/pages/viewpage.action?pageId=10031118
注意
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 获取开发机器上的源代码。
git clone git://git.apache.org/zeppelin.git zeppelin
您可能还想针对特定的分支开发。例如,对于 **branch-0.5.6 **
git clone -b branch-0.5.6 git://git.apache.org/zeppelin.git zeppelin
Apache Zeppelin 遵循 Fork&Pull作为源代码管理工作流程。如果您不仅要构建 Zeppelin ,还可以进行任何更改,那么您需要 fork Zeppelin github 镜像存储库并进行 pull 请求。
Build ( 建立 )
mvn install
跳过测试
mvn install -DskipTests
用特定的 spark / hadoop 版本来构建
mvn install -Dspark.version=x.x.x -Dhadoop.version=x.x.x
为了进一步
Run Zeppelin server in development mode ( 在开发模式下运行 Zeppelin 服务器 )
cd zeppelin-server
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 ( 守护程序脚本 )
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 代码。
cd <zeppelin_home>/zeppelin-interpreter/src/main/thrift
./genthrift.sh
Where to Start ( 从哪儿开始 )
你可以找到 beginner & newbie ( 初学者和新手 )的问题.
Stay involved ( 保持参与 )
贡献者应加入 Zeppelin mailing lists 。
- dev@zeppelin.apache.org适用于想向 Zeppelin 提供代码的人员。订阅,取消订阅,存档。
如果您有任何问题,请在 JIRA 中创建一张 ticket 。