迁移指南

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

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

• 检查依赖项

  • 迁移到 Spring Boot 2 将会导致升级多个依赖项。查看 1.5.x 的依赖项管理，它带有 2.0.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 的最低版本。
• 升级至 Karaf 4.2。您可以在 Karaf 4.1 上运行 Camel，但在此版本中，我们只正式支持 Karaf 4.2。
• 使用 toD DSL 优化为可能的组件重复使用端点和制作者。例如，基于 HTTP 的组件现在将重复使用带有发送到同一主机的动态 URI 的生产者（HTTP 客户端）。
• 现在，可将具有 read-lock idempotent/idempotent-changed 的 file2 使用者配置为延迟发行任务，以在文件视为进程中时（仅在有共享幂等库的主动/主动集群设置中使用）。
• 允许在请求/reply 模式的 Netty4 producer 上插件自定义请求/关系 id 管理器实施。Twitter 组件现在默认使用扩展模式来支持超过 140 个字符的调整
• 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 consumer 的 CXF continuation 超时问题，这可能会导致使用者返回带有数据的响应，而不是触发调用 SOAP 客户端的超时问题。
  • 修复了 camel-cxf consumer在使用强健的单向操作时不会发布 UoW。
  • 修复了使用 AdviceWith 以及在Exception 上使用 usave 方法等问题。
  • 修复了并行处理和流传输模式中的 Splitter 可能会阻断，当迭代邮件正文时，迭代邮件正文在第一个调用的 next（）方法调用中引发异常。
  • 修复了 Kafka 用户，在 autoCommitEnable=false 时不自动提交。
  • 固定的文件消费者使用标记文件（默认情况下为 read-lock），这应该没有。
  • 修复了将手动提交与 Kafka 一起使用，以提供当前的记录偏移，而不是上一个记录（第一个使用 -1）。
  • 修复了 Java DSL 中基于内容的路由器可能无法解析 predicates 时 中的属性占位符。

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

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

  • 修正了聚合器2，不会传播控制标头以强制完成所有组，因此以后路由过程中使用了另一个聚合器 EIP 时，它不会再次发生。
  • 修复了当错误处理器中重新发送被激活时的 Tracer 无法正常工作。
  • XML 文档的内置类型转换器可能会输出将错误解析到 stdout，该错误现在使用日志记录 API 固定为输出。
  • 修复了在基于消息正文时，使用 charset 选项的 SFTP 写入文件将无法正常工作。
  • 修复了当在多个路由之间进行路由时，Zipkin root id 不会被重复使用，从而将它们分组到一个父范围中。
  • 修复了在使用 HTTP 端点时，当主机名包含带有数字的 IP 地址时，被优化为D。
  • 修复了 RabbitMQ 与请求/回复超过临时队列的 RabbitMQ 的问题，并使用手动确认模式。它不会确认临时队列（需要可以发出请求/恢复）。
  • 修复了各种 HTTP 消费者组件，它们可能无法在 Allow header 中为 OPTIONS 请求返回所有允许的 HTTP 动词（比如使用 rest-dsl）。
  • 修复了 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 的最低版本。
• 升级至 Karaf 4.2。您可以在 Karaf 4.1 上运行 Camel，但在此版本中，我们只正式支持 Karaf 4.2。
• 使用 toD DSL 优化为可能的组件重复使用端点和制作者。例如，基于 HTTP 的组件现在将重复使用带有发送到同一主机的动态 URI 的生产者（HTTP 客户端）。
• 现在，可将具有 read-lock idempotent/idempotent-changed 的 file2 使用者配置为延迟发行任务，以在文件视为进程中时（仅在有共享幂等库的主动/主动集群设置中使用）。
• 允许在请求/reply 模式的 Netty4 producer 上插件自定义请求/关系 id 管理器实施。Twitter 组件现在默认使用扩展模式来支持超过 140 个字符的调整
• 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 consumer 的 CXF continuation 超时问题，这可能会导致使用者返回带有数据的响应，而不是触发调用 SOAP 客户端的超时问题。
  • 修复了 camel-cxf consumer在使用强健的单向操作时不会发布 UoW。
  • 修复了使用 AdviceWith 以及在Exception 上使用 usave 方法等问题。
  • 修复了并行处理和流传输模式中的 Splitter 可能会阻断，当迭代邮件正文时，迭代邮件正文在第一个调用的 next（）方法调用中引发异常。
  • 修复了 Kafka 用户，在 autoCommitEnable=false 时不自动提交。
  • 固定的文件消费者使用标记文件（默认情况下为 read-lock），这应该没有。
  • 修复了将手动提交与 Kafka 一起使用，以提供当前的记录偏移，而不是上一个记录（第一个使用 -1）。
  • 修复了 Java DSL 中基于内容的路由器可能无法解析 predicates 时 中的属性占位符。

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

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

  • 修正了聚合器2，不会传播控制标头以强制完成所有组，因此以后路由过程中使用了另一个聚合器 EIP 时，它不会再次发生。
  • 修复了当错误处理器中重新发送被激活时的 Tracer 无法正常工作。
  • XML 文档的内置类型转换器可能会输出将错误解析到 stdout，该错误现在使用日志记录 API 固定为输出。
  • 修复了在基于消息正文时，使用 charset 选项的 SFTP 写入文件将无法正常工作。
  • 修复了当在多个路由之间进行路由时，Zipkin root id 不会被重复使用，从而将它们分组到一个父范围中。
  • 修复了在使用 HTTP 端点时，当主机名包含带有数字的 IP 地址时，被优化为D。
  • 修复了 RabbitMQ 与请求/回复超过临时队列的 RabbitMQ 的问题，并使用手动确认模式。它不会确认临时队列（需要可以发出请求/恢复）。
  • 修复了各种 HTTP 消费者组件，它们可能无法在 Allow header 中为 OPTIONS 请求返回所有允许的 HTTP 动词（比如使用 rest-dsl）。
  • 修复了 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 的最低版本。
• 升级至 Karaf 4.2。您可以在 Karaf 4.1 上运行 Camel，但在此版本中，我们只正式支持 Karaf 4.2。
• 使用 toD DSL 优化为可能的组件重复使用端点和制作者。例如，基于 HTTP 的组件现在将重复使用带有发送到同一主机的动态 URI 的生产者（HTTP 客户端）。
• 现在，可将具有 read-lock idempotent/idempotent-changed 的 file2 使用者配置为延迟发行任务，以在文件视为进程中时（仅在有共享幂等库的主动/主动集群设置中使用）。
• 允许在请求/reply 模式的 Netty4 producer 上插件自定义请求/关系 id 管理器实施。Twitter 组件现在默认使用扩展模式来支持超过 140 个字符的调整
• 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 consumer 的 CXF continuation 超时问题，这可能会导致使用者返回带有数据的响应，而不是触发调用 SOAP 客户端的超时问题。
  • 修复了 camel-cxf consumer在使用强健的单向操作时不会发布 UoW。
  • 修复了使用 AdviceWith 以及在Exception 上使用 usave 方法等问题。
  • 修复了并行处理和流传输模式中的 Splitter 可能会阻断，当迭代邮件正文时，迭代邮件正文在第一个调用的 next（）方法调用中引发异常。
  • 修复了 Kafka 用户，在 autoCommitEnable=false 时不自动提交。
  • 固定的文件消费者使用标记文件（默认情况下为 read-lock），这应该没有。
  • 修复了将手动提交与 Kafka 一起使用，以提供当前的记录偏移，而不是上一个记录（第一个使用 -1）。
  • 修复了 Java DSL 中基于内容的路由器可能无法解析 predicates 时 中的属性占位符。

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

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

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

• 定义 Maven 依赖项的版本，这样您不需要在向 pom.xml 文件中添加依赖项时指定版本。
• 定义一组经过策展的依赖关系，这些依赖项是针对特定版本的 Fuse 完全测试和支持的。
• 简化 Fuse 升级.

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

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

  注意

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

先决条件

• 在升级前，请确保您在 Apache 手册安装有完好的 Fuse 备份。
• 启动容器（如果尚未运行）。

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

  patch:add file:///path/to/fuse-karaf-7.11.1.fuse-7_11_1-00013-redhat-00003.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.11.1.fuse-7_11_1-00013-redhat-00003

     Copy to Clipboard Toggle word wrap

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

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

     Copy to Clipboard Toggle word wrap

先决条件

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