Red Hat build of Quarkus 1.11 发行注记

红帽引入了一个新的基于 Web 的项目生成器，可用于根据最新版本的 Quarkus 来为应用程序创建项目。项目生成器提供了几个功能，使使用 Quarkus 开发新应用程序变得更加容易，例如：

您可以在 code.quarkus.redhat.com 访问项目生成器。请注意，红帽只支持使用 code.quarkus.redhat.com 创建基于 Maven 的应用程序项目。

有关如何使用 code.quarkus.redhat.com 的更多信息，请参阅使用 code.quarkus.redhat.com 创建 Quarkus Maven 项目。

Red Hat build of Quarkus 1.11 支持使用 OpenJDK 11 通用基础镜像来使用 Source-to-image (S2I)工具构建和部署应用程序到 Red Hat OpenShift Container Platform。您可以从 红帽生态系统目录 下载最新版本的镜像。

Red Hat build of Quarkus 1.11 引进了一个新的扩展，用于使用 Micrometer 库收集运行时应用程序指标，并通过 Prometheus 监控应用程序。通过扩展，您可以从应用程序收集运行时应用程序指标，并从应用程序使用的扩展收集运行时应用程序指标，该扩展与 Micrometer 集成（如 Apache Kafka、HTTP、Cheasy 等的 Quarkus 扩展）。红帽支持 Quarkus Micrometer Metrics，用于生产环境。如需了解更多详细信息，请参阅 Quarkus 应用程序中的 收集指标。

在 Red Hat build of Quarkus 1.11 中，当您使用 Hibernate ORM 管理应用程序中的数据源时，您可以将多个数据源定义为持久性单元。如需了解更多详细信息，请参阅在 Quarkus 应用程序中配置数据源中的 配置多个 JDBC 数据源 部分。

Red Hat build of Quarkus 1.11 引进了对使用 Quarkus Smallrye OpenAPI 扩展保存应用程序的 OpenAPI 模式的支持。您可以将 quarkus-smallrye-openapi_quarkus.smallrye-openapi.store-schema-directory 的值设置为编译应用程序时保存 OpenAPI 模式的目录的路径。例如：

quarkus-smallrye-openapi_quarkus.smallrye-openapi.store-schema-directory=/path/to/schema/directory

现在，您可以使用 Quarkus Quartz 扩展来调度依赖于上下文和依赖注入的定期任务。详情请查看 社区文档 了解 Quarkus Quartz 扩展。

在 Red Hat build of Quarkus 1.11 中，在 Quarkus Reactive Messaging Extensions for AMQP 和 Apache Kafka 中使用的 SmallRye Reactive Messaging API 已升级到版本 2.7.1。如需了解更多详细信息，请参阅 SmallRye Reactive Messaging API 文档。

在 Red Hat build of Quarkus 1.11 中，在 Quarkus 重新主动扩展中使用的 Mutiny 事件驱动的库已升级至 0.12.5 版本。

红帽构建的 Quarkus 1.11 中的 Reactive 路由扩展支持 Java Bean 的约束验证。

在 Red Hat build of Quarkus 1.11 发行版本中，Jackson 设置为 Quarkus REST JSON 扩展使用的默认 ObjectMapper 工具。您可以使用上下文和依赖注入在应用的 REST Controller 类中注入 Jackson，以支持将 REST 应用程序数据转换为 JSON 格式或从 JSON 格式转换。有关破坏由 Red Hat build of Quarkus 1.7 到 Red Hat build of Quarkus 1.11 中的 DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES 功能导致的更改的更多详情，请参阅 在 Red Hat build of Quarkus 1.11 中将应用程序从 Red Hat build of Quarkus 1.71 升级到 Red Hat build of Quarkus 1.11

在 Red Hat build of Quarkus 1.11 中，您可以指定 -Dquarkus.<ui-name>.always-include=true，以便在以 Production 模式启动应用程序时启用作为 JAR 一部分的用户界面。该选项可用于以下接口：

例如，当您为包含 SwaggerUI 接口的 REST 应用创建 JAR 时，当您启动应用程序时，默认禁用此接口。您可以将 -Dquarkus.swagger-ui.always-include=true 选项附加到 start 命令中，以便在启动应用程序时启用接口：

java -jar -Dquarkus.swagger-ui.enable=true target/<application-name>-1.0.0-SNAPSHOT-runner.jar

请注意，您必须将 &lt ;application-name& gt; 替换为 JAR 的名称。

红帽构建的 Quarkus 1.11 中可用的 quarkus-rest-client 扩展会受到处理 MicroProfile REST 客户端和 JAX-RS 客户端中的 WebApplicationException 中的更改，它作为 CVE-2020-25633 安全问题的一部分引入。

由于安全更新，RESTS 版本 4.5.9 更改了当客户端应用程序返回 WebApplicationException 时处理 响应 的方式。在 4.5.9 更新前，从远程服务器发送的响应组成了本地域的敏感信息，其中包含有关远程服务器的敏感信息（如 Cookie）。

RESTEasy 4.5.9 更新会改变 响应 内容处理的方式。当本地服务器收到 Response RESTEasy 时，在存储响应前删除所有敏感内容，但在需要时保留本地服务器以访问 响应 的原始内容的方法。

对异常处理的更改使得避免在本地服务器上存储敏感内容相关的安全风险，但仍确保使用 RESTEasy 版本 4.5.9 的客户端与 JAX-RS 规范保持兼容。

有关在 RESTEasy 版本 4.5.9 中存储 响应 内容的更改的详情，请查看 RESTEasy 4.5.9 文档中的 WebApplicationException 处理部分。

在 Red Hat build of Quarkus 1.11 中，编译原生可执行文件的默认基础镜像升级到 Mandrel 20.3。因此，编译 Quarkus 应用程序的 quarkus.native.builder-image 配置属性的默认值改为 原生可执行文件， 更改为 quay.io/quarkus/ubi-quarkus-mandrel:20.3-java11。

Red Hat build of Quarkus 1.11 包括 Quarkus Kubernetes 客户端的新版本。如果您在开发环境中使用 Quarkus Kubernetes 客户端版本 4.x，并希望将现有应用程序升级到版本 5.x，请参阅 Kubernetes 客户端迁移指南。

Red Hat build of Quarkus 1.11 使用包括 Quarkus Dev UI 的第一个发行版本。Dev UI 是一个实验性界面，可用于：

以 Development 模式启动应用程序时，您可以访问 Dev UI，并在 Web 浏览器中进入 localhost:8080/q/dev。

红帽构建的 Quarkus 1.11 发行版本对 Quarkus Quartz 扩展可用的配置属性进行了一些更改。

在 Red Hat build of Quarkus 1.11 中，用于 Spring Boot 配置属性的命名策略不再将 Quarkus 应用程序中的大写和小写字符组合设置为 verbatim。

相反，您可以将 quarkus.arc.config-properties-default-naming-strategy 属性设置为项目的 application.properties 文件中的以下值之一：

如果您没有为应用程序设置 quarkus.arc.config-properties-default-naming-strategy 属性，则 kebab 将用作默认值。

如果您使用基于应用程序中操作操作命名策略格式化的 Spring Boot 配置属性，请确保进行以下更改之一：

Red Hat build of Quarkus 1.11 不再支持配置红帽构建的 Quarkus 1.3 中引入的数据源的连接 URL 和驱动程序的属性。

您必须将不支持的配置属性替换为与 Quarkus 1.11 兼容的属性，以确保数据源配置在将应用程序升级到 Quarkus 1.11 时正常工作。

有关如何在 Quarkus 1.11 应用程序中配置数据源 的详情，请参阅在 Quarkus 应用程序中配置数据源。

在 Red Hat build of Quarkus 1.11 版本中，序列化应用程序数据的默认格式更改为 JSON。

您可以在应用程序中禁用 JSON 作为 REST 端点的 content-type 格式，并使用注解明确为您要使用它的接口明确启用 JSON 使用：

在 Red Hat build of Quarkus 1.11 中，Jackson 被配置为通过具有 DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES 来忽略未知属性，以避免在尝试对应用程序识别的属性进行反序列化 JSON 数据对象。

在应用程序的 application.properties 文件中将 quarkus.jackson.fail-on-unknown-properties 的值设置为 true，以启用 FAIL_ON_UNKNOWN_PROPERTIES 功能。您必须为每个应用程序类型单独启用此功能：

<fully-qualified-class-name>.quarkus.jackson.fail-on-unknown-properties=true

有关使用和自定义 Jackson 在 Quarkus REST 应用程序中使用和自定义 Jackson 的详情，请参阅 Quarkus REST JSON 扩展指南。

在 Quarkus 1.11 中，默认的最小日志记录级别为 DEBUG。这意味着，只有等于或大于 DEBUG 的日志消息才会被处理。DEBUG 级别下的日志消息（如 TRACE 和 ALL ）不会显示在您的日志输出中。

当您要设置 DEBUG 以下的日志级别时，您必须更改最小日志级别。例如，如果您将日志记录器配置为在 TRACE 级别登录，您必须将最低日志级别设置为 TRACE。

您可以在应用程序的 application.properties 文件中为特定类别设置最小日志级别。在开始应用程序前，您必须设置最低日志级别。

例如，要在日志记录器配置中为 io.quarkus.smallrye.jwt 和 io.undertow.request.security 类别启用 TRACE 级别的日志记录，您可以设置以下属性：

quarkus.log.file.enable=true
# Send output to a trace.log file under the /tmp directory
quarkus.log.file.path=/tmp/trace.log
quarkus.log.file.level=TRACE
quarkus.log.file.format=%d{HH:mm:ss} %-5p [%c{2.}] (%t) %s%e%n
# Set 2 categories (io.quarkus.smallrye.jwt, io.undertow.request.security) to TRACE level
quarkus.log.min-level=TRACE
quarkus.log.category."io.quarkus.smallrye.jwt".level=TRACE
quarkus.log.category."io.undertow.request.security".level=TRACE

如需有关如何在 Quarkus 应用程序中配置日志记录的更多详细信息，请参阅设置运行时配置。

在 Red Hat build of Quarkus 1.11 中，com.redhat.quarkus:quarkus-universe-bom 不再直接包含所有扩展和依赖项的 goupId、artifactID 和版本。相反，com.redhat.quarkus:quarkus-universe-bom 导入 com.redhat.quarkus:quarkus-product-bom，其中包含由红帽支持的所有 Quarkus 扩展的依赖项声明，以及包含所有社区 Quarkus 扩展的 io.quarkus:quarkus-universe-bom。

此更改不会影响您可以在 Maven 项目中使用红帽构建的 Quarkus BOM。但是，如果您使用自定义脚本解析 BOM，您必须更新它们以确保在将应用程序升级到 Red Hat build of Quarkus 1.11 后解析将继续正常工作。

在红帽构建的 Quarkus 1.11 中，应用程序和非应用程序的 REST 端点的路径会根据常见的绝对路径解析。REST 端点的默认通用根路径设置为：

请注意，相对根路径嵌套在 quarkus.http.root-path 属性定义的根路径下。这意味着，如果 quarkus.http.root-path 属性中定义的根路径被设置为 /，非应用程序端点的绝对路径为 / q /<non-application-endpoint-name& gt;。

但是，您还可以将单个非应用程序端点的路径明确配置为位于 /q/<non-application-endpoint-name>。

因为端点路径解释为相对于 quarkus.http.root-path 和 quarkus.http.non-application-root-path 设置的根路径，所以您必须排除您为应用程序中端点配置的前导斜杠(/)字符。

例如，当您在 REST 控制器中为 Prometheus 公开指标端点时，您必须将 @Path 注解中的端点路径设置为 metrics，以确保您的端点通过 /q/metrics 公开。将相同的路径值设置为 /metrics 会在 /metrics 中公开您的指标端点。

在单独的命名空间中配置非应用程序端点的示例

例如，您可以在项目的 application.properties 文件中设置以下属性，以在 /api 根路径上公开 hello 端点应用程序，以及 /api/q 路径的指标端点：

quarkus.http.root-path=/api
quarkus.http.non-application-root-path=q

在此配置中，/api/hello 和 /api/q/metrics 都是 public。这意味着，任何有权访问 /api/hello 的用户也可以向 /api/q/metrics 端点发送请求并接收有效的响应。

当您要使 健康 端点非公共端点时，您可以将 application.properties 中的非应用程序端点的根路径设置为 /q 命名空间：

quarkus.http.root-path=/api
quarkus.http.non-application-root-path=/q

在此配置中，/api/hello 端点是公共的，但 /q/metrics 在单独的命名空间中公开，您可为其配置不同的访问权限。

在红帽构建的 Quarkus 1.11 中，发送到原始非应用程序端点路径的请求会自动重定向到 /q 命名空间中的新路径。

您可以在项目的 application.properties 文件中设置以下属性，以禁用非应用程序端点路径的自动重定向：

quarkus.http.redirect-to-non-application-root-path=false

您可以通过将 quarkus.http.non-application-root-path 的值设置为解析为解析为绝对应用程序端点根值的变量，将应用程序切换到所有端点的绝对端点根路径：

quarkus.http.non-application-root-path=${quarkus.http.root-path}

在 Red Hat build of Quarkus 1.11 中，当您为 Red Hat OpenShift Container Platform 配置 Quarkus 应用程序时，并在 quarkus .openshift 中指定的 ConfigMap 中提供 应用程序 的配置参数，以确保应用程序识别和处理 ConfigMap。

红帽构建的 Quarkus 1.11 中添加了以下支持的扩展：

有关红帽支持的 Quarkus 扩展、依赖项和插件的红帽构建列表，请参阅 Red Hat build of Quarkus 组件详情页面 （需要登录）。

红帽 为以下红帽构建的 Quarkus 功能、插件、扩展和依赖项提供开发支持 ：

有关 Red Hat build of Quarkus 1.11 中作为技术预览提供的扩展和依赖项列表，请参阅 Red Hat build of Quarkus 组件详情页 （需要登录）。

更新于 2023-05-16