parent
f22700812e
commit
598b0a0eb4
|
@ -229,34 +229,6 @@ Pass arbitrary jvm arguments.
|
||||||
./gradlew test -Dtests.jvm.argline="-Djava.security.debug=access,failure"
|
./gradlew test -Dtests.jvm.argline="-Djava.security.debug=access,failure"
|
||||||
------------------------------
|
------------------------------
|
||||||
|
|
||||||
== Backwards Compatibility Tests
|
|
||||||
|
|
||||||
Running backwards compatibility tests is disabled by default since it
|
|
||||||
requires a release version of elasticsearch to be present on the test system.
|
|
||||||
To run backwards compatibility tests untar or unzip a release and run the tests
|
|
||||||
with the following command:
|
|
||||||
|
|
||||||
---------------------------------------------------------------------------
|
|
||||||
./gradlew test -Dtests.filter="@backwards" -Dtests.bwc.version=x.y.z -Dtests.bwc.path=/path/to/elasticsearch -Dtests.security.manager=false
|
|
||||||
---------------------------------------------------------------------------
|
|
||||||
|
|
||||||
Note that backwards tests must be run with security manager disabled.
|
|
||||||
If the elasticsearch release is placed under `./backwards/elasticsearch-x.y.z` the path
|
|
||||||
can be omitted:
|
|
||||||
|
|
||||||
---------------------------------------------------------------------------
|
|
||||||
./gradlew test -Dtests.filter="@backwards" -Dtests.bwc.version=x.y.z -Dtests.security.manager=false
|
|
||||||
---------------------------------------------------------------------------
|
|
||||||
|
|
||||||
To setup the bwc test environment execute the following steps (provided you are
|
|
||||||
already in your elasticsearch clone):
|
|
||||||
|
|
||||||
---------------------------------------------------------------------------
|
|
||||||
$ mkdir backwards && cd backwards
|
|
||||||
$ curl -O https://download.elasticsearch.org/elasticsearch/elasticsearch/elasticsearch-1.2.1.tar.gz
|
|
||||||
$ tar -xzf elasticsearch-1.2.1.tar.gz
|
|
||||||
---------------------------------------------------------------------------
|
|
||||||
|
|
||||||
== Running verification tasks
|
== Running verification tasks
|
||||||
|
|
||||||
To run all verification tasks, including static checks, unit tests, and integration tests:
|
To run all verification tasks, including static checks, unit tests, and integration tests:
|
||||||
|
@ -554,25 +526,28 @@ environment variable.
|
||||||
== Testing backwards compatibility
|
== Testing backwards compatibility
|
||||||
|
|
||||||
Backwards compatibility tests exist to test upgrading from each supported version
|
Backwards compatibility tests exist to test upgrading from each supported version
|
||||||
to the current version. To run all backcompat tests use:
|
to the current version. To run them all use:
|
||||||
|
|
||||||
-------------------------------------------------
|
-------------------------------------------------
|
||||||
./gradlew bwcTest
|
./gradlew bwcTest
|
||||||
-------------------------------------------------
|
-------------------------------------------------
|
||||||
|
|
||||||
A specific version can be tested as well. For example, to test backcompat with
|
A specific version can be tested as well. For example, to test bwc with
|
||||||
version 5.3.2 run:
|
version 5.3.2 run:
|
||||||
|
|
||||||
-------------------------------------------------
|
-------------------------------------------------
|
||||||
./gradlew v5.3.2#bwcTest
|
./gradlew v5.3.2#bwcTest
|
||||||
-------------------------------------------------
|
-------------------------------------------------
|
||||||
|
|
||||||
When running `./gradlew check`, some minimal backcompat checks are run. Which version
|
Tests are ran for versions that are not yet released but with which the current version will be compatible with.
|
||||||
is tested depends on the branch. On master, this will test against the current
|
These are automatically checked out and built from source.
|
||||||
stable branch. On the stable branch, it will test against the latest release
|
See link:./buildSrc/src/main/java/org/elasticsearch/gradle/VersionCollection.java[VersionCollection]
|
||||||
branch. Finally, on a release branch, it will test against the most recent release.
|
and link:./distribution/bwc/build.gradle[distribution/bwc/build.gradle]
|
||||||
|
for more information.
|
||||||
|
|
||||||
=== BWC Testing against a specific remote/branch
|
When running `./gradlew check`, minimal bwc checks are also run against compatible versions that are not yet released.
|
||||||
|
|
||||||
|
==== BWC Testing against a specific remote/branch
|
||||||
|
|
||||||
Sometimes a backward compatibility change spans two versions. A common case is a new functionality
|
Sometimes a backward compatibility change spans two versions. A common case is a new functionality
|
||||||
that needs a BWC bridge in an unreleased versioned of a release branch (for example, 5.x).
|
that needs a BWC bridge in an unreleased versioned of a release branch (for example, 5.x).
|
||||||
|
@ -597,7 +572,7 @@ will contain your change.
|
||||||
. Push both branches to your remote repository.
|
. Push both branches to your remote repository.
|
||||||
. Run the tests with `./gradlew check -Dtests.bwc.remote=${remote} -Dtests.bwc.refspec.5.x=index_req_bwc_5.x`.
|
. Run the tests with `./gradlew check -Dtests.bwc.remote=${remote} -Dtests.bwc.refspec.5.x=index_req_bwc_5.x`.
|
||||||
|
|
||||||
== Skip fetching latest
|
==== Skip fetching latest
|
||||||
|
|
||||||
For some BWC testing scenarios, you want to use the local clone of the
|
For some BWC testing scenarios, you want to use the local clone of the
|
||||||
repository without fetching latest. For these use cases, you can set the system
|
repository without fetching latest. For these use cases, you can set the system
|
||||||
|
|
Loading…
Reference in New Issue