Free and Open, Distributed, RESTful Search Engine
Find a file
Rene Groeschke ea641cd359
Move public build api into included build #72861 (7.x backport) (#73715)
backport of #72861 to 7.x branch

This moves the public build api and plugins into a separete included build called 'build-tools' and we remove the duplication of included buildSrc twice (as build-tools).

The elasticsearch internal build logic is kept in build-tools-internal as included build which allows us better handling of this project that its just being an buildSrc project (e.g. we can reference tasks directly from the root build etc.)

Convention logic applied to both projects will live in a new build-conventions project.
2021-06-07 15:56:21 +02:00
.ci Bump version after 7.13.1 release 2021-06-02 20:40:16 +03:00
.github Add version command to issue template 2017-07-31 08:55:31 +09:00
.idea [7.x] Keep low level rest client under Apache 2 software license (#68697) 2021-02-08 11:14:18 -08:00
benchmarks Remove getMatchingFieldTypes method (#73655) 2021-06-03 11:43:28 +02:00
build-conventions Move public build api into included build #72861 (7.x backport) (#73715) 2021-06-07 15:56:21 +02:00
build-tools Move public build api into included build #72861 (7.x backport) (#73715) 2021-06-07 15:56:21 +02:00
build-tools-internal Move public build api into included build #72861 (7.x backport) (#73715) 2021-06-07 15:56:21 +02:00
buildSrc Move public build api into included build #72861 (7.x backport) (#73715) 2021-06-07 15:56:21 +02:00
client Move public build api into included build #72861 (7.x backport) (#73715) 2021-06-07 15:56:21 +02:00
dev-tools Update sources with new SSPL+Elastic-2.0 license headers 2021-02-02 18:07:23 -08:00
distribution Remove internal build logic from public build tool plugins (#72470) (7.x backport) (#72832) 2021-06-03 12:43:40 +02:00
docs Update runtime.asciidoc (#73802) (#73838) 2021-06-07 09:51:29 -04:00
gradle/wrapper Update Gradle wrapper to 7.0.2 (#73120) (#73122) 2021-05-15 00:11:23 +02:00
libs Upgrade Azure SDK and Jackson (#72833) (#72995) (#73493) 2021-05-27 16:45:01 -07:00
licenses [7.x] Keep low level rest client under Apache 2 software license (#68697) 2021-02-08 11:14:18 -08:00
modules Adjust REST test skip version for join field retrieval 2021-06-04 14:24:33 -07:00
plugins Remove internal build logic from public build tool plugins (#72470) (7.x backport) (#72832) 2021-06-03 12:43:40 +02:00
qa Make SnapshotStatusAction Cancellable (#73818) (#73829) 2021-06-07 14:36:34 +02:00
rest-api-spec Move public build api into included build #72861 (7.x backport) (#73715) 2021-06-07 15:56:21 +02:00
server Make SnapshotStatusAction Cancellable (#73818) (#73829) 2021-06-07 14:36:34 +02:00
test Make GetSnapshotsAction Cancellable (#72644) (#73820) 2021-06-07 13:17:46 +02:00
x-pack Move public build api into included build #72861 (7.x backport) (#73715) 2021-06-07 15:56:21 +02:00
.dir-locals.el Go back to 140 column limit in .dir-locals.el 2017-04-14 08:50:53 -06:00
.editorconfig Generate an IDE-compatible checkstyle configuration 2020-12-14 13:53:48 +00:00
.gitattributes Add a CHANGELOG file for release notes. (#29450) 2018-04-18 07:42:05 -07:00
.gitignore Move CI job configuration to elasticsearch repository 2021-05-06 16:30:05 -07:00
build.gradle Move public build api into included build #72861 (7.x backport) (#73715) 2021-06-07 15:56:21 +02:00
CONTRIBUTING.md Update CONTRIBUTING.md 2021-04-20 13:10:02 -04:00
elasticsearch Bump version to v7.14.0 2021-04-21 12:36:56 +01:00
gradle.properties Fix Spotless failing with InvocationTargetException on JDK 16 (#73246) (#73390) 2021-05-25 13:32:43 -07:00
gradlew Update gradle wrapper to 6.6 (#59909) (#60949) 2020-08-11 11:03:19 +02:00
gradlew.bat Update gradle wrapper to 6.6 (#59909) (#60949) 2020-08-11 11:03:19 +02:00
LICENSE.txt Update sources with new SSPL+Elastic-2.0 license headers 2021-02-02 18:07:23 -08:00
NOTICE.txt Update sources with new SSPL+Elastic-2.0 license headers 2021-02-02 18:07:23 -08:00
README.asciidoc [DOCS] Refactor quick start guide and README (#71331) (#71936) 2021-04-20 10:26:15 -04:00
settings.gradle Move public build api into included build #72861 (7.x backport) (#73715) 2021-06-07 15:56:21 +02:00
TESTING.asciidoc [DOCS] Fix double spaces (#71082) (#71120) 2021-03-31 11:43:34 -04:00
Vagrantfile Introduce ES_JAVA_HOME (#68954) 2021-02-17 12:44:34 -05:00

= Elasticsearch

Elasticsearch is the distributed, RESTful search and analytics engine at the
heart of the https://www.elastic.co/products[Elastic Stack]. You can use
Elasticsearch to store, search, and manage data for:

* Logs
* Metrics
* A search backend
* Application monitoring
* Endpoint security

\... and more!

To learn more about Elasticsearch's features and capabilities, see our
https://www.elastic.co/products/elasticsearch[product page].

[[get-started]]
== Get started

The simplest way to set up Elasticsearch is to create a managed deployment with
https://www.elastic.co/cloud/as-a-service[Elasticsearch Service on Elastic
Cloud].

If you prefer to install and manage Elasticsearch yourself, you can download
the latest version from 
https://www.elastic.co/downloads/elasticsearch[elastic.co/downloads/elasticsearch].

For more installation options, see the
https://www.elastic.co/guide/en/elasticsearch/reference/current/install-elasticsearch.html[Elasticsearch installation
documentation].

[[upgrade]]
== Upgrade

To upgrade from an earlier version of Elasticsearch, see the
https://www.elastic.co/guide/en/elasticsearch/reference/current/setup-upgrade.html[Elasticsearch upgrade
documentation].

[[build-source]]
== Build from source

Elasticsearch uses https://gradle.org[Gradle] for its build system.

To build a distribution for your local OS and print its output location upon
completion, run:
----
./gradlew localDistro
----

To build a distribution for another platform, run the related command:
----
./gradlew :distribution:archives:linux-tar:assemble
./gradlew :distribution:archives:darwin-tar:assemble
./gradlew :distribution:archives:windows-zip:assemble
----

To build distributions for all supported platforms, run:
----
./gradlew assemble
----

Distributions are output to `distributions/archives`.

To run the test suite, see xref:TESTING.asciidoc[TESTING].

[[docs]]
== Documentation

For the complete Elasticsearch documentation visit
https://www.elastic.co/guide/en/elasticsearch/reference/current/index.html[elastic.co].

For information about our documentation processes, see the
xref:docs/README.asciidoc[docs README].

[[contribute]]
== Contribute

For contribution guidelines, see xref:CONTRIBUTING.md[CONTRIBUTING]. 

[[questions]]
== Questions? Problems? Suggestions?

* To report a bug or request a feature, create a
https://github.com/elastic/elasticsearch/issues/new/choose[GitHub Issue]. Please
ensure someone else hasn't created an issue for the same topic.

* Need help using Elasticsearch? Reach out on the
https://discuss.elastic.co[Elastic Forum] or https://ela.st/slack[Slack]. A
fellow community member or Elastic engineer will be happy to help you out.