Sync documentation of main branch

actions-user · actions-user · commit 499c82fb89ba · 2025-07-23T02:03:12.000Z
diff --git a/_generated-doc/main/config/quarkus-all-config.adoc b/_generated-doc/main/config/quarkus-all-config.adoc
@@ -9170,6 +9170,7 @@ Enable monitoring various monitoring options. The value should be comma separate
  - `jmxserver` for JMX server support (experimental)
  - `nmt` for native memory tracking support
  - `all` for all monitoring features
+ - `none` for explicitly turning off all monitoring features
 
 
 ifdef::add-copy-button-to-env-var[]
@@ -9179,7 +9180,7 @@ ifndef::add-copy-button-to-env-var[]
 Environment variable: `+++QUARKUS_NATIVE_MONITORING+++`
 endif::add-copy-button-to-env-var[]
 --
-a|list of `heapdump`, `jvmstat`, `jfr`, `jmxserver`, `jmxclient`, `nmt`, `all`
+a|list of `heapdump`, `jvmstat`, `jfr`, `jmxserver`, `jmxclient`, `nmt`, `all`, `none`
 |
 
 a|icon:lock[title=Fixed at build time] [[quarkus-core_quarkus-native-enable-reports]] [.property-path]##link:#quarkus-core_quarkus-native-enable-reports[`quarkus.native.enable-reports`]##
@@ -83903,6 +83904,27 @@ endif::add-copy-button-to-env-var[]
 |string
 |
 
+a|icon:lock[title=Fixed at build time] [[quarkus-rest-client-oidc-filter_quarkus-rest-client-oidc-filter-refresh-on-unauthorized]] [.property-path]##link:#quarkus-rest-client-oidc-filter_quarkus-rest-client-oidc-filter-refresh-on-unauthorized[`quarkus.rest-client-oidc-filter.refresh-on-unauthorized`]##
+ifdef::add-copy-button-to-config-props[]
+config_property_copy_button:+++quarkus.rest-client-oidc-filter.refresh-on-unauthorized+++[]
+endif::add-copy-button-to-config-props[]
+
+
+[.description]
+--
+If Quarkus should refresh the access token after the MP REST client request results in 401 Unauthorized error. The refresh can be useful when the access token can be revoked by other services while the access token still appears valid locally.
+
+
+ifdef::add-copy-button-to-env-var[]
+Environment variable: env_var_with_copy_button:+++QUARKUS_REST_CLIENT_OIDC_FILTER_REFRESH_ON_UNAUTHORIZED+++[]
+endif::add-copy-button-to-env-var[]
+ifndef::add-copy-button-to-env-var[]
+Environment variable: `+++QUARKUS_REST_CLIENT_OIDC_FILTER_REFRESH_ON_UNAUTHORIZED+++`
+endif::add-copy-button-to-env-var[]
+--
+|boolean
+|`false`
+
 
 h|[.extension-name]##REST Client - OpenID Connect Token Propagation##
 h|Type
@@ -86795,6 +86817,27 @@ endif::add-copy-button-to-env-var[]
 |string
 |
 
+a|icon:lock[title=Fixed at build time] [[quarkus-resteasy-client-oidc-filter_quarkus-resteasy-client-oidc-filter-refresh-on-unauthorized]] [.property-path]##link:#quarkus-resteasy-client-oidc-filter_quarkus-resteasy-client-oidc-filter-refresh-on-unauthorized[`quarkus.resteasy-client-oidc-filter.refresh-on-unauthorized`]##
+ifdef::add-copy-button-to-config-props[]
+config_property_copy_button:+++quarkus.resteasy-client-oidc-filter.refresh-on-unauthorized+++[]
+endif::add-copy-button-to-config-props[]
+
+
+[.description]
+--
+If Quarkus should refresh the access token after the MP REST client request results in 401 Unauthorized error. The refresh can be useful when the access token can be revoked by other services while the access token still appears valid locally.
+
+
+ifdef::add-copy-button-to-env-var[]
+Environment variable: env_var_with_copy_button:+++QUARKUS_RESTEASY_CLIENT_OIDC_FILTER_REFRESH_ON_UNAUTHORIZED+++[]
+endif::add-copy-button-to-env-var[]
+ifndef::add-copy-button-to-env-var[]
+Environment variable: `+++QUARKUS_RESTEASY_CLIENT_OIDC_FILTER_REFRESH_ON_UNAUTHORIZED+++`
+endif::add-copy-button-to-env-var[]
+--
+|boolean
+|`false`
+
 
 h|[.extension-name]##RESTEasy Client - OpenID Connect Token Propagation##
 h|Type
diff --git a/_generated-doc/main/config/quarkus-core_quarkus.native.adoc b/_generated-doc/main/config/quarkus-core_quarkus.native.adoc
@@ -591,6 +591,7 @@ Enable monitoring various monitoring options. The value should be comma separate
  - `jmxserver` for JMX server support (experimental)
  - `nmt` for native memory tracking support
  - `all` for all monitoring features
+ - `none` for explicitly turning off all monitoring features
 
 
 ifdef::add-copy-button-to-env-var[]
@@ -600,7 +601,7 @@ ifndef::add-copy-button-to-env-var[]
 Environment variable: `+++QUARKUS_NATIVE_MONITORING+++`
 endif::add-copy-button-to-env-var[]
 --
-a|list of `heapdump`, `jvmstat`, `jfr`, `jmxserver`, `jmxclient`, `nmt`, `all`
+a|list of `heapdump`, `jvmstat`, `jfr`, `jmxserver`, `jmxclient`, `nmt`, `all`, `none`
 |
 
 a|icon:lock[title=Fixed at build time] [[quarkus-core_quarkus-native-enable-reports]] [.property-path]##link:#quarkus-core_quarkus-native-enable-reports[`quarkus.native.enable-reports`]##
diff --git a/_generated-doc/main/config/quarkus-rest-client-oidc-filter.adoc b/_generated-doc/main/config/quarkus-rest-client-oidc-filter.adoc
@@ -28,5 +28,26 @@ endif::add-copy-button-to-env-var[]
 |string
 |
 
+a|icon:lock[title=Fixed at build time] [[quarkus-rest-client-oidc-filter_quarkus-rest-client-oidc-filter-refresh-on-unauthorized]] [.property-path]##link:#quarkus-rest-client-oidc-filter_quarkus-rest-client-oidc-filter-refresh-on-unauthorized[`quarkus.rest-client-oidc-filter.refresh-on-unauthorized`]##
+ifdef::add-copy-button-to-config-props[]
+config_property_copy_button:+++quarkus.rest-client-oidc-filter.refresh-on-unauthorized+++[]
+endif::add-copy-button-to-config-props[]
+
+
+[.description]
+--
+If Quarkus should refresh the access token after the MP REST client request results in 401 Unauthorized error. The refresh can be useful when the access token can be revoked by other services while the access token still appears valid locally.
+
+
+ifdef::add-copy-button-to-env-var[]
+Environment variable: env_var_with_copy_button:+++QUARKUS_REST_CLIENT_OIDC_FILTER_REFRESH_ON_UNAUTHORIZED+++[]
+endif::add-copy-button-to-env-var[]
+ifndef::add-copy-button-to-env-var[]
+Environment variable: `+++QUARKUS_REST_CLIENT_OIDC_FILTER_REFRESH_ON_UNAUTHORIZED+++`
+endif::add-copy-button-to-env-var[]
+--
+|boolean
+|`false`
+
 |===
 
diff --git a/_generated-doc/main/config/quarkus-rest-client-oidc-filter_quarkus.rest-client-oidc-filter.adoc b/_generated-doc/main/config/quarkus-rest-client-oidc-filter_quarkus.rest-client-oidc-filter.adoc
@@ -28,5 +28,26 @@ endif::add-copy-button-to-env-var[]
 |string
 |
 
+a|icon:lock[title=Fixed at build time] [[quarkus-rest-client-oidc-filter_quarkus-rest-client-oidc-filter-refresh-on-unauthorized]] [.property-path]##link:#quarkus-rest-client-oidc-filter_quarkus-rest-client-oidc-filter-refresh-on-unauthorized[`quarkus.rest-client-oidc-filter.refresh-on-unauthorized`]##
+ifdef::add-copy-button-to-config-props[]
+config_property_copy_button:+++quarkus.rest-client-oidc-filter.refresh-on-unauthorized+++[]
+endif::add-copy-button-to-config-props[]
+
+
+[.description]
+--
+If Quarkus should refresh the access token after the MP REST client request results in 401 Unauthorized error. The refresh can be useful when the access token can be revoked by other services while the access token still appears valid locally.
+
+
+ifdef::add-copy-button-to-env-var[]
+Environment variable: env_var_with_copy_button:+++QUARKUS_REST_CLIENT_OIDC_FILTER_REFRESH_ON_UNAUTHORIZED+++[]
+endif::add-copy-button-to-env-var[]
+ifndef::add-copy-button-to-env-var[]
+Environment variable: `+++QUARKUS_REST_CLIENT_OIDC_FILTER_REFRESH_ON_UNAUTHORIZED+++`
+endif::add-copy-button-to-env-var[]
+--
+|boolean
+|`false`
+
 |===
 
diff --git a/_generated-doc/main/config/quarkus-resteasy-client-oidc-filter.adoc b/_generated-doc/main/config/quarkus-resteasy-client-oidc-filter.adoc
@@ -49,5 +49,26 @@ endif::add-copy-button-to-env-var[]
 |string
 |
 
+a|icon:lock[title=Fixed at build time] [[quarkus-resteasy-client-oidc-filter_quarkus-resteasy-client-oidc-filter-refresh-on-unauthorized]] [.property-path]##link:#quarkus-resteasy-client-oidc-filter_quarkus-resteasy-client-oidc-filter-refresh-on-unauthorized[`quarkus.resteasy-client-oidc-filter.refresh-on-unauthorized`]##
+ifdef::add-copy-button-to-config-props[]
+config_property_copy_button:+++quarkus.resteasy-client-oidc-filter.refresh-on-unauthorized+++[]
+endif::add-copy-button-to-config-props[]
+
+
+[.description]
+--
+If Quarkus should refresh the access token after the MP REST client request results in 401 Unauthorized error. The refresh can be useful when the access token can be revoked by other services while the access token still appears valid locally.
+
+
+ifdef::add-copy-button-to-env-var[]
+Environment variable: env_var_with_copy_button:+++QUARKUS_RESTEASY_CLIENT_OIDC_FILTER_REFRESH_ON_UNAUTHORIZED+++[]
+endif::add-copy-button-to-env-var[]
+ifndef::add-copy-button-to-env-var[]
+Environment variable: `+++QUARKUS_RESTEASY_CLIENT_OIDC_FILTER_REFRESH_ON_UNAUTHORIZED+++`
+endif::add-copy-button-to-env-var[]
+--
+|boolean
+|`false`
+
 |===
 
diff --git a/_generated-doc/main/config/quarkus-resteasy-client-oidc-filter_quarkus.resteasy-client-oidc-filter.adoc b/_generated-doc/main/config/quarkus-resteasy-client-oidc-filter_quarkus.resteasy-client-oidc-filter.adoc
@@ -49,5 +49,26 @@ endif::add-copy-button-to-env-var[]
 |string
 |
 
+a|icon:lock[title=Fixed at build time] [[quarkus-resteasy-client-oidc-filter_quarkus-resteasy-client-oidc-filter-refresh-on-unauthorized]] [.property-path]##link:#quarkus-resteasy-client-oidc-filter_quarkus-resteasy-client-oidc-filter-refresh-on-unauthorized[`quarkus.resteasy-client-oidc-filter.refresh-on-unauthorized`]##
+ifdef::add-copy-button-to-config-props[]
+config_property_copy_button:+++quarkus.resteasy-client-oidc-filter.refresh-on-unauthorized+++[]
+endif::add-copy-button-to-config-props[]
+
+
+[.description]
+--
+If Quarkus should refresh the access token after the MP REST client request results in 401 Unauthorized error. The refresh can be useful when the access token can be revoked by other services while the access token still appears valid locally.
+
+
+ifdef::add-copy-button-to-env-var[]
+Environment variable: env_var_with_copy_button:+++QUARKUS_RESTEASY_CLIENT_OIDC_FILTER_REFRESH_ON_UNAUTHORIZED+++[]
+endif::add-copy-button-to-env-var[]
+ifndef::add-copy-button-to-env-var[]
+Environment variable: `+++QUARKUS_RESTEASY_CLIENT_OIDC_FILTER_REFRESH_ON_UNAUTHORIZED+++`
+endif::add-copy-button-to-env-var[]
+--
+|boolean
+|`false`
+
 |===
 
diff --git a/_generated-doc/main/infra/quarkus-all-build-items.adoc b/_generated-doc/main/infra/quarkus-all-build-items.adoc
@@ -1100,6 +1100,21 @@ This option is only meant to be set by extensions that also generated the resour
 
 
 
+a| https://github.com/quarkusio/quarkus/blob/main/core/deployment/src/main/java/io/quarkus/deployment/builditem/GeneratedRuntimeSystemPropertyBuildItem.java[`io.quarkus.deployment.builditem.GeneratedRuntimeSystemPropertyBuildItem`, window="_blank"]
+[.description]
+--
+Represents a system property that will be set immediately on application startup, the system property will be generated when set.
+-- a|`java.lang.String key` 
+
+_No Javadoc found_
+
+`java.lang.String generatorClass` 
+
+_No Javadoc found_
+
+
+
+
 a| https://github.com/quarkusio/quarkus/blob/main/core/deployment/src/main/java/io/quarkus/deployment/builditem/HotDeploymentWatchedFileBuildItem.java[`io.quarkus.deployment.builditem.HotDeploymentWatchedFileBuildItem`, window="_blank"]
 [.description]
 --
diff --git a/_versions/main/guides/building-native-image.adoc b/_versions/main/guides/building-native-image.adoc
@@ -957,6 +957,10 @@ include at build time.
 |Adds support for native memory tracking.
 |GraalVM for JDK 23 Mandrel 24.1
 
+|none
+|Disables support for all monitoring options that would be enabled by default in Quarkus
+|Pseudo option used by Quarkus
+
 |all
 |Adds all monitoring options.
 |GraalVM 22.3, GraalVM CE 17.0.7 Mandrel 22.3 Mandrel 23.0 (17.0.7)
diff --git a/_versions/main/guides/compose-dev-services.adoc b/_versions/main/guides/compose-dev-services.adoc
@@ -22,7 +22,7 @@ _The Compose Specification is a developer-focused standard for defining cloud an
 
 Compose is a widely used tool for defining and managing multi-container applications, for development and testing purposes.
 A YAML description file, typically named `compose.yml`, defines the services, networks, and volumes required for your application.
-https://docs.docker.com/compose/[Docker Compose] is the reference implementation and https://podman-desktop.io/docs/compose[Podman Desktop] also provides out-of-box support for the Compose specification.
+https://docs.docker.com/compose/[Docker Compose] is the reference implementation and https://podman-desktop.io/docs/compose[Podman Desktop] also provides out-of-the-box support for the Compose specification.
 
 Quarkus detects Compose files named `compose-devservices.yml` (or <<compose-devservices-compose-files>>) in your project and starts the defined services when your application runs in development or test mode.
 Extensions providing dev services discover these custom services and use them instead of creating default ones.
@@ -78,7 +78,7 @@ When you run the application in dev mode or execute tests, Compose Dev Services
 instead of using the default dev service provided by the `quarkus-jdbc-postgresql` extension.
 
 As per the above configuration, the PostgreSQL container port `5432` will be exposed to a random host port
-and the application datasource will be configured by extracting connection information such as _user_, _password_ and the _database name_.
+and the application datasource will be configured by extracting connection information such as _user_, _password_, and the _database name_.
 
 === Multi-Service Example: Custom Network and Dependencies
 
@@ -154,7 +154,7 @@ For example, the PostgreSQL Dev Service looks for a service with the image name
 
 When a match is found, the extension will:
 
-1. Extract connection information from the container (connection url, credentials, database name, etc.)
+1. Extract connection information from the container (connection URL, credentials, database name, etc.)
 2. Configure the application to use the discovered service
 3. Skip creating its own default Dev Service container
 
@@ -287,7 +287,7 @@ quarkus.compose.devservices.files=src/main/docker/base-compose.yml,src/main/dock
 
 ==== Using Compose profiles
 
-With profiles, Compose files can define a set of active profiles so started services is adjusted for various usages and environments.
+With profiles, Compose files can define a set of active profiles so that started services are adjusted for various usages and environments.
 You can specify the profiles to activate by setting the `quarkus.compose.devservices.profiles` property in the `application.properties` file:
 
 [source, yaml]
@@ -313,7 +313,7 @@ services:
 
 === Ignoring Services
 
-You can configure Compose Dev Services to ignore specific services by adding the `io.quarkus.devservices.compose.ignore` label to the service in your Compose file:
+You can configure Compose Dev Services to not discover specific services by adding the `io.quarkus.devservices.compose.ignore` label to the service in your Compose file:
 
 [source, yaml]
 ----
@@ -378,7 +378,7 @@ services:
 ----
 
 You can also specify how many times a log message should appear by setting the numeric suffix value:
-`io.quarkus.devservices.compose.wait_for.logs.3: .*Worker started.*`
+`io.quarkus.devservices.compose.wait_for.logs.3: .\*Worker started.*`
 
 === Wait for Ports
 
@@ -469,7 +469,7 @@ The host is set to the Docker host IP address, and the port is set to the mapped
 
 [NOTE]
 ====
-For database services, if the label `io.quarkus.compose.devservices.jdbc.parameters` is set, the parameters are added to the JDBC URL.
+For database services, if the label `io.quarkus.devservices.compose.jdbc.parameters` is set, the parameters are added to the JDBC URL.
 ====
 
 === Custom config mapping using service labels
@@ -481,7 +481,7 @@ You can customize how environment variables and exposed ports are mapped to appl
 To map an environment variable to a specific application configuration property,
 use the `io.quarkus.devservices.compose.config_map.env.<env-var-name>` label.
 
-Let's take the example of a MQTT broker:
+Let's take the example of an MQTT broker:
 
 [source, yaml]
 ----
@@ -611,7 +611,7 @@ export KAFKA_ADVERTISED_LISTENERS=PLAINTEXT://localhost:$PORT_9092;
 
 Compose Dev Services provides several configuration options to control how services are started, stopped and shared between application instances.
 
-When the application starts in development or test mode, Compose Dev Services decide whether to start services or to discover already running services based on the configuration.
+When the application starts in development or test mode, Compose Dev Services decides whether to start services or to discover already running services based on the configuration.
 When the application stops, Compose Dev Services stops the services it started.
 
 === Compose Project Name
@@ -627,9 +627,9 @@ Compose Dev Services determines the project name as follows:
 
 === Discovering already started Compose Services
 
-Once the project name is determined, Compose Dev Services first tries discovering existing services with that project name.
+Once the project name is determined, Compose Dev Services first tries to discover existing services with that project name.
 
-The already started compose project may have been already started by another Quarkus application running locally with the same project name,
+The already started compose project may have been started by another Quarkus application running locally with the same project name,
 or manually using the `docker compose up` or `podman compose up` commands.
 
 Regardless of how the services were started,
@@ -664,7 +664,7 @@ This allows services to be reused by other applications or subsequent runs of th
 
 You can also configure the timeout for stopping services with the `quarkus.compose.devservices.stop-timeout` property.
 After the timeout, Compose Dev Services will forcefully stop the services.
-The default timeout is chosen deliberately short to 1 second for fast cleanup, but you can increase it as needed:
+The default timeout is deliberately chosen to be short (1 second) for fast cleanup, but you can increase it as needed:
 
 [source, text]
 ----
diff --git a/_versions/main/guides/security-openid-connect-client-reference.adoc b/_versions/main/guides/security-openid-connect-client-reference.adoc
