Zeppelin is Apache2 License Software. Contributing to Zeppelin (Source code, Documents, Image, Website) means you agree to the Apache2 License.
In order to make the review process easier, please follow this template when making a Pull Request:
### What is this PR for? A few sentences describing the overall goals of the pull request's commits. ### What type of PR is it? [Bug Fix | Improvement | Feature | Documentation | Hot Fix | Refactoring] ### Todos * [ ] - Task ### Is there a relevant Jira issue? ### How should this be tested? Outline the steps to test the PR here. ### Screenshots (if appropriate) ### Questions: * Does the licenses files need update? * Is there breaking changes for older versions? * Does this needs documentation?
You can also use this small bookmarklet tool to fill your Pull Request fields automatically:
javascript:(function() {var e = document.getElementById('pull_request_body');if (e) {e.value += '### What is this PR for?\nA few sentences describing the overall goals of the pull request\'s commits.\n\n### What type of PR is it?\n[Bug Fix | Improvement | Feature | Documentation | Hot Fix | Refactoring]\n\n### Todos\n* [ ] - Task\n\n### Is there a relevant Jira issue?\n\n### How should this be tested?\nOutline the steps to test the PR here.\n\n### Screenshots (if appropriate)\n\n### Questions:\n* Does the licenses files need update?\n* Is there breaking changes for older versions?\n* Does this needs documentation?';}})();
Zeppelin follows [Fork & Pull] (https://github.com/sevntu-checkstyle/sevntu.checkstyle/wiki/Development-workflow-with-Git:-Fork,-Branching,-Commits,-and-Pull-Request) model.
When a Pull Request is submitted, it is being merged or rejected by following review process.
The PPMC adds new committers from the active contributors, based on their contribution to Zeppelin. The qualifications for new committers include:
Here are some things you will need to build and test Zeppelin.
Zeppelin uses Git for its SCM system. http://git.apache.org/incubator-zeppelin.git
you'll need git client installed in your development machine. For write access, https://git-wip-us.apache.org/repos/asf/incubator-zeppelin.git
You are free to use whatever IDE you prefer, or your favorite command line editor.
Zeppelin project is based on Maven. Maven works by convention & defines [directory structure] (https://maven.apache.org/guides/introduction/introduction-to-the-standard-directory-layout.html) for a project. The top-level pom.xml describes the basic project structure. Currently Zeppelin has the following modules.
<module>zeppelin-interpreter</module> <module>zeppelin-zengine</module> <module>spark</module> <module>markdown</module> <module>angular</module> <module>shell</module> <module>hive</module> <module>tajo</module> <module>flink</module> <module>ignite</module> <module>lens</module> <module>cassandra</module> <module>zeppelin-web</module> <module>zeppelin-server</module> <module>zeppelin-distribution</module>
If you plan on making a contribution to Zeppelin's WebApplication, please check its own contribution guidelines
We are following Google Code style:
Check style report location are in ${submodule}/target/site/checkstyle.html
Test coverage report location are in ${submodule}/target/site/cobertura/index.html
To build the code, install
First of all, you need the Zeppelin source code. The official location for Zeppelin is http://git.apache.org/incubator-zeppelin.git.
Get the source code on your development machine using git.
git clone http://git.apache.org/incubator-zeppelin.git zeppelin
You may also want to develop against a specific release. For example, for branch-0.1
git clone -b branch-0.1 http://git.apache.org/incubator-zeppelin.git zeppelin
or with write access
git clone https://git-wip-us.apache.org/repos/asf/incubator-zeppelin.git
If you want not only build Zeppelin but also make change, then you need fork Zeppelin github mirror repository (https://github.com/apache/incubator-zeppelin) and make pull request.
mvn install
To skip test
mvn install -DskipTests
To build with specific spark / hadoop version
mvn install -Phadoop-2.2 -Dhadoop.version=2.2.0 -Pspark-1.3 -Dspark.version=1.3.0
Each new File should have its own accompanying unit tests. Each new interpreter should have come with its tests.
Zeppelin has 3 types of tests:
Currently the GUI integration tests are not run in the Maven and are only run in the CI environment when the pull request is submitted to github. Make sure to watch the [CI results] (https://travis-ci.org/apache/incubator-zeppelin/pull_requests) for your pull request.
Zeppelin uses Travis for CI. In the project root there is .travis.yml that configures CI and [publishes CI results] (https://travis-ci.org/apache/incubator-zeppelin/builds)
cd zeppelin-server HADOOP_HOME=YOUR_HADOOP_HOME JAVA_HOME=YOUR_JAVA_HOME mvn exec:java -Dexec.mainClass="com.nflabs.zeppelin.server.ZeppelinServer" -Dexec.args=""
or use daemon script
bin/zeppelin-daemon start
Server will be run on http://localhost:8080
Zeppelin manages it's issues in Jira. https://issues.apache.org/jira/browse/ZEPPELIN
Everyone is welcome to join our mailing list: