release_notes.adoc

Camel Upgrade Recipes - Release notes

4.20.0

Summary

This is a release supporting Camel, Camel Quarkus and Camel Spring Boot 4.20.0 with the required upgrade recipes (described by the migration guide).

Migration coverage

The following table lists migration topics and indicates the level of coverage (full, partial, or not covered), along with additional comments.

Migration	Coverage	Comment
camel-jbang	❌ None	YAML DSL file naming convention change. Manual review required.
camel-exec	❌ None	Security change requiring explicit opt-in via allowControlHeaders=true. Manual configuration required.
camel-pulsar	⚠️ Partial	V1 to V2 topic URI format automatically migrated for simple topic names (without slashes). Removes cluster segment from URIs like pulsar:persistent://tenant/cluster/namespace/topic. URIs with slashes in topic names (e.g., topic/sub-path) are NOT transformed to avoid ambiguity between V1 and V2 formats - these require manual migration.
camel-oaipmh	❌ None	New HTTP header parameter functionality. No migration needed.
camel-bom	✅ Full	Automatically migrated.
camel-cloud and serviceCall EIP	✅ Full	Automatically migrated.
PQC TLS Auto-Configuration	❌ None	Automatic configuration, no migration needed.
Errorregistry	❌ None	Addition of a new SPI, no migration needed.
Saga EIP	✅ Full	XML and YAML DSL automatically migrated. Java DSL not affected.
camel-platform-http-main	❌ None	Configuration change requires manual review.
camel-csimple (deprecation)	❌ None	Deprecated module. Not supported by the migration tool.
camel-simple	❌ None	Syntax change requires manual code review.
camel-test-infra	✅ Full	Automatically migrated.
camel-yaml-io / camel-xml-io	✅ Full	Automatically migrated.
Jackson 3 components	❌ None	Component addition, no migration required.
camel-test-junit6, camel-test-main-junit6, camel-test-spring-junit6	❌ None	Optional migration.
camel-jbang	❌ None	Configuration change requires manual review.
camel-groovy	❌ None	External library upgrade requires manual testing.
camel-groovy-xml	✅ Full	Automatically migrated.
camel-kafka	❌ None	External library upgrade with behavior changes. Requires manual review.
camel-google-pubsub-lite	❌ None	Component removal requires manual migration.
camel-json-patch	❌ None	Deprecated module. Not supported by the migration tool.
camel-mail	❌ None	Automatic behavior change, no code migration needed.
camel-file / camel-aws2-s3 / camel-ibm-cos	❌ None	Behavior change, no migration required.
camel-openapi-java	❌ None	Configuration change requires manual review.
camel-arangodb	❌ None	Configuration change requires manual review.
camel-as2	❌ None	API changes require manual code updates.
camel-couchbase	❌ None	Configuration change requires manual review.
camel-debezium	❌ None	External library upgrade requires manual testing.
camel-mail	❌ None	Automatic behavior change, no code migration needed.
camel-ftp	❌ None	Module extraction may require dependency addition for custom implementations.
JSch upgrade	❌ None	External library upgrade requires manual testing.
OpenSSH certificate authentication	❌ None	New feature, no automated migration required.
camel-azure (CredentialType standardization)	❌ None	Enum deprecation. No automatic migration required.
camel-quickfix	❌ None	External library upgrade requires manual testing.
camel-ssh	❌ None	New properties available, no migration required.
camel-json-validator	❌ None	External library upgrade requires manual code updates.
MDC older logic (Deprecation)	❌ None	Configuration deprecation requires manual migration.
camel-splunk (Deprecation)	❌ None	Component deprecation requires manual migration decision.
camel-tracing (Deprecation)	❌ None	Component deprecation requires manual migration decision.
camel-zeebe (Deprecation)	❌ None	Deprecated component requires manual migration to camel-camunda.
Removed Components	✅ Full	Component removal: Automatically migrated.

4.18.0

Summary

This is a release supporting Camel, Camel Quarkus and Camel Spring Boot 4.18.0 with the required upgrade recipes (described by the migration guide).

Migration coverage

The following table lists migration topics and indicates the level of coverage (full, partial, or not covered), along with additional comments.

Migration	Coverage	Comment
camel-simple	❌ None	Not supported by the migration tool.
camel-file	❌ None	Not supported by the migration tool.
camel-docling	❌ None	Not supported by the migration tool.
camel-qdrant	✅ Full	Automatically migrated.
camel-tahu	⚠️ Partial	Tool renames handlers to MultiHostApplicationEventHandler. Other API changes are not covered.
camel-platform-http-vertx and Rest DSL contract-first	❌ None	Not supported by the migration tool.
Component deprecation	❌ None	Not supported by the migration tool.

4.17.0

Summary

This is a release supporting Camel, Camel Quarkus and Camel Spring Boot 4.17.0 with the required upgrade recipes (described by the migration guide).

Migration coverage

The following table lists migration topics and indicates the level of coverage (full, partial, or not covered), along with additional comments.

Migration	Coverage	Comment
camel-core	✅ Full	Automatically migrated.
Custom Camel components	❌ None	Not supported by the migration tool.
camel-cluster	❌ None	Not supported by the migration tool.
camel-jbang	❌ None	Not supported by the migration tool.
camel-debezium	❌ None	Not supported by the migration tool.
camel-ftp	❌ None	Not supported by the migration tool.
camel-infinispan	❌ None	Not supported by the migration tool.
camel-tika	❌ None	Not supported by the migration tool.
camel-undertow	❌ None	Not supported by the migration tool.
component deprecation	❌ None	Not supported by the migration tool.
testcontainers updated to 2.0,2	❌ None	Not supported by the migration tool.
camel-salesforce	❌ None	Not supported by the migration tool.
maven archetype	❌ None	Not supported by the migration tool.

4.16.0

Summary

This is a release supporting Camel and Camel Spring Boot 4.16.0 with the required upgrade recipes (described by the migration guide).

Migration coverage

The following table lists migration topics and indicates the level of coverage (full, partial, or not covered), along with additional comments.

Migration	Coverage	Comment
EIPS	❌ None	Not supported by the migration tool.
camel-core	❌ None	Not supported by the migration tool.
camel-as2	❌ None	Not supported by the migration tool.
camel-kamelet	❌ None	Not supported by the migration tool.
camel-infinispan	❌ None	Not supported by the migration tool.
camel-jbang	❌ None	Not supported by the migration tool.
camel-milo	⚠️ Partial	Certificate validation API changes are covered. Subscription monitoring API changes are covered only if lambda expression is used.
camel-flink	❌ None	Not supported by the migration tool.

4.15.0

Summary

This is a release supporting Camel and Camel Spring Boot 4.15.0 with the required upgrade recipes (described by the migration guide).

Migration coverage

The following table lists migration topics and indicates the level of coverage (full, partial, or not covered), along with additional comments.

Migration	Coverage	Comment
Data Formats	⚠️ Partial	DataFormat changes are migrated automatically. Csv’s change of parameters from List<String> to String are not supported by the migration tool
camel-netty / camel-netty-http	⚠️ Partial	Basic cases in Xml DSL and Yaml DSL are covered. Java is not supported by the migration tool, because the java code requires manuals migration due to parameter type change.
Camel AI Nested Headers classes	✅ Full
camel-mdc	❌ None	Not supported by the migration tool.

4.14.0.1

Fixes #60

Introduces recipe for upgrading plain Camel into latest 4.10 (LTS) version by running:

mvn -U org.openrewrite.maven:rewrite-maven-plugin:run -Drewrite.recipeArtifactCoordinates=org.apache.camel.upgrade:camel-upgrade-recipes:LATEST -Drewrite.activeRecipes=org.apache.camel.upgrade.Camel410LTSMigrationRecipe

4.14.0

Summary

This is a release supporting Camel and Camel Spring Boot 4.14.0 LTS with the required upgrade recipes (described by the migration guide).

Migration coverage

The following table lists migration topics and indicates the level of coverage (full, partial, or not covered), along with additional comments.

Migration	Coverage	Comment
camel-core	❌ None	Not supported by the migration tool.
camel-main	⚠️ Partial	Separation of management services and business services is covered, whilst the default HTTP endpoint are untouched.
camel-jbang	❌ None	Not supported by the migration tool.
camel-google	❌ None	Not supported by the migration tool.
camel-consul	❌ None	Not supported by the migration tool.
camel-dapr	❌ None	Not supported by the migration tool.
camel-huawei-dms	❌ None	Not supported by the migration tool.
camel-weather	❌ None	Not supported by the migration tool.
camel-web3j	❌ None	Not supported by the migration tool.
camel-spring-batch	❌ None	Not supported by the migration tool.

Full changelog

https://github.com/apache/camel-upgrade-recipes/compare/4.13.0..4.14.0

4.13.0

Summary

This is a release supporting Camel and Camel Spring Boot 4.13.0 with the required upgrade recipes (described by the migration guide).

Migration coverage

The following table lists migration topics and indicates the level of coverage (full or not covered), along with additional comments.

Migration	Coverage	Comment
camel-core	❌ None	Not supported by the migration tool.
camel-file / camel-ftp / camel-smb / camel-azure-files	❌ None	Not supported by the migration tool.
camel-http	✅ Full	Automatically migrated.
camel_language	❌ None	Not supported by the migration tool.
camel-salesforce	❌ None	Not supported by the migration tool.
camel-yaml-dsl	✅ Full	Automatically migrated.
template components	❌ None	Not supported by the migration tool.
Camel Spring Boot	✅ Full	Automatically migrated.
camel-fury	✅ Full	Automatically migrated.

Full changelog

https://github.com/apache/camel-upgrade-recipes/compare/4.12.1..4.13.0

4.12.1

Summary

This is a release containing upgrade of OpenRewrite framework to 3.9.0.

Full changelog

https://github.com/apache/camel-upgrade-recipes/compare/4.12.0..4.12.1

4.12.0

Summary

This is a release supporting Camel and Camel Spring Boot 4.12.0 with the required upgrade recipes (described by the migration guide).

Migration coverage

The following table lists migration topics and indicates the level of coverage (full, partial, or not covered), along with additional comments.

Migration	Coverage	Comment
camel-core	✅ Full	Automatically migrated.
header filter strategy	❌ None	Not supported by the migration tool.
propagating variables in eips in seda kamelet components	❌ None	Not supported by the migration tool.
type converters	❌ None	Not supported by the migration tool.
java DSL	✅ Full	Automatically migrated.
rest DSL	✅ Full	Automatically migrated.
xml io DSL	❌ None	Not supported by the migration tool.
camel-as2	❌ None	Not supported by the migration tool.
camel-dsl-modeline	❌ None	Not supported by the migration tool.
camel_jackson / camel_jacksonxml	❌ None	Not supported by the migration tool.
camel-jbang	❌ None	Not supported by the migration tool.
camel-micrometer	❌ None	Not supported by the migration tool.
camel-main	❌ None	Not supported by the migration tool.
camel-observability-services	❌ None	Not supported by the migration tool.
camel-microprofile-fault-tolerance	❌ None	Not supported by the migration tool.
camel-smb	❌ None	Not supported by the migration tool.
component verifier extensions and metadata extension	❌ None	Not supported by the migration tool.
camel-spring-boot	❌ None	Not supported by the migration tool.
camel_langchain4j_tokenizer	❌ None	Not supported by the migration tool.

Full changelog

https://github.com/apache/camel-upgrade-recipes/compare/4.11.0..4.12.0

4.11.0

Summary

This is a release supporting Camel and Camel Spring Boot 4.11.0 with the required upgrade recipes (described by the migration guide).

Migration coverage

The following table lists migration topics and indicates the level of coverage (full or not covered), along with additional comments.

Migration	Coverage	Comment
EIPs	❌ None	Not supported by the migration tool.
camel-api	❌ None	Not supported by the migration tool.
camel-attachments	❌ None	Not supported by the migration tool.
camel-bean	❌ None	Not supported by the migration tool.
camel-main	✅ Full	Automatically migrated.
file based components	❌ None	Not supported by the migration tool.
camel-ftp	❌ None	Not supported by the migration tool.
camel-kafka	❌ None	Not supported by the migration tool.
camel-sql	❌ None	Not supported by the migration tool.
camel-platform-http	✅ Full	Automatically migrated.
camel-as2	❌ None	Not supported by the migration tool.
camel-jbang	❌ None	Not supported by the migration tool.
camel-etcd3	✅ Full	Automatically migrated.
camel-undertow	❌ None	Not supported by the migration tool.
camel-metrics	❌ None	Not supported by the migration tool.
camel-observability-services	❌ None	Not supported by the migration tool.

Full changelog

https://github.com/apache/camel-upgrade-recipes/compare/4.10.0..4.11.0

4.10.0

Summary

This is a release supporting Camel and Camel Spring Boot 4.10.0 with the required upgrade recipes (described by the migration guide).

Migration coverage

The following table lists migration topics and indicates the level of coverage (full or not covered), along with additional comments.

Migration	Coverage	Comment
XML DSL changes	✅ Full	Automatically migrated.
camel-kamelet	❌ None	Not supported by the migration tool.
camel-azure-files	❌ None	Not supported by the migration tool.
camel-aws2-s3	❌ None	Not supported by the migration tool.
camel-file	❌ None	Not supported by the migration tool.
camel-google-storage	❌ None	Not supported by the migration tool.
camel-jgroups	❌ None	Not supported by the migration tool.
camel-jbang	❌ None	Not supported by the migration tool.
camel-micrometer	❌ None	Not supported by the migration tool.
camel-mina	❌ None	Not supported by the migration tool.
camel-minio	❌ None	Not supported by the migration tool.
camel-google-pubsub-lite	❌ None	Not supported by the migration tool.
camel-tracing	❌ None	Not supported by the migration tool.
camel-langchain4j-chat	❌ None	Not supported by the migration tool.
camel-smb	❌ None	Not supported by the migration tool.
camel-solr	❌ None	Not supported by the migration tool.
camel-test-infra	❌ None	Not supported by the migration tool.
camel-spring-boot	✅ Full	Automatically migrated.

Full changelog

https://github.com/apache/camel-upgrade-recipes/compare/4.9.0..4.10.0

4.9.0

Upgrading Camel 4.8 to 4.9 (described by the guide)

Not all of the migrations could be covered by the openrewrite recipes. See the table for more details:

component	status	comment
camel-api	partial	Renamed Exchange.ACTIVE_SPAN to Exchange.OTEL_ACTIVE_SPAN. Renamed ExchangePropertyKey.ACTIVE_SPAN to ExchangePropertyKey.OTEL_ACTIVE_SPAN.
camel-management	N/A
Route Templates	N/A
camel-xml-io	N/A
camel-jackson	N/A
camel-jms	N/A
camel-opentelemetry	N/A
camel-pubnub	N/A
camel-smooks	N/A
camel-hashicorp-vault properties function	partial	Literal expressions matching (\{\{hashicorp:secret:[^/])/([^/]}}) are migrated.
camel-aws-secrets-manager properties function	partial	Literal expressions matching (\{\{aws:[^/])/([^/]}}) are migrated.
camel-google-secret-manager properties function	partial	Literal expressions matching (\{\{gcp:[^/])/([^/]}}) are migrated.
camel-azure-key-vault properties function	partial	Literal expressions matching (\{\{azure:[^/])/([^/]}}) are migrated.
camel-aws	N/A
camel-test	N/A
camel-debezium	covered
Deprecated components	N/A
Removed deprecated components	covered
Removed API	covered