diff --git a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_24.adoc b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_24.adoc index 010e3ece31ceb..17acafdd63fb5 100644 --- a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_24.adoc +++ b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_24.adoc @@ -9970,3 +9970,135 @@ an empty value counts as unset. The `region` option is no longer marked as required in the catalog, since `region` or `endpoint` is required and the `kmsClient` option replaces both. The producer still fails with "Region or endpoint is required" when it has to create a client and neither is set. + +=== Kamelets - removed Kamelets + +The Kamelet catalog (camel-kamelets 4.24) removes Kamelets that could not work on Camel 4.23 or 4.24: + +[cols="2,3",options="header"] +|=== +| Removed Kamelet | Use instead +| `twitter-directmessage-source`, `twitter-search-source`, `twitter-timeline-source` | Nothing: the Twitter/X v1.1 API they call is gone or paid-only +| `chunk-template-action` | `mustache-template-action`, `velocity-template-action`, `freemarker-template-action` or `string-template-action` +| `djl-image-to-text-action` | Nothing +| `aws-sts-assume-role-action` | Nothing +| `kafka-azure-schema-registry-sink`, `kafka-azure-schema-registry-source`, `kafka-batch-azure-schema-registry-source` | The schema registry options of the Kafka Kamelets +| `dropbox-source`, `dropbox-sink` | The `dropbox` component +|=== + +It also removes Kamelets that were little used and did not work well. Use the Camel component instead: + +* `kubernetes-pods-source`, `kubernetes-nodes-source`, `kubernetes-namespaces-source` +* `azure-storage-blob-changefeed-source` +* `elasticsearch-search-source`, `opensearch-search-source` +* `cassandra-source` +* `sap-netweaver-sink` +* `google-functions-sink` +* `caffeine-action` + +It removes the variants whose options the plain Kamelets now have: + +[cols="2,2,3",options="header"] +|=== +| Removed Kamelet | Use instead | What to change +| `http-secured-sink`, `http-secured-source` | `http-sink`, `http-source` | Only the name. The login options are the same +| `jms-pooled-apache-artemis-sink` | `jms-apache-artemis-sink` | Only the name. The plain sink now pools its connections, with the same pool options +| `jms-pooled-apache-artemis-source` | `jms-apache-artemis-source` | The name, and remove the three pool options +|=== + +The demo Kamelets `bitcoin-source`, `chuck-norris-source`, `earthquake-source` and `wttrin-source` are no longer in the +catalog. They are kept as examples in the `examples/kamelets` directory of the camel-kamelets repository. To run one, use +`camel run route.yaml --local-kamelet-dir=examples/kamelets`. + +The public `KameletPrefixSchemeEnum` of `camel-kamelets-catalog` loses the entries of these Kamelets: `dropbox`, the +`twitter_*` entries, `azure_storage_blob_changefeed`, `elasticsearch_search`, `google_functions`, the `kubernetes_*` +entries, `bitcoin`, `chuck_norris`, `wttrin` and `http_secured`. + +=== Kamelets - deprecated Kamelets + +These Kamelets still work, and will be removed in a later release: + +[cols="2,2,3",options="header"] +|=== +| Deprecated Kamelet | Use instead | What to change +| `kafka-apicurio-registry-not-secured-sink`, `kafka-apicurio-registry-not-secured-source`, +`kafka-batch-apicurio-registry-not-secured-source`, `kafka-batch-apicurio-registry-source`, +`kafka-not-secured-apicurio-registry-json-source`, `kafka-not-secured-apicurio-registry-sink`, +`kafka-not-secured-apicurio-registry-source` +| `kafka-source`, `kafka-sink` and `kafka-batch-source` | Use the schema registry options of the Kafka Kamelets +|=== + +=== Kamelets - renamed options + +These Kamelet options had the name of a parameter that the `kamelet:` component takes for itself. Given on a `kamelet:` +endpoint, they never reached the Kamelet: `location` was read as the place to load the Kamelet from, so the route failed +to start. Set as `camel.kamelet..