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]

Reply via email to