Skip to content

Commit a115721

Browse files
committed
Document current behaviour for integration tests
1 parent 751dd22 commit a115721

File tree

1 file changed

+12
-1
lines changed

1 file changed

+12
-1
lines changed

CONTRIBUTING.md

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -241,7 +241,7 @@ javadoc...).
241241
Be sure to test your pull request in:
242242

243243
1. Java mode
244-
2. Native mode
244+
2. Native mode (with `-Dnative`)
245245

246246
Also, make sure that any native tests you add will actually get executed on CI.
247247
In the interest of speeding up CI, the native build job `native-tests` have been split into multiple categories which
@@ -549,6 +549,17 @@ this is by executing the following command:
549549
./mvnw test -f integration-tests/resteasy-jackson/ -Dtest=GreetingResourceTest
550550
```
551551

552+
#### Running integration tests
553+
554+
By default, in the Quarkus codebase, all tests ending in *IT are skipped, even with the verify goal.
555+
This means most `@QuarkusIntegrationTest` tests in the Quarkus codebase only run when `-Dnative` is added to the command line.
556+
Even using the `verify` goal and adding `-DskipITs=false` is not enough to run these tests.
557+
Only `-Dnative` will trigger them.
558+
Note that this is a behaviour difference to what's [documented externally](https://quarkus.io/guides/getting-started-testing#quarkus-integration-test).
559+
560+
Why the different behaviour? Quarkus builds are _long_, and running every integration test twice would make them even longer.
561+
In most cases, coverage in the native build is sufficient.
562+
552563
##### Maven Invoker tests
553564

554565
For testing some scenarios, Quarkus uses the [Maven Invoker](https://maven.apache.org/shared/maven-invoker/) to run

0 commit comments

Comments
 (0)