davsclaus opened a new issue, #3190:
URL: https://github.com/apache/camel-kamelets/issues/3190

   The Kamelet catalog has no upgrade guide of its own. The notes for users of 
the Kamelets 4.24 overhaul are collected here. Before Camel 4.24.0 is released, 
they go into the Camel upgrade guide (`camel-4x-upgrade-guide-4_24.adoc` in 
apache/camel) as a Kamelets section.
   
   Each PR that changes how a Kamelet behaves, or removes or deprecates one, 
adds its note here. The notes below cover what is merged as of 2026-11-18.
   
   ## Removed Kamelets
   
   **They could not work on Camel 4.23 or 4.24 (#3165).**
   
   | Kamelet | Use instead |
   |---|---|
   | `twitter-directmessage-source`, `twitter-search-source`, 
`twitter-timeline-source` | None. 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` | None |
   | `aws-sts-assume-role-action` | None |
   | `kafka-azure-schema-registry-sink`, `kafka-azure-schema-registry-source`, 
`kafka-batch-azure-schema-registry-source` | The schema registry options of the 
Kafka Kamelets (#3183) |
   | `dropbox-source`, `dropbox-sink` | The `dropbox` component |
   
   **They were little used and did not work well (#3166).** Use the Camel 
component directly 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`
   
   **The demo Kamelets left the catalog (#3167).** `bitcoin-source`, 
`chuck-norris-source`, `earthquake-source` and `wttrin-source` are in 
`examples/kamelets/` of the camel-kamelets repository, and no longer in the 
JAR. To run one: `camel run route.yaml --local-kamelet-dir=examples/kamelets`.
   
   **Java API.** `KameletPrefixSchemeEnum` loses the entries of the removed and 
moved Kamelets: `dropbox`, the `twitter_*` entries, 
`azure_storage_blob_changefeed`, `elasticsearch_search`, `google_functions`, 
the `kubernetes_*` entries, `bitcoin`, `chuck_norris` and `wttrin`.
   
   ## Deprecated Kamelets
   
   They still work, and will be removed in a later release.
   
   | Deprecated | Use instead | What to change |
   |---|---|---|
   | `http-secured-sink`, `http-secured-source` (#3168) | `http-sink`, 
`http-source` | Only the name. The login options are the same |
   | `jms-pooled-apache-artemis-sink` (#3169) | `jms-apache-artemis-sink` | 
Only the name. The plain sink now pools its connections, with the same options |
   | `jms-pooled-apache-artemis-source` (#3169) | `jms-apache-artemis-source` | 
The name, and drop the three pool options |
   | The seven Apicurio Registry Kafka Kamelets (#3184): 
`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`, 
`kafka-batch-source` with the schema registry options (#3183, to come) | |
   
   ## Changed behaviour
   
   ### Kafka
   
   - **`saslAuthType` is required (#3185)** on `kafka-sink`, 
`kafka-batch-source` and `ceph-event-based-source`, as it already was on 
`kafka-source`. Without it, the route fails at startup with `Route template 
kafka-sink the following mandatory parameters must be provided: saslAuthType`. 
To connect without security as before, set `saslAuthType: NONE`.
   
   ### Messaging
   
   - **The messaging sinks no longer wait for a reply (#3156).** This applies 
to `jms-apache-artemis-sink`, `jms-pooled-apache-artemis-sink`, 
`jms-amqp-10-sink`, `jms-ibm-mq-sink`, `spring-rabbitmq-sink` and `nats-sink`. 
A message that expects a reply, such as one from `webhook-source`, is now sent 
without one. The caller gets its own message back instead of the receiver's 
answer.
   - **`jms-apache-artemis-sink` pools its connections (#3169)**, so it opens 
one connection to the broker instead of one per message. It has new `username` 
and `password` options, as does the source.
   - **`nats-source` (#3156):** the body is `byte[]` instead of a stream, and 
the sender's `Content-Type` is kept instead of being forced to 
`application/json`.
   - **`mqtt-source` and `mqtt5-source` without `clientId` (#3156):** the 
broker now sees a generated client ID instead of `mqtt-source`. This matters 
only for broker ACLs or monitoring that use that ID.
   
   ### Data and search
   
   - **`solr-source` (#3158)** gives JSON text, with `Content-Type: 
application/json`, instead of a SolrJ object. A route that read fields of the 
object must read the JSON instead, for example with `jsonpath`.
   - **SQL and Cassandra Kamelets (#3157):** a query with `+` reaches the 
database unchanged. A query that worked around the old bug, for example with 
`%2B`, now sends a literal `%2B`.
   - **`google-sheets-source` with `majorDimension=COLUMNS` (#3157)** now reads 
columns.
   - **`redis-sink` (#3157):** a PUBLISH with no channel header goes to 
`channels` (default `one`). Before, it failed.
   
   ### Other Kamelets
   
   - **The GitHub sources (#3157)** poll every 60 seconds instead of every 500 
ms. Set `delay` to poll more often.
   - **The Jira sinks (#3157):** with an empty body and the 
`ce-issueDescription` header, the issue gets that description.
   - **`rest-openapi-sink` with `clientRequestValidation=true` (#3158)** now 
rejects an invalid request instead of sending it.
   - **`scp-sink` `knownHostsUri` (#3158)** takes a path or a `classpath:` 
resource. `file://` and `http(s)://` values, which never worked, are rejected.
   - **Options that are now required (#3158):**
     - `header-matches-filter-action` `headerName`, `jira-source` `jql`, 
`salesforce-create-sink` `sObjectName` and `fhir-sink` `apiName`. These 
Kamelets could not start without them anyway; the error is now clearer.
     - `aws-bedrock-agent-sink` without `dataSourceId` fails at startup instead 
of on every message.
   
   ## New options
   
   These change nothing when they are not set.
   
   - **#3168:** login options on `http-sink` and `http-source`.
   - **#3171:** `forcePathStyle` on the Ceph Kamelets.
   - **#3172:** `iteratorType` on `aws-kinesis-source`.
   - **#3173:** HTTPS on the Solr Kamelets.
   - **#3174:** STARTTLS on `mail-sink`.
   - **#3176, #3181:** `connectionProperties` on the PostgreSQL, MySQL, MariaDB 
and Redshift Kamelets.
   - **#3177:** login and TLS on the Redis Kamelets.
   - **#3178:** `move`, `moveFailed` and `idempotentRepository` on the FTP and 
SFTP sources.
   - **#3179:** durable subscription and selector on the JMS sources.
   
   ## To come
   
   - **#3117:** a default data type on each Kamelet, which changes the Java 
type of the body and sets `Content-Type`.
   - **#3183:** the schema registry options on the Kafka Kamelets.
   
   _Claude Code on behalf of Claus Ibsen_
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to