From d9e91f78db4656fd188decf6ef50375a4a666f1a Mon Sep 17 00:00:00 2001 From: GitHub Action Date: Wed, 16 Oct 2024 01:59:36 +0000 Subject: [PATCH] Sync documentation of main branch --- .../main/config/quarkus-all-config.adoc | 119 +++--------------- .../quarkus-smallrye-graphql-client.adoc | 119 +++--------------- ...lient_quarkus.smallrye-graphql-client.adoc | 119 +++--------------- _versions/main/guides/cdi-reference.adoc | 17 +++ .../main/guides/getting-started-testing.adoc | 81 ++++++++++++ .../main/guides/tls-registry-reference.adoc | 21 +++- 6 files changed, 169 insertions(+), 307 deletions(-) diff --git a/_generated-doc/main/config/quarkus-all-config.adoc b/_generated-doc/main/config/quarkus-all-config.adoc index ce9099d84a..b354593310 100644 --- a/_generated-doc/main/config/quarkus-all-config.adoc +++ b/_generated-doc/main/config/quarkus-all-config.adoc @@ -71287,108 +71287,6 @@ endif::add-copy-button-to-env-var[] |int | -a| [[quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-trust-store]] [.property-path]##link:#quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-trust-store[`quarkus.smallrye-graphql-client."clients".trust-store`]## - -[.description] --- -The trust store location. Can point to either a classpath resource or a file. - - -ifdef::add-copy-button-to-env-var[] -Environment variable: env_var_with_copy_button:+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__TRUST_STORE+++[] -endif::add-copy-button-to-env-var[] -ifndef::add-copy-button-to-env-var[] -Environment variable: `+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__TRUST_STORE+++` -endif::add-copy-button-to-env-var[] --- -|string -| - -a| [[quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-trust-store-password]] [.property-path]##link:#quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-trust-store-password[`quarkus.smallrye-graphql-client."clients".trust-store-password`]## - -[.description] --- -The trust store password. - - -ifdef::add-copy-button-to-env-var[] -Environment variable: env_var_with_copy_button:+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__TRUST_STORE_PASSWORD+++[] -endif::add-copy-button-to-env-var[] -ifndef::add-copy-button-to-env-var[] -Environment variable: `+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__TRUST_STORE_PASSWORD+++` -endif::add-copy-button-to-env-var[] --- -|string -| - -a| [[quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-trust-store-type]] [.property-path]##link:#quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-trust-store-type[`quarkus.smallrye-graphql-client."clients".trust-store-type`]## - -[.description] --- -The type of the trust store. Defaults to "JKS". - - -ifdef::add-copy-button-to-env-var[] -Environment variable: env_var_with_copy_button:+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__TRUST_STORE_TYPE+++[] -endif::add-copy-button-to-env-var[] -ifndef::add-copy-button-to-env-var[] -Environment variable: `+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__TRUST_STORE_TYPE+++` -endif::add-copy-button-to-env-var[] --- -|string -| - -a| [[quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-key-store]] [.property-path]##link:#quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-key-store[`quarkus.smallrye-graphql-client."clients".key-store`]## - -[.description] --- -The key store location. Can point to either a classpath resource or a file. - - -ifdef::add-copy-button-to-env-var[] -Environment variable: env_var_with_copy_button:+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__KEY_STORE+++[] -endif::add-copy-button-to-env-var[] -ifndef::add-copy-button-to-env-var[] -Environment variable: `+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__KEY_STORE+++` -endif::add-copy-button-to-env-var[] --- -|string -| - -a| [[quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-key-store-password]] [.property-path]##link:#quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-key-store-password[`quarkus.smallrye-graphql-client."clients".key-store-password`]## - -[.description] --- -The key store password. - - -ifdef::add-copy-button-to-env-var[] -Environment variable: env_var_with_copy_button:+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__KEY_STORE_PASSWORD+++[] -endif::add-copy-button-to-env-var[] -ifndef::add-copy-button-to-env-var[] -Environment variable: `+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__KEY_STORE_PASSWORD+++` -endif::add-copy-button-to-env-var[] --- -|string -| - -a| [[quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-key-store-type]] [.property-path]##link:#quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-key-store-type[`quarkus.smallrye-graphql-client."clients".key-store-type`]## - -[.description] --- -The type of the key store. Defaults to "JKS". - - -ifdef::add-copy-button-to-env-var[] -Environment variable: env_var_with_copy_button:+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__KEY_STORE_TYPE+++[] -endif::add-copy-button-to-env-var[] -ifndef::add-copy-button-to-env-var[] -Environment variable: `+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__KEY_STORE_TYPE+++` -endif::add-copy-button-to-env-var[] --- -|string -| - a| [[quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-proxy-host]] [.property-path]##link:#quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-proxy-host[`quarkus.smallrye-graphql-client."clients".proxy-host`]## [.description] @@ -71508,6 +71406,23 @@ endif::add-copy-button-to-env-var[] |boolean | +a| [[quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-tls-configuration-name]] [.property-path]##link:#quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-tls-configuration-name[`quarkus.smallrye-graphql-client."clients".tls-configuration-name`]## + +[.description] +-- +The name of the TLS configuration (bucket) used for client authentication in the TLS registry. + + +ifdef::add-copy-button-to-env-var[] +Environment variable: env_var_with_copy_button:+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__TLS_CONFIGURATION_NAME+++[] +endif::add-copy-button-to-env-var[] +ifndef::add-copy-button-to-env-var[] +Environment variable: `+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__TLS_CONFIGURATION_NAME+++` +endif::add-copy-button-to-env-var[] +-- +|string +| + h|[.extension-name]##SmallRye Health## h|Type diff --git a/_generated-doc/main/config/quarkus-smallrye-graphql-client.adoc b/_generated-doc/main/config/quarkus-smallrye-graphql-client.adoc index 696a3a87b0..bbd44219f8 100644 --- a/_generated-doc/main/config/quarkus-smallrye-graphql-client.adoc +++ b/_generated-doc/main/config/quarkus-smallrye-graphql-client.adoc @@ -109,108 +109,6 @@ endif::add-copy-button-to-env-var[] |int | -a| [[quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-trust-store]] [.property-path]##link:#quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-trust-store[`quarkus.smallrye-graphql-client."clients".trust-store`]## - -[.description] --- -The trust store location. Can point to either a classpath resource or a file. - - -ifdef::add-copy-button-to-env-var[] -Environment variable: env_var_with_copy_button:+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__TRUST_STORE+++[] -endif::add-copy-button-to-env-var[] -ifndef::add-copy-button-to-env-var[] -Environment variable: `+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__TRUST_STORE+++` -endif::add-copy-button-to-env-var[] --- -|string -| - -a| [[quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-trust-store-password]] [.property-path]##link:#quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-trust-store-password[`quarkus.smallrye-graphql-client."clients".trust-store-password`]## - -[.description] --- -The trust store password. - - -ifdef::add-copy-button-to-env-var[] -Environment variable: env_var_with_copy_button:+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__TRUST_STORE_PASSWORD+++[] -endif::add-copy-button-to-env-var[] -ifndef::add-copy-button-to-env-var[] -Environment variable: `+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__TRUST_STORE_PASSWORD+++` -endif::add-copy-button-to-env-var[] --- -|string -| - -a| [[quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-trust-store-type]] [.property-path]##link:#quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-trust-store-type[`quarkus.smallrye-graphql-client."clients".trust-store-type`]## - -[.description] --- -The type of the trust store. Defaults to "JKS". - - -ifdef::add-copy-button-to-env-var[] -Environment variable: env_var_with_copy_button:+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__TRUST_STORE_TYPE+++[] -endif::add-copy-button-to-env-var[] -ifndef::add-copy-button-to-env-var[] -Environment variable: `+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__TRUST_STORE_TYPE+++` -endif::add-copy-button-to-env-var[] --- -|string -| - -a| [[quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-key-store]] [.property-path]##link:#quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-key-store[`quarkus.smallrye-graphql-client."clients".key-store`]## - -[.description] --- -The key store location. Can point to either a classpath resource or a file. - - -ifdef::add-copy-button-to-env-var[] -Environment variable: env_var_with_copy_button:+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__KEY_STORE+++[] -endif::add-copy-button-to-env-var[] -ifndef::add-copy-button-to-env-var[] -Environment variable: `+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__KEY_STORE+++` -endif::add-copy-button-to-env-var[] --- -|string -| - -a| [[quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-key-store-password]] [.property-path]##link:#quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-key-store-password[`quarkus.smallrye-graphql-client."clients".key-store-password`]## - -[.description] --- -The key store password. - - -ifdef::add-copy-button-to-env-var[] -Environment variable: env_var_with_copy_button:+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__KEY_STORE_PASSWORD+++[] -endif::add-copy-button-to-env-var[] -ifndef::add-copy-button-to-env-var[] -Environment variable: `+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__KEY_STORE_PASSWORD+++` -endif::add-copy-button-to-env-var[] --- -|string -| - -a| [[quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-key-store-type]] [.property-path]##link:#quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-key-store-type[`quarkus.smallrye-graphql-client."clients".key-store-type`]## - -[.description] --- -The type of the key store. Defaults to "JKS". - - -ifdef::add-copy-button-to-env-var[] -Environment variable: env_var_with_copy_button:+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__KEY_STORE_TYPE+++[] -endif::add-copy-button-to-env-var[] -ifndef::add-copy-button-to-env-var[] -Environment variable: `+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__KEY_STORE_TYPE+++` -endif::add-copy-button-to-env-var[] --- -|string -| - a| [[quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-proxy-host]] [.property-path]##link:#quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-proxy-host[`quarkus.smallrye-graphql-client."clients".proxy-host`]## [.description] @@ -330,5 +228,22 @@ endif::add-copy-button-to-env-var[] |boolean | +a| [[quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-tls-configuration-name]] [.property-path]##link:#quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-tls-configuration-name[`quarkus.smallrye-graphql-client."clients".tls-configuration-name`]## + +[.description] +-- +The name of the TLS configuration (bucket) used for client authentication in the TLS registry. + + +ifdef::add-copy-button-to-env-var[] +Environment variable: env_var_with_copy_button:+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__TLS_CONFIGURATION_NAME+++[] +endif::add-copy-button-to-env-var[] +ifndef::add-copy-button-to-env-var[] +Environment variable: `+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__TLS_CONFIGURATION_NAME+++` +endif::add-copy-button-to-env-var[] +-- +|string +| + |=== diff --git a/_generated-doc/main/config/quarkus-smallrye-graphql-client_quarkus.smallrye-graphql-client.adoc b/_generated-doc/main/config/quarkus-smallrye-graphql-client_quarkus.smallrye-graphql-client.adoc index 696a3a87b0..bbd44219f8 100644 --- a/_generated-doc/main/config/quarkus-smallrye-graphql-client_quarkus.smallrye-graphql-client.adoc +++ b/_generated-doc/main/config/quarkus-smallrye-graphql-client_quarkus.smallrye-graphql-client.adoc @@ -109,108 +109,6 @@ endif::add-copy-button-to-env-var[] |int | -a| [[quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-trust-store]] [.property-path]##link:#quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-trust-store[`quarkus.smallrye-graphql-client."clients".trust-store`]## - -[.description] --- -The trust store location. Can point to either a classpath resource or a file. - - -ifdef::add-copy-button-to-env-var[] -Environment variable: env_var_with_copy_button:+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__TRUST_STORE+++[] -endif::add-copy-button-to-env-var[] -ifndef::add-copy-button-to-env-var[] -Environment variable: `+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__TRUST_STORE+++` -endif::add-copy-button-to-env-var[] --- -|string -| - -a| [[quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-trust-store-password]] [.property-path]##link:#quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-trust-store-password[`quarkus.smallrye-graphql-client."clients".trust-store-password`]## - -[.description] --- -The trust store password. - - -ifdef::add-copy-button-to-env-var[] -Environment variable: env_var_with_copy_button:+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__TRUST_STORE_PASSWORD+++[] -endif::add-copy-button-to-env-var[] -ifndef::add-copy-button-to-env-var[] -Environment variable: `+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__TRUST_STORE_PASSWORD+++` -endif::add-copy-button-to-env-var[] --- -|string -| - -a| [[quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-trust-store-type]] [.property-path]##link:#quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-trust-store-type[`quarkus.smallrye-graphql-client."clients".trust-store-type`]## - -[.description] --- -The type of the trust store. Defaults to "JKS". - - -ifdef::add-copy-button-to-env-var[] -Environment variable: env_var_with_copy_button:+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__TRUST_STORE_TYPE+++[] -endif::add-copy-button-to-env-var[] -ifndef::add-copy-button-to-env-var[] -Environment variable: `+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__TRUST_STORE_TYPE+++` -endif::add-copy-button-to-env-var[] --- -|string -| - -a| [[quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-key-store]] [.property-path]##link:#quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-key-store[`quarkus.smallrye-graphql-client."clients".key-store`]## - -[.description] --- -The key store location. Can point to either a classpath resource or a file. - - -ifdef::add-copy-button-to-env-var[] -Environment variable: env_var_with_copy_button:+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__KEY_STORE+++[] -endif::add-copy-button-to-env-var[] -ifndef::add-copy-button-to-env-var[] -Environment variable: `+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__KEY_STORE+++` -endif::add-copy-button-to-env-var[] --- -|string -| - -a| [[quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-key-store-password]] [.property-path]##link:#quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-key-store-password[`quarkus.smallrye-graphql-client."clients".key-store-password`]## - -[.description] --- -The key store password. - - -ifdef::add-copy-button-to-env-var[] -Environment variable: env_var_with_copy_button:+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__KEY_STORE_PASSWORD+++[] -endif::add-copy-button-to-env-var[] -ifndef::add-copy-button-to-env-var[] -Environment variable: `+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__KEY_STORE_PASSWORD+++` -endif::add-copy-button-to-env-var[] --- -|string -| - -a| [[quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-key-store-type]] [.property-path]##link:#quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-key-store-type[`quarkus.smallrye-graphql-client."clients".key-store-type`]## - -[.description] --- -The type of the key store. Defaults to "JKS". - - -ifdef::add-copy-button-to-env-var[] -Environment variable: env_var_with_copy_button:+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__KEY_STORE_TYPE+++[] -endif::add-copy-button-to-env-var[] -ifndef::add-copy-button-to-env-var[] -Environment variable: `+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__KEY_STORE_TYPE+++` -endif::add-copy-button-to-env-var[] --- -|string -| - a| [[quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-proxy-host]] [.property-path]##link:#quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-proxy-host[`quarkus.smallrye-graphql-client."clients".proxy-host`]## [.description] @@ -330,5 +228,22 @@ endif::add-copy-button-to-env-var[] |boolean | +a| [[quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-tls-configuration-name]] [.property-path]##link:#quarkus-smallrye-graphql-client_quarkus-smallrye-graphql-client-clients-tls-configuration-name[`quarkus.smallrye-graphql-client."clients".tls-configuration-name`]## + +[.description] +-- +The name of the TLS configuration (bucket) used for client authentication in the TLS registry. + + +ifdef::add-copy-button-to-env-var[] +Environment variable: env_var_with_copy_button:+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__TLS_CONFIGURATION_NAME+++[] +endif::add-copy-button-to-env-var[] +ifndef::add-copy-button-to-env-var[] +Environment variable: `+++QUARKUS_SMALLRYE_GRAPHQL_CLIENT__CLIENTS__TLS_CONFIGURATION_NAME+++` +endif::add-copy-button-to-env-var[] +-- +|string +| + |=== diff --git a/_versions/main/guides/cdi-reference.adoc b/_versions/main/guides/cdi-reference.adoc index 69d4c96b95..02672f4e52 100644 --- a/_versions/main/guides/cdi-reference.adoc +++ b/_versions/main/guides/cdi-reference.adoc @@ -1394,6 +1394,23 @@ public class MyBean { } ---- +=== Asynchronous Observers + +CDI asynchronous observers (`@ObservesAsync`) are not aware of reactive programming and are not meant to be used as part of reactive pipelines. +The observer methods are meant to be synchronous, they are just offloaded to a thread pool. + +The `Event.fireAsync()` method returns a `CompletionStage` that completes when all observers are notified. +If all observers were notified successfully, the `CompletionStage` completes with the event payload. +If some observers have thrown an exception, the `CompletionStage` completes exceptionally with a `CompletionException`. + +The return type of the observer _does not matter_. +The return value of the observer is _ignored_. + +You may declare an observer method that has a return type of `CompletionStage<>` or `Uni<>`, but neither the return type nor the actual return value affect the result of `Event.fireAsync()`. +Further, if the observer declares a return type of `Uni<>`, the returned `Uni` will not be subscribed to, so it is quite possible that part of the observer logic will not even execute. + +Therefore, it is recommended that observer methods, both synchronous and asynchronous, are always declared `void`. + [[build_time_apis]] == Build Time Extensions diff --git a/_versions/main/guides/getting-started-testing.adoc b/_versions/main/guides/getting-started-testing.adoc index 7495ce2c11..561fa12fed 100644 --- a/_versions/main/guides/getting-started-testing.adoc +++ b/_versions/main/guides/getting-started-testing.adoc @@ -1475,6 +1475,87 @@ You can use this tag to isolate the `@QuarkusTest` test in a specific execution ---- +[NOTE] +-- +Currently `@QuarkusTest` and `@QuarkusIntegrationTest` should not be run in the same test run. + +For Maven, this means that the former should be run by the surefire plugin while the latter should be run by the failsafe plugin. + +For Gradle, this means the two types of tests should belong to different source sets. + +.Source set configuration example +[%collapsible] +==== +[source,kotlin,subs=attributes+] +---- +/** custom source sets + * + * io.quarkus.gradle.QuarkusPlugin + * io.quarkus.test.junit.IntegrationTestUtil + * + * to work around + * https://github.com/quarkusio/quarkus/issues/43796 + * https://github.com/quarkusio/quarkus/issues/43804 + */ + +sourceSets { + create("intTest") { + compileClasspath += sourceSets.main.get().output + runtimeClasspath += sourceSets.main.get().output + } + create("e2eTest") { + compileClasspath += sourceSets.main.get().output + runtimeClasspath += sourceSets.main.get().output + } +} + +configurations { + getByName("intTestImplementation") { + extendsFrom(configurations.testImplementation.get()) + } + getByName("intTestRuntimeOnly") { + extendsFrom(configurations.testRuntimeOnly.get()) + } + getByName("e2eTestImplementation") { + extendsFrom(configurations.testImplementation.get()) + } + getByName("e2eTestRuntimeOnly") { + extendsFrom(configurations.testRuntimeOnly.get()) + } +} + +tasks.register("intTest") { + group = "verification" + description = "Runs integration tests" + + testClassesDirs = sourceSets["intTest"].output.classesDirs + classpath = sourceSets["intTest"].runtimeClasspath + + systemProperty("build.output.directory", "build") + systemProperty("quarkus.profile", "intTest") +} + +tasks.register("e2eTest") { + group = "verification" + description = "Runs e2e tests" + + val quarkusBuild = tasks.getByName("quarkusBuild") + dependsOn(quarkusBuild) + + testClassesDirs = sourceSets["e2eTest"].output.classesDirs + classpath = sourceSets["e2eTest"].runtimeClasspath + + systemProperty("build.output.directory", "build") +} + +idea.module { + testSources.from(sourceSets["intTest"].kotlin.srcDirs) + testSources.from(sourceSets["e2eTest"].kotlin.srcDirs) +} +---- +==== +-- + [[test-from-ide]] == Running `@QuarkusTest` from an IDE diff --git a/_versions/main/guides/tls-registry-reference.adoc b/_versions/main/guides/tls-registry-reference.adoc index 297cfa50f1..4024783fe2 100644 --- a/_versions/main/guides/tls-registry-reference.adoc +++ b/_versions/main/guides/tls-registry-reference.adoc @@ -21,11 +21,12 @@ The TLS Registry consolidates settings and supports multiple named configuration Therefore, you can tailor TLS settings for different application parts. This flexibility is particularly useful when different components require distinct security configurations. -The TLS Registry extension is automatically included in your project when you use compatible extensions, such as Quarkus REST, gRPC +The TLS Registry extension is automatically included in your project when you use compatible extensions, such as Quarkus REST, gRPC, SmallRye GraphQL Client ifndef::no-reactive-routes[] , or Reactive Routes endif::no-reactive-routes[] . + As a result, applications that use the TLS Registry can be ready to handle secure communications out of the box. TLS Registry also provides features like automatic certificate reloading, Let's Encrypt (ACME) integration, Kubernetes Cert-Manager support, and compatibility with various keystore formats, such as PKCS12, PEM, and JKS. @@ -149,6 +150,24 @@ quarkus.http.tls-configuration-name=MY_TLS_CONFIGURATION quarkus.grpc.clients.hello.tls-configuration-name=MY_TLS_CONFIGURATION ---- +.Example configuration for a SmallRye GraphQL client: +[source,properties] +---- +quarkus.smallrye-graphql-client.my-client.tls-configuration-name=MY_TLS_CONFIGURATION +---- + +[NOTE] +==== +When using the Typesafe GraphQL client with a certificate +reloading mechanism (see <>), it is essential to +override the bean's scope to `RequestScoped` (or another similar scope +shorter than application). This is because by default, the Typesafe client is an +application-scoped bean, so shortening the scope guarantees that new instances of the bean +created after a certificate reload will be configured with the latest +certificate. Dynamic clients are `@Dependent` scoped, so you should +inject them into components with an appropriate scope. +==== + == Configuring TLS TLS configuration primarily involves managing keystores and truststores.