迁移指南

• 升级到最新的 1.5.x 版本

  • 开始之前，请先升级到最新的 1.5.x 可用版本。这是为了确保您正在根据该行的最新依赖项进行构建。

• 查看依赖项

  • 迁移到 Spring Boot 2 将导致升级多个依赖项。查看带有 2.0.x 的依赖项管理 1.5.x 的依赖项管理，以评估您的项目会受到影响。
  • 识别不是由 Spring Boot 管理的依赖项的兼容版本，然后为这些定义显式版本。

• 查看自定义配置

  • 可能需要在升级过程中检查项目定义的任何自定义配置。如果它可以被使用标准自动配置替换，请在升级前执行此操作。

• 查看系统要求

  • Spring Boot 2.0 需要 Java 8 或更高版本。
  • 它还需要 Spring Framework 5.0。
  • Java 6 和 7 不再被支持。

• 更新您的应用，以创建连接 bean 作为 com.mongodb.client.MongoClient 实例。

  例如，创建一个到 MongoDB 的连接，如下所示：

  import com.mongodb.client.MongoClient;

  Copy to Clipboard Toggle word wrap

  然后您可以创建 MongoClient bean，如下例所示：

  return MongoClients.create("mongodb://admin:password@192.168.99.102:32553");

  Copy to Clipboard Toggle word wrap
• 如果需要，请重构与 MongoClient 类公开的方法相关的任何代码。

• Camel 从 Spring Boot v1 升级到 v2，因此不再支持 v1。
• 升级到 Spring Framework 5。Camel 应该与 Spring 4.3.x 一起工作，但在未来的 Spring 5.x 将会是最低的 Spring 版本。
• 升级到 Karaf 4.2。您可以在 Karaf 4.1 上运行 Camel，但我们在此版本中仅正式支持 Karaf 4.2。
• 使用 toD DSL 优化，以将端点和制作者重新用于组件。例如，基于 HTTP 的组件现在将利用动态 URI 发送到同一主机的生成者(HTTP 客户端)。
• 现在，可以配置具有 read-lock idempotent/idempotent-changed 的 File2 使用者，以延迟发行任务，以便在文件被视为进程中时扩展窗口，这可用于具有共享的幂等存储库的 active/active 集群设置，以确保其他节点没有太快地将已处理的文件作为文件（如果您有 readLockRemoveOnCommit=true 时才需要）。
• 允许以 request/reply 模式在 Netty4 producer 上插件自定义请求/回复 ID 管理器实现。Twitter 组件现在默认使用扩展模式来支持大于 140 个字符的 tweets
• REST DSL 生成者现在支持使用 endpointProperties 在 REST 配置中配置。
• Kafka 组件现在支持 HeaderFilterStrategy 来插件自定义实现，以控制 Camel 和 Kafka 信息之间的标头映射。
• REST DSL 现在支持客户端请求验证 REST 服务是否可以验证 Content-Type/Accept 标头。
• Camel 现在有一个 Service Registry SPI，它允许您使用 Camel 实现或 Spring Cloud 将路由注册到服务 registry （如 consul、etcd 或 zookeeper）。
• SEDA 组件现在的默认队列大小为 1000，而不是无限。

• 以下值得注意的问题已被修复：

  • 修复了带有 camel-cxf 消费者的 CXF 持续超时问题，可能会导致消费者返回带有数据的响应，而不是触发调用 SOAP 客户端的超时。
  • 修复了 camel-cxf 消费者在使用强大的单向操作时不会发布 UoW。
  • 修复了使用 AdviceWith 并使用 weave 方法 onException 等问题。
  • 修复了并行处理和流模式中的 Splitter 可能会阻止，当迭代消息正文时，第一次调用 next （）方法调用时，迭代消息正文。
  • 修复了 Kafka 消费者，如果 autoCommitEnable=false，则不会自动提交。
  • 修复了文件消费者默认使用 markerFile 作为 read-lock，它应该没有。
  • 修复了使用带有 Kafka 的手动提交的问题，以提供当前的记录偏移，而不是之前（第一个为 -1）。
  • 修复了 Java DSL 中基于内容的路由路由器，可能无法解析 predicates 中的属性占位符。

• 升级到 Spring Boot 2.1。
• 现在，可以使用 spring-boot 自动配置来配置额外的组件级别选项。这些选项包含在 spring-boot 组件元数据 JSON 文件描述符中，以获得工具协助。
• 添加了一个文档部分，其中包含所有组件、数据格式和语言的所有 Spring Boot auto 配置选项。
• 所有 Camel Spring Boot starter JAR 现在在其 JAR 中包含 META-INF/spring-autoconfigure-metadata.properties 文件，以优化 Spring Boot 自动配置。
• Throttler 现在支持基于动态表达式的关联组，以便您可以将消息分组到不同的节流集合中。
• Hystrix EIP 现在允许继承 Camel 的错误处理程序，以便在启用了带有 redeliveries 的错误处理时再次重试整个 Hystrix EIP 块。
• SQL 和 ElSql 用户现在支持路由表单中的动态查询参数。请注意，这个功能仅限于使用简单表达式调用 Bean。
• swagger-restdsl maven 插件现在支持从 Swagger 规格文件生成 DTO 模型类。

• 以下值得注意的问题已被修复：

  • 修正了 Aggregator2，不会传播控制标头以强制完成所有组，因此如果其他聚合器 EIP 在路由过程中正在使用另一个聚合器 EIP，则不会再次发生。
  • 修复了在错误处理程序中重新传送被激活时的 Tracer 无法正常工作。
  • XML 文档的内置类型转换器可能会将错误输出到 stdout，现在它已被修复为使用日志记录 API 的输出。
  • 修复了当消息正文基于流处理时，使用 charset 选项编写文件的 SFTP 无法正常工作。
  • 修复了当在多个路由路由时不会重复使用的 Zipkin root id，将它们分组到一个父 span 中。
  • 修复了在主机名包含带有数字的 IP 地址时，使用 HTTP 端点进行优化的问题。
  • 修复了在临时队列中带有请求/回复的 RabbitMQ 的问题，并使用手动确认模式。它不会确认临时队列（需要进行请求/回复）。
  • 修复了各种 HTTP 消费者组件，它们可能无法在 Allow header for OPTIONS 请求（比如使用 rest-dsl 时）返回所有允许的 HTTP 动词。
  • 修复了 FluentProducerTemplate 的 thread-safety 问题。

• 定义 Maven 依赖项的版本，以便在将依赖项添加到 pom.xml 文件时不需要指定版本。
• 定义一组对特定版本的 Fuse 经过全面测试并支持的策展依赖关系。
• 简化 Fuse 的升级。

• 更新您的应用，以创建连接 bean 作为 com.mongodb.client.MongoClient 实例。

  例如，创建一个到 MongoDB 的连接，如下所示：

  import com.mongodb.client.MongoClient;

  Copy to Clipboard Toggle word wrap

  然后您可以创建 MongoClient bean，如下例所示：

  return MongoClients.create("mongodb://admin:password@192.168.99.102:32553");

  Copy to Clipboard Toggle word wrap
• 如果需要，请重构与 MongoClient 类公开的方法相关的任何代码。

• Camel 从 Spring Boot v1 升级到 v2，因此不再支持 v1。
• 升级到 Spring Framework 5。Camel 应该与 Spring 4.3.x 一起工作，但在未来的 Spring 5.x 将会是最低的 Spring 版本。
• 升级到 Karaf 4.2。您可以在 Karaf 4.1 上运行 Camel，但我们在此版本中仅正式支持 Karaf 4.2。
• 使用 toD DSL 优化，以将端点和制作者重新用于组件。例如，基于 HTTP 的组件现在将利用动态 URI 发送到同一主机的生成者(HTTP 客户端)。
• 现在，可以配置具有 read-lock idempotent/idempotent-changed 的 File2 使用者，以延迟发行任务，以便在文件被视为进程中时扩展窗口，这可用于具有共享的幂等存储库的 active/active 集群设置，以确保其他节点没有太快地将已处理的文件作为文件（如果您有 readLockRemoveOnCommit=true 时才需要）。
• 允许以 request/reply 模式在 Netty4 producer 上插件自定义请求/回复 ID 管理器实现。Twitter 组件现在默认使用扩展模式来支持大于 140 个字符的 tweets
• REST DSL 生成者现在支持使用 endpointProperties 在 REST 配置中配置。
• Kafka 组件现在支持 HeaderFilterStrategy 来插件自定义实现，以控制 Camel 和 Kafka 信息之间的标头映射。
• REST DSL 现在支持客户端请求验证 REST 服务是否可以验证 Content-Type/Accept 标头。
• Camel 现在有一个 Service Registry SPI，它允许您使用 Camel 实现或 Spring Cloud 将路由注册到服务 registry （如 consul、etcd 或 zookeeper）。
• SEDA 组件现在的默认队列大小为 1000，而不是无限。

• 以下值得注意的问题已被修复：

  • 修复了带有 camel-cxf 消费者的 CXF 持续超时问题，可能会导致消费者返回带有数据的响应，而不是触发调用 SOAP 客户端的超时。
  • 修复了 camel-cxf 消费者在使用强大的单向操作时不会发布 UoW。
  • 修复了使用 AdviceWith 并使用 weave 方法 onException 等问题。
  • 修复了并行处理和流模式中的 Splitter 可能会阻止，当迭代消息正文时，第一次调用 next （）方法调用时，迭代消息正文。
  • 修复了 Kafka 消费者，如果 autoCommitEnable=false，则不会自动提交。
  • 修复了文件消费者默认使用 markerFile 作为 read-lock，它应该没有。
  • 修复了使用带有 Kafka 的手动提交的问题，以提供当前的记录偏移，而不是之前（第一个为 -1）。
  • 修复了 Java DSL 中基于内容的路由路由器，可能无法解析 predicates 中的属性占位符。

• 升级到 Spring Boot 2.1。
• 现在，可以使用 spring-boot 自动配置来配置额外的组件级别选项。这些选项包含在 spring-boot 组件元数据 JSON 文件描述符中，以获得工具协助。
• 添加了一个文档部分，其中包含所有组件、数据格式和语言的所有 Spring Boot auto 配置选项。
• 所有 Camel Spring Boot starter JAR 现在在其 JAR 中包含 META-INF/spring-autoconfigure-metadata.properties 文件，以优化 Spring Boot 自动配置。
• Throttler 现在支持基于动态表达式的关联组，以便您可以将消息分组到不同的节流集合中。
• Hystrix EIP 现在允许继承 Camel 的错误处理程序，以便在启用了带有 redeliveries 的错误处理时再次重试整个 Hystrix EIP 块。
• SQL 和 ElSql 用户现在支持路由表单中的动态查询参数。请注意，这个功能仅限于使用简单表达式调用 Bean。
• swagger-restdsl maven 插件现在支持从 Swagger 规格文件生成 DTO 模型类。

• 以下值得注意的问题已被修复：

  • 修正了 Aggregator2，不会传播控制标头以强制完成所有组，因此如果其他聚合器 EIP 在路由过程中正在使用另一个聚合器 EIP，则不会再次发生。
  • 修复了在错误处理程序中重新传送被激活时的 Tracer 无法正常工作。
  • XML 文档的内置类型转换器可能会将错误输出到 stdout，现在它已被修复为使用日志记录 API 的输出。
  • 修复了当消息正文基于流处理时，使用 charset 选项编写文件的 SFTP 无法正常工作。
  • 修复了当在多个路由路由时不会重复使用的 Zipkin root id，将它们分组到一个父 span 中。
  • 修复了在主机名包含带有数字的 IP 地址时，使用 HTTP 端点进行优化的问题。
  • 修复了在临时队列中带有请求/回复的 RabbitMQ 的问题，并使用手动确认模式。它不会确认临时队列（需要进行请求/回复）。
  • 修复了各种 HTTP 消费者组件，它们可能无法在 Allow header for OPTIONS 请求（比如使用 rest-dsl 时）返回所有允许的 HTTP 动词。
  • 修复了 FluentProducerTemplate 的 thread-safety 问题。

• 定义 Maven 依赖项的版本，以便在将依赖项添加到 pom.xml 文件时不需要指定版本。
• 定义一组对特定版本的 Fuse 经过全面测试并支持的策展依赖关系。
• 简化 Fuse 的升级。

• 更新您的应用，以创建连接 bean 作为 com.mongodb.client.MongoClient 实例。

  例如，创建一个到 MongoDB 的连接，如下所示：

  import com.mongodb.client.MongoClient;

  Copy to Clipboard Toggle word wrap

  然后您可以创建 MongoClient bean，如下例所示：

  return MongoClients.create("mongodb://admin:password@192.168.99.102:32553");

  Copy to Clipboard Toggle word wrap
• 如果需要，请重构与 MongoClient 类公开的方法相关的任何代码。

• Camel 从 Spring Boot v1 升级到 v2，因此不再支持 v1。
• 升级到 Spring Framework 5。Camel 应该与 Spring 4.3.x 一起工作，但在未来的 Spring 5.x 将会是最低的 Spring 版本。
• 升级到 Karaf 4.2。您可以在 Karaf 4.1 上运行 Camel，但我们在此版本中仅正式支持 Karaf 4.2。
• 使用 toD DSL 优化，以将端点和制作者重新用于组件。例如，基于 HTTP 的组件现在将利用动态 URI 发送到同一主机的生成者(HTTP 客户端)。
• 现在，可以配置具有 read-lock idempotent/idempotent-changed 的 File2 使用者，以延迟发行任务，以便在文件被视为进程中时扩展窗口，这可用于具有共享的幂等存储库的 active/active 集群设置，以确保其他节点没有太快地将已处理的文件作为文件（如果您有 readLockRemoveOnCommit=true 时才需要）。
• 允许以 request/reply 模式在 Netty4 producer 上插件自定义请求/回复 ID 管理器实现。Twitter 组件现在默认使用扩展模式来支持大于 140 个字符的 tweets
• REST DSL 生成者现在支持使用 endpointProperties 在 REST 配置中配置。
• Kafka 组件现在支持 HeaderFilterStrategy 来插件自定义实现，以控制 Camel 和 Kafka 信息之间的标头映射。
• REST DSL 现在支持客户端请求验证 REST 服务是否可以验证 Content-Type/Accept 标头。
• Camel 现在有一个 Service Registry SPI，它允许您使用 Camel 实现或 Spring Cloud 将路由注册到服务 registry （如 consul、etcd 或 zookeeper）。
• SEDA 组件现在的默认队列大小为 1000，而不是无限。

• 以下值得注意的问题已被修复：

  • 修复了带有 camel-cxf 消费者的 CXF 持续超时问题，可能会导致消费者返回带有数据的响应，而不是触发调用 SOAP 客户端的超时。
  • 修复了 camel-cxf 消费者在使用强大的单向操作时不会发布 UoW。
  • 修复了使用 AdviceWith 并使用 weave 方法 onException 等问题。
  • 修复了并行处理和流模式中的 Splitter 可能会阻止，当迭代消息正文时，第一次调用 next （）方法调用时，迭代消息正文。
  • 修复了 Kafka 消费者，如果 autoCommitEnable=false，则不会自动提交。
  • 修复了文件消费者默认使用 markerFile 作为 read-lock，它应该没有。
  • 修复了使用带有 Kafka 的手动提交的问题，以提供当前的记录偏移，而不是之前（第一个为 -1）。
  • 修复了 Java DSL 中基于内容的路由路由器，可能无法解析 predicates 中的属性占位符。

• 升级到 Spring Boot 2.1。
• 现在，可以使用 spring-boot 自动配置来配置额外的组件级别选项。这些选项包含在 spring-boot 组件元数据 JSON 文件描述符中，以获得工具协助。
• 添加了一个文档部分，其中包含所有组件、数据格式和语言的所有 Spring Boot auto 配置选项。
• 所有 Camel Spring Boot starter JAR 现在在其 JAR 中包含 META-INF/spring-autoconfigure-metadata.properties 文件，以优化 Spring Boot 自动配置。
• Throttler 现在支持基于动态表达式的关联组，以便您可以将消息分组到不同的节流集合中。
• Hystrix EIP 现在允许继承 Camel 的错误处理程序，以便在启用了带有 redeliveries 的错误处理时再次重试整个 Hystrix EIP 块。
• SQL 和 ElSql 用户现在支持路由表单中的动态查询参数。请注意，这个功能仅限于使用简单表达式调用 Bean。
• swagger-restdsl maven 插件现在支持从 Swagger 规格文件生成 DTO 模型类。

• 以下值得注意的问题已被修复：

  • 修正了 Aggregator2，不会传播控制标头以强制完成所有组，因此如果其他聚合器 EIP 在路由过程中正在使用另一个聚合器 EIP，则不会再次发生。
  • 修复了在错误处理程序中重新传送被激活时的 Tracer 无法正常工作。
  • XML 文档的内置类型转换器可能会将错误输出到 stdout，现在它已被修复为使用日志记录 API 的输出。
  • 修复了当消息正文基于流处理时，使用 charset 选项编写文件的 SFTP 无法正常工作。
  • 修复了当在多个路由路由时不会重复使用的 Zipkin root id，将它们分组到一个父 span 中。
  • 修复了在主机名包含带有数字的 IP 地址时，使用 HTTP 端点进行优化的问题。
  • 修复了在临时队列中带有请求/回复的 RabbitMQ 的问题，并使用手动确认模式。它不会确认临时队列（需要进行请求/回复）。
  • 修复了各种 HTTP 消费者组件，它们可能无法在 Allow header for OPTIONS 请求（比如使用 rest-dsl 时）返回所有允许的 HTTP 动词。
  • 修复了 FluentProducerTemplate 的 thread-safety 问题。

• 定义 Maven 依赖项的版本，以便在将依赖项添加到 pom.xml 文件时不需要指定版本。
• 定义一组对特定版本的 Fuse 经过全面测试并支持的策展依赖关系。
• 简化 Fuse 的升级。

• 更新任何文件，包括捆绑 JAR、配置文件和任何静态文件。
• 对当前容器实例（及其在 data/ 目录下的运行时存储）和底层安装进行补丁。因此，在删除容器实例后会保留补丁。
• 更新与 Karaf 功能相关的所有文件，包括功能存储库文件和功能本身。因此，推出补丁后安装的任何功能都将引用正确的补丁依赖项。
• 如有必要，更新配置文件（例如 etc/下的文件），自动合并您已与补丁所做的配置更改所做的任何配置更改。如果发生合并冲突，请参阅补丁日志来了解如何处理它们的详细信息。
• 大多数合并冲突会自动解决。例如，补丁机制检测到属性文件的属性级别的冲突。它检测它是更改任何属性的用户或补丁。如果只更改属性，则更改会被保留。

• 跟踪对安装进行的所有更改（包括静态文件），以便可以回滚补丁。

  注意

  回滚补丁机制使用内部 git 存储库（位于 patches/.management/history下）来跟踪所做的更改。

先决条件

• 在升级前，确保您已在 Apache Karaf 安装上进行 Fuse 的完整备份。
• 启动容器（如果尚未运行）。

• 通过调用 patch:add 命令将升级安装程序文件添加到容器环境中。例如，要添加 fuse-karaf-7.13.0.fuse-7_13_0-00012-redhat-00001.zip 升级安装程序文件：

  patch:add file:///path/to/fuse-karaf-7.13.0.fuse-7_13_0-00012-redhat-00001.zip

  Copy to Clipboard Toggle word wrap
  注意

  patch:find 命令只能用于查找和添加容器环境的最新热修复补丁 ; 它不能被应用完整的升级补丁。

  流程

  1. 运行 patch:update 命令。不需要重启容器。

     karaf@root()> patch:update
     Current patch mechanism version: 7.1.0.fuse-710023-redhat-00001
     New patch mechanism version detected: 7.2.0.fuse-720035-redhat-00001
     Uninstalling patch features in version 7.1.0.fuse-710023-redhat-00001
     Installing patch features in version 7.2.0.fuse-720035-redhat-00001

     Copy to Clipboard Toggle word wrap

  2. 调用 patch:list 命令来显示升级安装程序列表。在此列表中，[name] 标题下的条目是升级 ID。例如：

     karaf@root()> patch:list
     [name]                                    [installed] [rollup] [description]
     fuse-karaf-7.2.0.fuse-720035-redhat-00001 false       true     fuse-karaf-7.2.0.fuse-720035-redhat-00001

     Copy to Clipboard Toggle word wrap

  3. 通过调用 patch:simulate 命令并为您要应用的升级指定升级 ID 来模拟升级，如下所示：

     karaf@root()> patch:simulate fuse-karaf-7.2.0.fuse-720035-redhat-00001
     INFO : org.jboss.fuse.modules.patch.patch-management (226): Installing rollup patch "fuse-karaf-7.2.0.fuse-720035-redhat-00001"
     ========== Repositories to remove (9):
      - mvn:io.hawt/hawtio-karaf/2.0.0.fuse-710018-redhat-00002/xml/features
     ...
     ========== Repositories to add (9):
      - mvn:io.hawt/hawtio-karaf/2.0.0.fuse-720044-redhat-00001/xml/features
     ...
     ========== Repositories to keep (10):
      - mvn:org.apache.activemq/artemis-features/2.4.0.amq-711002-redhat-1/xml/features
     ...
     ========== Features to update (100):
     [name]                         [version]                         [new version]
     aries-blueprint                4.2.0.fuse-710024-redhat-00002    4.2.0.fuse-720061-redhat-00001
     ...
     ========== Bundles to update as part of features or core bundles (100):
     [symbolic name]                                                [version]                         [new location]
     io.hawt.hawtio-log                                             2.0.0.fuse-710018-redhat-00002    mvn:io.hawt/hawtio-log/2.0.0.fuse-720044-redhat-00001
     ...
     ========== Bundles to reinstall as part of features or core bundles (123):
     [symbolic name]                                                [version]                         [location]
     com.fasterxml.jackson.core.jackson-annotations                 2.8.11                            mvn:com.fasterxml.jackson.core/jackson-annotations/2.8.11
     ...
     Simulation only - no files and runtime data will be modified.
     karaf@root()>

     Copy to Clipboard Toggle word wrap

     这会生成执行升级时将对容器进行的更改日志，但不会对容器进行任何更改。检查模拟日志，以了解要对容器进行的更改。

  4. 通过调用 patch:install 命令并为您要应用的升级指定升级 ID 来升级容器。例如：

     karaf@root()> patch:install fuse-karaf-7.13.0.fuse-7_13_0-00012-redhat-00001

     Copy to Clipboard Toggle word wrap

  5. 通过搜索其中一个升级工件来验证升级。例如，如果您只将 Fuse 7.1.0 升级到 Fuse 7.2.0，您可以搜索构建号 7.2.0.fuse-720035-redhat-00001 的捆绑包，如下所示：

     karaf@root()> bundle:list -l | grep 7.2.0.fuse-720035-redhat-00001
      22 │ Active │  80 │ 7.2.0.fuse-720035-redhat-00001  │ mvn:org.jboss.fuse.modules/fuse-pax-transx-tm-narayana/7.2.0.fuse-720035-redhat-00001
     188 │ Active │  80 │ 7.2.0.fuse-720035-redhat-00001  │ mvn:org.jboss.fuse.modules.patch/patch-commands/7.2.0.fuse-720035-redhat-00001

     Copy to Clipboard Toggle word wrap

先决条件

• 您最近在 Karaf 上升级了 Fuse。
• 您需要回滚升级。