Skip to content

Commit 2d84015

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

File tree

1 file changed

+10
-1
lines changed

1 file changed

+10
-1
lines changed

CONTRIBUTING.md

Lines changed: 10 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,15 @@ 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+
Most `@QuarkusIntegrationTest` tests in the Quarkus codebase only run when `-Dnative` is added to the command line.
555+
Using the `verify` goal and adding `-DskipITs=false` is *not* enough to run these tests.
556+
Note that this is a behaviour difference to what's [documented externally](https://quarkus.io/guides/getting-started-testing#quarkus-integration-test).
557+
558+
Why the different behaviour? Quarkus builds are _long_, and running every integration test twice would make them even longer.
559+
In most cases, coverage in the native build is sufficient.
560+
552561
##### Maven Invoker tests
553562

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

0 commit comments

Comments
 (0)