Document limitation of @QuarkusIntegrationTest using Docker image

[snazy]

Describe the bug

@QuarkusIntegrationTest runs against "any" "image type" (fast-jar, uber-jar, native image, Docker container), which is really neat.

@QuarkusIntegrationTest against Docker containers, when the tested application runs inside a Docker container, has an important limitation compared to the now deprecated-for-removal @NativeImageTest option, which is probably worth documenting.

Since the tested application runs inside a Docker container, the tested application cannot access resources running on the Docker host. Integration tests that for example use testcontainers need to be updated to use the proper Docker-network hostname.

OidcWiremockTestResource does not work with @QuarkusIntegrationTest against Docker containers, because the Wiremock server is running in the JVM running the test, which cannot be accessed from the Docker container running the Quarkus application.

Unfortunately there's no system property which can be easily checked for the currently tested Quarkus image type (fast/uber jar, native, docker). Seems worth to have such a property - or better: a way to only limit/restrict tests, likely with a new @DisabledOnNativeDockerImage annotation similar to @DisabledOnNativeImage and @DisabledOnIntegrationTest? Or add a set of "disabled image types" to @DisabledOnIntegrationTest?

Testcontainers JdbcDatabaseContainer example:
Old way was to simply use JdbcDatabaseContainer.getJdbcUrl(), but now it requires:

public class MyTestResourceLifecycleManager implements QuarkusTestResourceLifecycleManager, DevServicesContext.ContextAware {
  private Optional<String> containerNetworkId;

  @Override
  public void setIntegrationTestContext(DevServicesContext context) {
    containerNetworkId = context.containerNetworkId();
  }

  @Override
  public Map<String, String> start() {
    JdbcDatabaseContainer container = new PostgreSQLContainer ...
    
    String jdbcUrl = container.getJdbcUrl();

    // Replace hostname + port in the provided JDBC URL with the hostname of the Docker container
    // running PostgreSQL and the listening port.
    if (containerNetworkId.isPresent()) {
      String hostPort = container.getHost() + ':' + container.getMappedPort(POSTGRESQL_PORT);
      String networkHostPort =
          container.getCurrentContainerInfo().getConfig().getHostName() + ':' + POSTGRESQL_PORT;
      jdbcUrl = jdbcUrl.replace(hostPort, networkHostPort);
    }

    return ImmutableMap.of(
        "quarkus.datasource.username", container.getUsername(),
        "quarkus.datasource.password", container.getPassword(),
        "quarkus.datasource.jdbc.url", jdbcUrl);
  }
}
`` 

### Quarkus version or git rev

2.8.0

[quarkus-bot]

/cc @geoand

[geoand]

Thanks for reporting!

Would you like to contribute the documentation improvement?

[snazy]

Would you like to contribute the documentation improvement?

Can take a stab on it.

[geoand]

Or add a set of "disabled image types" to @DisabledOnIntegrationTest?

This is an interesting idea! I'll have a look.