From 256159cccacaff79f2cdf40d6faeb5ed5ed8dad6 Mon Sep 17 00:00:00 2001 From: quarkusbot Date: Wed, 13 Nov 2024 17:33:56 +0000 Subject: [PATCH] Sync web site with Quarkus documentation --- .../latest/config/quarkus-all-config.adoc | 44 ++++++++++++++++++- .../quarkus-container-image-docker.adoc | 14 ++++++ ...container-image-docker_quarkus.docker.adoc | 14 ++++++ .../quarkus-container-image-podman.adoc | 14 ++++++ ...container-image-podman_quarkus.podman.adoc | 14 ++++++ .../config/quarkus-devservices-keycloak.adoc | 2 +- ...devservices-keycloak_quarkus.keycloak.adoc | 2 +- .../latest/config/quarkus-narayana-jta.adoc | 14 ++++++ ...ayana-jta_quarkus.transaction-manager.adoc | 14 ++++++ .../latest/infra/quarkus-all-build-items.adoc | 4 ++ _guides/_attributes.adoc | 2 +- _guides/funqy-gcp-functions.adoc | 15 ++++--- _guides/gcp-functions-http.adoc | 4 +- _guides/gcp-functions.adoc | 15 ++++--- _guides/opentelemetry-tracing.adoc | 4 +- 15 files changed, 158 insertions(+), 18 deletions(-) diff --git a/_generated-doc/latest/config/quarkus-all-config.adoc b/_generated-doc/latest/config/quarkus-all-config.adoc index ea89e12916..3e46a8de5f 100644 --- a/_generated-doc/latest/config/quarkus-all-config.adoc +++ b/_generated-doc/latest/config/quarkus-all-config.adoc @@ -2179,6 +2179,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-docker_quarkus- [.description] -- +Path to the JVM Dockerfile. If set to an absolute path then the absolute path will be used, otherwise the path will be considered relative to the project root. If not set src/main/docker/Dockerfile.jvm will be used. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_DOCKER_DOCKERFILE_JVM_PATH+++[] @@ -2194,6 +2196,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-docker_quarkus- [.description] -- +Path to the native Dockerfile. If set to an absolute path then the absolute path will be used, otherwise the path will be considered relative to the project root. If not set src/main/docker/Dockerfile.native will be used. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_DOCKER_DOCKERFILE_NATIVE_PATH+++[] @@ -2209,6 +2213,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-docker_quarkus- [.description] -- +Build args passed to docker via `--build-arg` + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_DOCKER_BUILD_ARGS__ARG_NAME_+++[] @@ -2224,6 +2230,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-docker_quarkus- [.description] -- +Images to consider as cache sources. Values are passed to `docker build`/`podman build` via the `cache-from` option + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_DOCKER_CACHE_FROM+++[] @@ -2239,6 +2247,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-docker_quarkus- [.description] -- +The networking mode for the RUN instructions during build + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_DOCKER_NETWORK+++[] @@ -2254,6 +2264,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-docker_quarkus- [.description] -- +Name of binary used to execute the docker/podman commands. This setting can override the global container runtime detection. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_DOCKER_EXECUTABLE_NAME+++[] @@ -2269,6 +2281,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-docker_quarkus- [.description] -- +Additional arbitrary arguments passed to the executable when building the container image. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_DOCKER_ADDITIONAL_ARGS+++[] @@ -3192,6 +3206,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-podman_quarkus- [.description] -- +Path to the JVM Dockerfile. If set to an absolute path then the absolute path will be used, otherwise the path will be considered relative to the project root. If not set src/main/docker/Dockerfile.jvm will be used. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_PODMAN_DOCKERFILE_JVM_PATH+++[] @@ -3207,6 +3223,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-podman_quarkus- [.description] -- +Path to the native Dockerfile. If set to an absolute path then the absolute path will be used, otherwise the path will be considered relative to the project root. If not set src/main/docker/Dockerfile.native will be used. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_PODMAN_DOCKERFILE_NATIVE_PATH+++[] @@ -3222,6 +3240,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-podman_quarkus- [.description] -- +Build args passed to docker via `--build-arg` + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_PODMAN_BUILD_ARGS__ARG_NAME_+++[] @@ -3237,6 +3257,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-podman_quarkus- [.description] -- +Images to consider as cache sources. Values are passed to `docker build`/`podman build` via the `cache-from` option + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_PODMAN_CACHE_FROM+++[] @@ -3252,6 +3274,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-podman_quarkus- [.description] -- +The networking mode for the RUN instructions during build + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_PODMAN_NETWORK+++[] @@ -3267,6 +3291,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-podman_quarkus- [.description] -- +Name of binary used to execute the docker/podman commands. This setting can override the global container runtime detection. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_PODMAN_EXECUTABLE_NAME+++[] @@ -3282,6 +3308,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-podman_quarkus- [.description] -- +Additional arbitrary arguments passed to the executable when building the container image. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_PODMAN_ADDITIONAL_ARGS+++[] @@ -9046,7 +9074,7 @@ a|icon:lock[title=Fixed at build time] [[quarkus-devservices-keycloak_quarkus-ke [.description] -- -Specifies whether to create the default client id `quarkus-app` with a secret `secret`and register them if the `create-realm` property is set to true. For OIDC extension configuration properties `quarkus.oidc.client.id` and `quarkus.oidc.credentials.secret` will be configured. For OIDC Client extension configuration properties `quarkus.oidc-client.client.id` and `quarkus.oidc-client.credentials.secret` will be configured. Set to `false` if clients have to be created using either the Keycloak Administration Console or the Keycloak Admin API provided by `io.quarkus.test.common.QuarkusTestResourceLifecycleManager` or registered dynamically. +Specifies whether to create the default client id `quarkus-app` with a secret `secret` and register them if the `create-realm` property is set to true. For OIDC extension configuration properties `quarkus.oidc.client.id` and `quarkus.oidc.credentials.secret` will be configured. For OIDC Client extension configuration properties `quarkus.oidc-client.client.id` and `quarkus.oidc-client.credentials.secret` will be configured. Set to `false` if clients have to be created using either the Keycloak Administration Console or the Keycloak Admin API provided by `io.quarkus.test.common.QuarkusTestResourceLifecycleManager` or registered dynamically. ifdef::add-copy-button-to-env-var[] @@ -51886,6 +51914,8 @@ a| [[quarkus-narayana-jta_quarkus-transaction-manager-object-store-directory]] [ [.description] -- +The name of the directory where the transaction logs will be stored when using the `file-system` object store. If the value is not absolute then the directory is relative to the _user.dir_ system property. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_TRANSACTION_MANAGER_OBJECT_STORE_DIRECTORY+++[] @@ -51901,6 +51931,8 @@ a| [[quarkus-narayana-jta_quarkus-transaction-manager-object-store-type]] [.prop [.description] -- +The type of object store. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_TRANSACTION_MANAGER_OBJECT_STORE_TYPE+++[] @@ -51916,6 +51948,10 @@ a| [[quarkus-narayana-jta_quarkus-transaction-manager-object-store-datasource]] [.description] -- +The name of the datasource where the transaction logs will be stored when using the `jdbc` object store. + +If undefined, it will use the default datasource. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_TRANSACTION_MANAGER_OBJECT_STORE_DATASOURCE+++[] @@ -51931,6 +51967,8 @@ a| [[quarkus-narayana-jta_quarkus-transaction-manager-object-store-create-table] [.description] -- +Whether to create the table if it does not exist. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_TRANSACTION_MANAGER_OBJECT_STORE_CREATE_TABLE+++[] @@ -51946,6 +51984,8 @@ a| [[quarkus-narayana-jta_quarkus-transaction-manager-object-store-drop-table]] [.description] -- +Whether to drop the table on startup. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_TRANSACTION_MANAGER_OBJECT_STORE_DROP_TABLE+++[] @@ -51961,6 +52001,8 @@ a| [[quarkus-narayana-jta_quarkus-transaction-manager-object-store-table-prefix] [.description] -- +The prefix to apply to the table. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_TRANSACTION_MANAGER_OBJECT_STORE_TABLE_PREFIX+++[] diff --git a/_generated-doc/latest/config/quarkus-container-image-docker.adoc b/_generated-doc/latest/config/quarkus-container-image-docker.adoc index b42122a945..b8f9cb1345 100644 --- a/_generated-doc/latest/config/quarkus-container-image-docker.adoc +++ b/_generated-doc/latest/config/quarkus-container-image-docker.adoc @@ -11,6 +11,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-docker_quarkus- [.description] -- +Path to the JVM Dockerfile. If set to an absolute path then the absolute path will be used, otherwise the path will be considered relative to the project root. If not set src/main/docker/Dockerfile.jvm will be used. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_DOCKER_DOCKERFILE_JVM_PATH+++[] @@ -26,6 +28,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-docker_quarkus- [.description] -- +Path to the native Dockerfile. If set to an absolute path then the absolute path will be used, otherwise the path will be considered relative to the project root. If not set src/main/docker/Dockerfile.native will be used. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_DOCKER_DOCKERFILE_NATIVE_PATH+++[] @@ -41,6 +45,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-docker_quarkus- [.description] -- +Build args passed to docker via `--build-arg` + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_DOCKER_BUILD_ARGS__ARG_NAME_+++[] @@ -56,6 +62,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-docker_quarkus- [.description] -- +Images to consider as cache sources. Values are passed to `docker build`/`podman build` via the `cache-from` option + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_DOCKER_CACHE_FROM+++[] @@ -71,6 +79,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-docker_quarkus- [.description] -- +The networking mode for the RUN instructions during build + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_DOCKER_NETWORK+++[] @@ -86,6 +96,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-docker_quarkus- [.description] -- +Name of binary used to execute the docker/podman commands. This setting can override the global container runtime detection. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_DOCKER_EXECUTABLE_NAME+++[] @@ -101,6 +113,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-docker_quarkus- [.description] -- +Additional arbitrary arguments passed to the executable when building the container image. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_DOCKER_ADDITIONAL_ARGS+++[] diff --git a/_generated-doc/latest/config/quarkus-container-image-docker_quarkus.docker.adoc b/_generated-doc/latest/config/quarkus-container-image-docker_quarkus.docker.adoc index b42122a945..b8f9cb1345 100644 --- a/_generated-doc/latest/config/quarkus-container-image-docker_quarkus.docker.adoc +++ b/_generated-doc/latest/config/quarkus-container-image-docker_quarkus.docker.adoc @@ -11,6 +11,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-docker_quarkus- [.description] -- +Path to the JVM Dockerfile. If set to an absolute path then the absolute path will be used, otherwise the path will be considered relative to the project root. If not set src/main/docker/Dockerfile.jvm will be used. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_DOCKER_DOCKERFILE_JVM_PATH+++[] @@ -26,6 +28,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-docker_quarkus- [.description] -- +Path to the native Dockerfile. If set to an absolute path then the absolute path will be used, otherwise the path will be considered relative to the project root. If not set src/main/docker/Dockerfile.native will be used. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_DOCKER_DOCKERFILE_NATIVE_PATH+++[] @@ -41,6 +45,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-docker_quarkus- [.description] -- +Build args passed to docker via `--build-arg` + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_DOCKER_BUILD_ARGS__ARG_NAME_+++[] @@ -56,6 +62,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-docker_quarkus- [.description] -- +Images to consider as cache sources. Values are passed to `docker build`/`podman build` via the `cache-from` option + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_DOCKER_CACHE_FROM+++[] @@ -71,6 +79,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-docker_quarkus- [.description] -- +The networking mode for the RUN instructions during build + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_DOCKER_NETWORK+++[] @@ -86,6 +96,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-docker_quarkus- [.description] -- +Name of binary used to execute the docker/podman commands. This setting can override the global container runtime detection. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_DOCKER_EXECUTABLE_NAME+++[] @@ -101,6 +113,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-docker_quarkus- [.description] -- +Additional arbitrary arguments passed to the executable when building the container image. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_DOCKER_ADDITIONAL_ARGS+++[] diff --git a/_generated-doc/latest/config/quarkus-container-image-podman.adoc b/_generated-doc/latest/config/quarkus-container-image-podman.adoc index 824e46e8fe..c2b1b98382 100644 --- a/_generated-doc/latest/config/quarkus-container-image-podman.adoc +++ b/_generated-doc/latest/config/quarkus-container-image-podman.adoc @@ -11,6 +11,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-podman_quarkus- [.description] -- +Path to the JVM Dockerfile. If set to an absolute path then the absolute path will be used, otherwise the path will be considered relative to the project root. If not set src/main/docker/Dockerfile.jvm will be used. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_PODMAN_DOCKERFILE_JVM_PATH+++[] @@ -26,6 +28,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-podman_quarkus- [.description] -- +Path to the native Dockerfile. If set to an absolute path then the absolute path will be used, otherwise the path will be considered relative to the project root. If not set src/main/docker/Dockerfile.native will be used. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_PODMAN_DOCKERFILE_NATIVE_PATH+++[] @@ -41,6 +45,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-podman_quarkus- [.description] -- +Build args passed to docker via `--build-arg` + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_PODMAN_BUILD_ARGS__ARG_NAME_+++[] @@ -56,6 +62,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-podman_quarkus- [.description] -- +Images to consider as cache sources. Values are passed to `docker build`/`podman build` via the `cache-from` option + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_PODMAN_CACHE_FROM+++[] @@ -71,6 +79,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-podman_quarkus- [.description] -- +The networking mode for the RUN instructions during build + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_PODMAN_NETWORK+++[] @@ -86,6 +96,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-podman_quarkus- [.description] -- +Name of binary used to execute the docker/podman commands. This setting can override the global container runtime detection. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_PODMAN_EXECUTABLE_NAME+++[] @@ -101,6 +113,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-podman_quarkus- [.description] -- +Additional arbitrary arguments passed to the executable when building the container image. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_PODMAN_ADDITIONAL_ARGS+++[] diff --git a/_generated-doc/latest/config/quarkus-container-image-podman_quarkus.podman.adoc b/_generated-doc/latest/config/quarkus-container-image-podman_quarkus.podman.adoc index 824e46e8fe..c2b1b98382 100644 --- a/_generated-doc/latest/config/quarkus-container-image-podman_quarkus.podman.adoc +++ b/_generated-doc/latest/config/quarkus-container-image-podman_quarkus.podman.adoc @@ -11,6 +11,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-podman_quarkus- [.description] -- +Path to the JVM Dockerfile. If set to an absolute path then the absolute path will be used, otherwise the path will be considered relative to the project root. If not set src/main/docker/Dockerfile.jvm will be used. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_PODMAN_DOCKERFILE_JVM_PATH+++[] @@ -26,6 +28,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-podman_quarkus- [.description] -- +Path to the native Dockerfile. If set to an absolute path then the absolute path will be used, otherwise the path will be considered relative to the project root. If not set src/main/docker/Dockerfile.native will be used. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_PODMAN_DOCKERFILE_NATIVE_PATH+++[] @@ -41,6 +45,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-podman_quarkus- [.description] -- +Build args passed to docker via `--build-arg` + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_PODMAN_BUILD_ARGS__ARG_NAME_+++[] @@ -56,6 +62,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-podman_quarkus- [.description] -- +Images to consider as cache sources. Values are passed to `docker build`/`podman build` via the `cache-from` option + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_PODMAN_CACHE_FROM+++[] @@ -71,6 +79,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-podman_quarkus- [.description] -- +The networking mode for the RUN instructions during build + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_PODMAN_NETWORK+++[] @@ -86,6 +96,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-podman_quarkus- [.description] -- +Name of binary used to execute the docker/podman commands. This setting can override the global container runtime detection. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_PODMAN_EXECUTABLE_NAME+++[] @@ -101,6 +113,8 @@ a|icon:lock[title=Fixed at build time] [[quarkus-container-image-podman_quarkus- [.description] -- +Additional arbitrary arguments passed to the executable when building the container image. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_PODMAN_ADDITIONAL_ARGS+++[] diff --git a/_generated-doc/latest/config/quarkus-devservices-keycloak.adoc b/_generated-doc/latest/config/quarkus-devservices-keycloak.adoc index 1cdac68228..e47b4d4cf2 100644 --- a/_generated-doc/latest/config/quarkus-devservices-keycloak.adoc +++ b/_generated-doc/latest/config/quarkus-devservices-keycloak.adoc @@ -234,7 +234,7 @@ a|icon:lock[title=Fixed at build time] [[quarkus-devservices-keycloak_quarkus-ke [.description] -- -Specifies whether to create the default client id `quarkus-app` with a secret `secret`and register them if the `create-realm` property is set to true. For OIDC extension configuration properties `quarkus.oidc.client.id` and `quarkus.oidc.credentials.secret` will be configured. For OIDC Client extension configuration properties `quarkus.oidc-client.client.id` and `quarkus.oidc-client.credentials.secret` will be configured. Set to `false` if clients have to be created using either the Keycloak Administration Console or the Keycloak Admin API provided by `io.quarkus.test.common.QuarkusTestResourceLifecycleManager` or registered dynamically. +Specifies whether to create the default client id `quarkus-app` with a secret `secret` and register them if the `create-realm` property is set to true. For OIDC extension configuration properties `quarkus.oidc.client.id` and `quarkus.oidc.credentials.secret` will be configured. For OIDC Client extension configuration properties `quarkus.oidc-client.client.id` and `quarkus.oidc-client.credentials.secret` will be configured. Set to `false` if clients have to be created using either the Keycloak Administration Console or the Keycloak Admin API provided by `io.quarkus.test.common.QuarkusTestResourceLifecycleManager` or registered dynamically. ifdef::add-copy-button-to-env-var[] diff --git a/_generated-doc/latest/config/quarkus-devservices-keycloak_quarkus.keycloak.adoc b/_generated-doc/latest/config/quarkus-devservices-keycloak_quarkus.keycloak.adoc index 1cdac68228..e47b4d4cf2 100644 --- a/_generated-doc/latest/config/quarkus-devservices-keycloak_quarkus.keycloak.adoc +++ b/_generated-doc/latest/config/quarkus-devservices-keycloak_quarkus.keycloak.adoc @@ -234,7 +234,7 @@ a|icon:lock[title=Fixed at build time] [[quarkus-devservices-keycloak_quarkus-ke [.description] -- -Specifies whether to create the default client id `quarkus-app` with a secret `secret`and register them if the `create-realm` property is set to true. For OIDC extension configuration properties `quarkus.oidc.client.id` and `quarkus.oidc.credentials.secret` will be configured. For OIDC Client extension configuration properties `quarkus.oidc-client.client.id` and `quarkus.oidc-client.credentials.secret` will be configured. Set to `false` if clients have to be created using either the Keycloak Administration Console or the Keycloak Admin API provided by `io.quarkus.test.common.QuarkusTestResourceLifecycleManager` or registered dynamically. +Specifies whether to create the default client id `quarkus-app` with a secret `secret` and register them if the `create-realm` property is set to true. For OIDC extension configuration properties `quarkus.oidc.client.id` and `quarkus.oidc.credentials.secret` will be configured. For OIDC Client extension configuration properties `quarkus.oidc-client.client.id` and `quarkus.oidc-client.credentials.secret` will be configured. Set to `false` if clients have to be created using either the Keycloak Administration Console or the Keycloak Admin API provided by `io.quarkus.test.common.QuarkusTestResourceLifecycleManager` or registered dynamically. ifdef::add-copy-button-to-env-var[] diff --git a/_generated-doc/latest/config/quarkus-narayana-jta.adoc b/_generated-doc/latest/config/quarkus-narayana-jta.adoc index 61af7e8e2f..ed7e421f3f 100644 --- a/_generated-doc/latest/config/quarkus-narayana-jta.adoc +++ b/_generated-doc/latest/config/quarkus-narayana-jta.adoc @@ -130,6 +130,8 @@ a| [[quarkus-narayana-jta_quarkus-transaction-manager-object-store-directory]] [ [.description] -- +The name of the directory where the transaction logs will be stored when using the `file-system` object store. If the value is not absolute then the directory is relative to the _user.dir_ system property. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_TRANSACTION_MANAGER_OBJECT_STORE_DIRECTORY+++[] @@ -145,6 +147,8 @@ a| [[quarkus-narayana-jta_quarkus-transaction-manager-object-store-type]] [.prop [.description] -- +The type of object store. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_TRANSACTION_MANAGER_OBJECT_STORE_TYPE+++[] @@ -160,6 +164,10 @@ a| [[quarkus-narayana-jta_quarkus-transaction-manager-object-store-datasource]] [.description] -- +The name of the datasource where the transaction logs will be stored when using the `jdbc` object store. + +If undefined, it will use the default datasource. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_TRANSACTION_MANAGER_OBJECT_STORE_DATASOURCE+++[] @@ -175,6 +183,8 @@ a| [[quarkus-narayana-jta_quarkus-transaction-manager-object-store-create-table] [.description] -- +Whether to create the table if it does not exist. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_TRANSACTION_MANAGER_OBJECT_STORE_CREATE_TABLE+++[] @@ -190,6 +200,8 @@ a| [[quarkus-narayana-jta_quarkus-transaction-manager-object-store-drop-table]] [.description] -- +Whether to drop the table on startup. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_TRANSACTION_MANAGER_OBJECT_STORE_DROP_TABLE+++[] @@ -205,6 +217,8 @@ a| [[quarkus-narayana-jta_quarkus-transaction-manager-object-store-table-prefix] [.description] -- +The prefix to apply to the table. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_TRANSACTION_MANAGER_OBJECT_STORE_TABLE_PREFIX+++[] diff --git a/_generated-doc/latest/config/quarkus-narayana-jta_quarkus.transaction-manager.adoc b/_generated-doc/latest/config/quarkus-narayana-jta_quarkus.transaction-manager.adoc index 61af7e8e2f..ed7e421f3f 100644 --- a/_generated-doc/latest/config/quarkus-narayana-jta_quarkus.transaction-manager.adoc +++ b/_generated-doc/latest/config/quarkus-narayana-jta_quarkus.transaction-manager.adoc @@ -130,6 +130,8 @@ a| [[quarkus-narayana-jta_quarkus-transaction-manager-object-store-directory]] [ [.description] -- +The name of the directory where the transaction logs will be stored when using the `file-system` object store. If the value is not absolute then the directory is relative to the _user.dir_ system property. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_TRANSACTION_MANAGER_OBJECT_STORE_DIRECTORY+++[] @@ -145,6 +147,8 @@ a| [[quarkus-narayana-jta_quarkus-transaction-manager-object-store-type]] [.prop [.description] -- +The type of object store. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_TRANSACTION_MANAGER_OBJECT_STORE_TYPE+++[] @@ -160,6 +164,10 @@ a| [[quarkus-narayana-jta_quarkus-transaction-manager-object-store-datasource]] [.description] -- +The name of the datasource where the transaction logs will be stored when using the `jdbc` object store. + +If undefined, it will use the default datasource. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_TRANSACTION_MANAGER_OBJECT_STORE_DATASOURCE+++[] @@ -175,6 +183,8 @@ a| [[quarkus-narayana-jta_quarkus-transaction-manager-object-store-create-table] [.description] -- +Whether to create the table if it does not exist. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_TRANSACTION_MANAGER_OBJECT_STORE_CREATE_TABLE+++[] @@ -190,6 +200,8 @@ a| [[quarkus-narayana-jta_quarkus-transaction-manager-object-store-drop-table]] [.description] -- +Whether to drop the table on startup. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_TRANSACTION_MANAGER_OBJECT_STORE_DROP_TABLE+++[] @@ -205,6 +217,8 @@ a| [[quarkus-narayana-jta_quarkus-transaction-manager-object-store-table-prefix] [.description] -- +The prefix to apply to the table. + ifdef::add-copy-button-to-env-var[] Environment variable: env_var_with_copy_button:+++QUARKUS_TRANSACTION_MANAGER_OBJECT_STORE_TABLE_PREFIX+++[] diff --git a/_generated-doc/latest/infra/quarkus-all-build-items.adoc b/_generated-doc/latest/infra/quarkus-all-build-items.adoc index c8a92c6f11..1cae3cc53f 100644 --- a/_generated-doc/latest/infra/quarkus-all-build-items.adoc +++ b/_generated-doc/latest/infra/quarkus-all-build-items.adoc @@ -6044,6 +6044,10 @@ _No Javadoc found_ _No Javadoc found_ +`boolean hasGeneratedTemplate` + +_No Javadoc found_ + diff --git a/_guides/_attributes.adoc b/_guides/_attributes.adoc index a30b5087aa..9a1fd4e3ae 100644 --- a/_guides/_attributes.adoc +++ b/_guides/_attributes.adoc @@ -1,7 +1,7 @@ // Common attributes. // --> No blank lines (it ends the document header) :project-name: Quarkus -:quarkus-version: 3.16.2 +:quarkus-version: 3.16.3 :quarkus-platform-groupid: io.quarkus.platform // . :maven-version: 3.9.9 diff --git a/_guides/funqy-gcp-functions.adoc b/_guides/funqy-gcp-functions.adoc index 02109969b2..85982963ee 100644 --- a/_guides/funqy-gcp-functions.adoc +++ b/_guides/funqy-gcp-functions.adoc @@ -147,7 +147,7 @@ You will have a single JAR inside the `target/deployment` repository that contai Then you will be able to use `gcloud` to deploy your function to Google Cloud. The `gcloud` command will be different depending on which event triggers your function. -NOTE: We will use the Java 17 runtime but you can switch to the Java 21 runtime by using `--runtime=java21` instead of `--runtime=java17` on the deploy commands. +NOTE: We will use the Java 21 runtime, but you can switch to the Java 17 runtime by using `--runtime=java17` instead of `--runtime=java21` on the deploy commands. [WARNING] ==== @@ -168,7 +168,7 @@ Use this command to deploy to Google Cloud Functions: ---- gcloud functions deploy quarkus-example-funky-pubsub \ --entry-point=io.quarkus.funqy.gcp.functions.FunqyBackgroundFunction \ - --runtime=java17 --trigger-resource hello_topic --trigger-event google.pubsub.topic.publish \ + --runtime=java21 --trigger-resource hello_topic --trigger-event google.pubsub.topic.publish \ --source=target/deployment ---- @@ -205,7 +205,7 @@ Then, use this command to deploy to Google Cloud Functions: ---- gcloud functions deploy quarkus-example-funky-storage \ --entry-point=io.quarkus.funqy.gcp.functions.FunqyBackgroundFunction \ - --runtime=java17 --trigger-resource quarkus-hello --trigger-event google.storage.object.finalize \ + --runtime=java21 --trigger-resource quarkus-hello --trigger-event google.storage.object.finalize \ --source=target/deployment ---- @@ -246,7 +246,7 @@ Then, use this command to deploy to Google Cloud Functions: ---- gcloud functions deploy quarkus-example-cloud-event --gen2 \ --entry-point=io.quarkus.funqy.gcp.functions.FunqyCloudEventsFunction \ - --runtime=java17 --trigger-bucket=example-cloud-event --source=target/deployment + --runtime=java21 --trigger-bucket=example-cloud-event --source=target/deployment ---- [IMPORTANT] @@ -371,7 +371,7 @@ This will call your cloud events function with an event on the `"MY_FILE.txt` fi Quarkus provides built-in support for testing your Funqy Google Cloud functions via the `quarkus-test-google-cloud-functions` dependency. -To use it, you must add the following test dependency in your `pom.xml`. +To use it, you must add the following test dependencies in your `pom.xml`. [source,xml] ---- @@ -380,6 +380,11 @@ To use it, you must add the following test dependency in your `pom.xml`. quarkus-test-google-cloud-functions test + + io.rest-assured + rest-assured + test + ---- This extension provides a `@WithFunction` annotation that can be used to annotate `@QuarkusTest` test cases to start a Cloud Function invoker before you test cases and stop it at the end. diff --git a/_guides/gcp-functions-http.adoc b/_guides/gcp-functions-http.adoc index 39d72b68a2..0d00409529 100644 --- a/_guides/gcp-functions-http.adoc +++ b/_guides/gcp-functions-http.adoc @@ -162,13 +162,13 @@ The result of the previous command is a single JAR file inside the `target/deplo Then you will be able to use `gcloud` to deploy your function to Google Cloud. -NOTE: We will use the Java 17 runtime but you can switch to the Java 21 runtime by using `--runtime=java21` instead of `--runtime=java17` on the deploy commands. +NOTE: We will use the Java 21 runtime, but you can switch to the Java 17 runtime by using `--runtime=java17` instead of `--runtime=java21` on the deploy commands. [source,bash] ---- gcloud functions deploy quarkus-example-http \ --entry-point=io.quarkus.gcp.functions.http.QuarkusHttpFunction \ - --runtime=java17 --trigger-http --allow-unauthenticated --source=target/deployment + --runtime=java21 --trigger-http --allow-unauthenticated --source=target/deployment ---- [IMPORTANT] diff --git a/_guides/gcp-functions.adoc b/_guides/gcp-functions.adoc index 319c73b226..4c3a53bb2d 100644 --- a/_guides/gcp-functions.adoc +++ b/_guides/gcp-functions.adoc @@ -242,7 +242,7 @@ The result of the previous command is a single JAR file inside the `target/deplo Then you will be able to use `gcloud` to deploy your function to Google Cloud. The `gcloud` command will be different depending on which event triggers your function. -NOTE: We will use the Java 17 runtime but you can switch to the Java 21 runtime by using `--runtime=java21` instead of `--runtime=java17` on the deploy commands. +NOTE: We will use the Java 21 runtime but you can switch to the Java 17 runtime by using `--runtime=java17` instead of `--runtime=java21` on the deploy commands. [WARNING] ==== @@ -262,7 +262,7 @@ This is an example command to deploy your `HttpFunction` to Google Cloud: ---- gcloud functions deploy quarkus-example-http \ --entry-point=io.quarkus.gcp.functions.QuarkusHttpFunction \ - --runtime=java17 --trigger-http --allow-unauthenticated --source=target/deployment + --runtime=java21 --trigger-http --allow-unauthenticated --source=target/deployment ---- [IMPORTANT] @@ -289,7 +289,7 @@ it needs to use `--trigger-event google.storage.object.finalize` and the `--trig gcloud functions deploy quarkus-example-storage \ --entry-point=io.quarkus.gcp.functions.QuarkusBackgroundFunction \ --trigger-resource quarkus-hello --trigger-event google.storage.object.finalize \ - --runtime=java17 --source=target/deployment + --runtime=java21 --source=target/deployment ---- [IMPORTANT] @@ -315,7 +315,7 @@ it needs to use `--trigger-event google.pubsub.topic.publish` and the `--trigger ---- gcloud functions deploy quarkus-example-pubsub \ --entry-point=io.quarkus.gcp.functions.QuarkusBackgroundFunction \ - --runtime=java17 --trigger-resource hello_topic --trigger-event google.pubsub.topic.publish --source=target/deployment + --runtime=java21 --trigger-resource hello_topic --trigger-event google.pubsub.topic.publish --source=target/deployment ---- [IMPORTANT] @@ -341,7 +341,7 @@ it needs to use `--trigger-bucket` parameter with the name of a previously creat ---- gcloud functions deploy quarkus-example-cloud-event --gen2 \ --entry-point=io.quarkus.gcp.functions.QuarkusCloudEventsFunction \ - --runtime=java17 --trigger-bucket=example-cloud-event --source=target/deployment + --runtime=java21 --trigger-bucket=example-cloud-event --source=target/deployment ---- [IMPORTANT] @@ -485,6 +485,11 @@ To use it, you must add the following test dependency in your `pom.xml`. quarkus-test-google-cloud-functions test + + io.rest-assured + rest-assured + test + ---- This extension provides a `@WithFunction` annotation that can be used to annotate `@QuarkusTest` test cases to start a Cloud Function invoker before you test cases and stop it at the end. diff --git a/_guides/opentelemetry-tracing.adoc b/_guides/opentelemetry-tracing.adoc index ef62e35cbb..3b0196ca44 100644 --- a/_guides/opentelemetry-tracing.adoc +++ b/_guides/opentelemetry-tracing.adoc @@ -121,7 +121,7 @@ We have 2 options: * Take a look at: xref:observability-devservices-lgtm.adoc[Getting Started with Grafana-OTel-LGTM]. -This features a Quarkus Dev service including a Grafana for visualizing data, Loki to store logs, Tempo to store traces and Prometheus to store metrics. Also provides and OTel collector to receive the data. +This features a Quarkus Dev service including a Grafana for visualizing data, Loki to store logs, Tempo to store traces and Prometheus to store metrics. Also provides an OTel collector to receive the data. === Jaeger to see traces option @@ -148,7 +148,7 @@ services: - "16686:16686" # Jaeger UI - "14268:14268" # Receive legacy OpenTracing traces, optional - "4317:4317" # OTLP gRPC receiver - - "4318:4318" # OTLP HTTP receiver, not yet used by Quarkus, optional + - "4318:4318" # OTLP HTTP receiver - "14250:14250" # Receive from external otel-collector, optional environment: - COLLECTOR_OTLP_ENABLED=true