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]