README.template

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.