davsclaus opened a new issue, #3162:
URL: https://github.com/apache/camel-kamelets/issues/3162
The catalog has about 250 Kamelets. While documenting all of them (#3140 and
the batch PRs #3141–#3155), each one was run on Camel 4.23.0 and
4.24.0-SNAPSHOT, against a local stand-in service where one exists. Some do not
work on any version, some duplicate another Kamelet that can do the same with
an option, and some are demos. This is a proposal of which ones to deprecate,
merge or remove, to discuss per group.
Signals used: does not start or fails every message; depends on a service
that is gone or paid-only; duplicates another Kamelet; a demo with no
production use; no targeted change since it was created, and no test.
A possible mechanism: set `camel.apache.org/kamelet.support.level:
"Deprecated"` and add a line to the description pointing to the replacement in
one release, then remove the Kamelet in a later release, with an upgrade-guide
entry for both steps.
## 1. Remove (broken, and little reason to fix)
| Kamelet | Why |
|---|---|
| `twitter-directmessage-source`, `twitter-search-source`,
`twitter-timeline-source` | The Twitter/X API v1.1 endpoints they use are gone
or paid-only. On 4.23 every tweet fails (`LocalDateTime` not supported by
`marshal: json`); the required `user` option of the direct-message source is
ignored. No targeted change since creation, no test. |
| `chunk-template-action` | Has never loaded its template
(`chunk:?resourceUri=base64:{{template}}`, and `base64:` is not a resource
scheme): the body silently becomes `[chtml template '...' not found]`. Four
other template actions (mustache, velocity, freemarker, string-template) do the
same job. |
| `djl-image-to-text-action` | Fails on every image on 4.23 and 4.24
(`RasterFormatException`); Preview; downloads a model at runtime. |
| `aws-sts-assume-role-action` | Does not start since 6935281a4 (`Unknown
parameters useSessionCredentials`: aws2-sts has no such option). |
| `kafka-azure-schema-registry-sink`, `kafka-azure-schema-registry-source`,
`kafka-batch-azure-schema-registry-source` | Cannot start:
`#bean:defaultAzureCredential` is a literal, while the template's bean names
are made unique (`NoSuchBeanException`). Preview. Part of #3144. |
| `dropbox-source`, `dropbox-sink` | Do not start on 4.23 or 4.24 ("option
`expireIn` is not present"): the component now needs refresh-token options the
Kamelets do not have. Fix them only if someone uses them. |
## 2. Merge into another Kamelet with an option
| Kamelets | Into | Why |
|---|---|---|
| `kafka-*-not-secured-*`, `kafka-apicurio-registry-not-secured-*`,
`kafka-batch-apicurio-registry-*` | `kafka-source` / `kafka-sink` (+ a registry
option) | #3144. `saslAuthType: NONE` already covers "not secured"; the
variants are mismatched (JSON Schema vs Avro). |
| `http-secured-source`, `http-secured-sink` | `http-source`, `http-sink` |
The secured variants only add optional login options. |
| `jms-pooled-apache-artemis-source`, `jms-pooled-apache-artemis-sink` |
`jms-apache-artemis-*` | Pooling and username/password as options of one
Kamelet. |
| `ceph-source`, `ceph-sink`, `ceph-event-based-source` | `aws-s3-*` with
the endpoint override | Ceph is S3-compatible and the Ceph Kamelets already use
aws2-s3. The Ceph ones lack `forcePathStyle`, so `localhost` endpoints fail. |
| `aws-sqs-batch-sink`, `aws-sqs-fifo-sink`, `aws-sns-fifo-sink` |
`aws-sqs-sink`, `aws-sns-sink` | Batch and FIFO are options of the same
component. Lower priority. |
## 3. Demos (move to examples, or keep and label as demo)
| Kamelet | Why |
|---|---|
| `chuck-norris-source`, `wttrin-source`, `bitcoin-source` | Toy data
sources. `bitcoin-source` is a fixed Binance BTC/USDT ticker, not a Bitcoin
node, so the name misleads. |
| `earthquake-source` | Used by an itest and the developer guide: keep it as
the demo source, or move both. |
## 4. Fix or remove (low value as they are)
| Kamelet | Why |
|---|---|
| `kubernetes-pods-source`, `kubernetes-nodes-source`,
`kubernetes-namespaces-source` | No targeted change since creation;
`kubernetes-pods-source` ignores `resourceName` (the pods consumer needs a
namespace, and there is no namespace option). Niche. |
| `azure-storage-blob-changefeed-source` | Does not start on 4.24 (see
#3136); on 4.23 `marshal: json` cannot write `OffsetDateTime`, so real events
likely fail; re-reads the whole feed on every poll. |
| `elasticsearch-search-source`, `opensearch-search-source` | The output is
unusable: Gson marshals the Jackson `ObjectNode` result as `{"_children":...}`.
Fix the marshalling, or remove. |
| `cassandra-source` | The output is unusable: the driver's `Row` objects
are marshalled as `{"columnDefinitions":...,"formattedContents":"[...]"}`. Fix,
or remove. |
| `sap-netweaver-sink` | Named a sink, but it is a GET reader that never
sends the body. Rename to an action, or remove. |
| `google-functions-sink` | Uses the Cloud Functions "call" API, which is
meant for testing and is rate-limited. |
| `caffeine-action` | An in-memory cache with no expiry or size limit. |
Fixes already proposed instead of removal: `xj-template-action` and
`pdf-action` (#3158).
Related: #2890 (Kamelets on deprecated Camel components:
`json-patch-action`, `mqtt-*`, `splunk-*`) and #3144 (consolidate the Kafka
Kamelets).
Count: group 1 = 11 Kamelets, group 2 ≈ 20 merged into about 6, group 3 =
3–4, group 4 = 10 to decide.
_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]