| 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. |
| |
| |
| |
| Apache Druid (incubating) is a high performance analytics data store for event-driven data. More information about Druid |
| can be found on http://www.druid.io. |
| |
| The Druid community is in the process of migrating to Apache by way of the Apache Incubator. Eventually, as we proceed |
| along this path, our site will move from http://druid.io/ to https://druid.apache.org/. |
| |
| |
| Documentation |
| ------------- |
| You can find the documentation for {THIS_OR_THE_LATEST} Druid release on the project website http://druid.io/docs/{DRUIDVERSION}/. |
| |
| You can get started with Druid with our quickstart at http://druid.io/docs/{DRUIDVERSION}/tutorials/quickstart.html. |
| |
| |
| Build from Source |
| ----------------- |
| You can build Apache Druid (incubating) directly from source. |
| |
| Prerequisites: |
| JDK 8, 8u92+ |
| Maven version 3.x |
| |
| |
| The basic command to build Druid from source is: |
| |
| mvn clean install |
| |
| |
| This will run static analysis, unit tests, compile classes, and package the projects into JARs. It will not generate the |
| source or binary distribution tarball. |
| |
| In addition to the basic stages, you may also want to add the following profiles and properties: |
| |
| -Pdist - Distribution profile: Generates the binary distribution tarball by pulling in core extensions and |
| dependencies and packaging the files as 'distribution/target/apache-druid-x.x.x-bin.tar.gz' |
| -Papache-release - Apache release profile: Generates GPG signature and checksums, and builds the source distribution |
| tarball as `distribution/target/apache-druid-x.x.x-src.tar.gz` |
| -Prat - Apache Rat profile: Runs the Apache Rat license audit tool |
| -DskipTests - Skips unit tests (which reduces build time) |
| |
| Putting these together, if you wish to build the source and binary distributions with signatures and checksums, audit |
| licenses, and skip the unit tests, you would run: |
| |
| mvn clean install -Papache-release,dist,rat -DskipTests |
| |
| Note: the AWS S3 unit tests require the 'AWS_DEFAULT_REGION' environment variable to be set to function correctly. |
| |
| |
| Community |
| --------- |
| Community support is available on the druid-user mailing list druid-user@googlegroups.com also available at |
| https://groups.google.com/forum/#!forum/druid-user. |
| |
| Development discussions occur on dev@druid.apache.org (archive available at |
| https://lists.apache.org/list.html?dev@druid.apache.org), which you can subscribe to by emailing |
| dev-subscribe@druid.apache.org. |
| |
| |
| Contributing |
| ------------ |
| If you find any bugs, please file a GitHub issue at https://github.com/apache/incubator-druid/issues. |
| |
| If you wish to contribute, please follow the guidelines listed at http://druid.io/community/. |
| |
| |
| Disclaimer: Apache Druid is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the |
| Apache Incubator. Incubation is required of all newly accepted projects until a further review indicates that the |
| infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful |
| ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it |
| does indicate that the project has yet to be fully endorsed by the ASF. |