This is an automated email from the ASF dual-hosted git repository.
davsclaus pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/camel.git
The following commit(s) were added to refs/heads/main by this push:
new 1ccbb406643a chore: fix documentation errors in CLI devtools,
managing, kubernetes, MCP, and container pages
1ccbb406643a is described below
commit 1ccbb406643a58bd82f8deda5b93540cd2408920
Author: Claus Ibsen <[email protected]>
AuthorDate: Fri Jul 10 18:50:31 2026 +0200
chore: fix documentation errors in CLI devtools, managing, kubernetes, MCP,
and container pages
Co-Authored-By: Claude Opus 4.6 <[email protected]>
Signed-off-by: Claus Ibsen <[email protected]>
---
.../modules/ROOT/pages/camel-jbang-container.adoc | 7 +++----
.../modules/ROOT/pages/camel-jbang-devtools.adoc | 6 +++---
.../modules/ROOT/pages/camel-jbang-kubernetes.adoc | 9 +++------
.../modules/ROOT/pages/camel-jbang-managing.adoc | 2 +-
.../modules/ROOT/pages/camel-jbang-mcp.adoc | 19 +++++++++++++++++++
.../core/commands/kubernetes/KubernetesExport.java | 4 ++--
6 files changed, 31 insertions(+), 16 deletions(-)
diff --git a/docs/user-manual/modules/ROOT/pages/camel-jbang-container.adoc
b/docs/user-manual/modules/ROOT/pages/camel-jbang-container.adoc
index 7ed3e3fdd9b8..b9c137892f31 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-jbang-container.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-jbang-container.adoc
@@ -8,10 +8,9 @@ The simplest command you can check is the `camel version`
which can be run on th
[source,bash]
----
-$ docker run apache/camel-jbang:4.18.2 version
+$ docker run apache/camel-jbang:4.22.0 version
-JBang version: 0.137.0
-Camel JBang version: 4.18.2
+Camel CLI version: 4.22.0
----
== Running a route
@@ -20,7 +19,7 @@ You can mount a Camel route file from your host machine into
the container and r
[source,bash]
----
-$ docker run -w /home/ubuntu -v $PWD/test.yaml:/tmp/test.yaml
apache/camel-jbang:4.18.2 run /tmp/test.yaml --runtime quarkus
+$ docker run -w /home/ubuntu -v $PWD/test.yaml:/tmp/test.yaml
apache/camel-jbang:4.22.0 run /tmp/test.yaml --runtime quarkus
...
2026-06-15 12:21:13,597 INFO
[org.apache.camel.quarkus.core.CamelBootstrapRecorder] (main) Apache Camel
Quarkus 3.31.0 is starting
diff --git a/docs/user-manual/modules/ROOT/pages/camel-jbang-devtools.adoc
b/docs/user-manual/modules/ROOT/pages/camel-jbang-devtools.adoc
index a2d9f4a4bc08..d8f1bda0b31c 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-jbang-devtools.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-jbang-devtools.adoc
@@ -35,7 +35,7 @@ Send a message to the running integration named `mqtt` (the
payload is loaded fr
[source,bash]
----
-$ camel cmd send mqtt --body=file:payload.json mqtt
+$ camel cmd send --body=file:payload.json mqtt
----
The last argument (`mqtt`) is the integration name — you can also use its PID.
@@ -231,7 +231,7 @@ HELLO
WORLD
----
-Enable logging with `--logging=true` (writes to `.camel-jbang/camel-pipe.log`).
+Enable logging with `--logging=true` (writes to `~/.camel/camel-script.log`).
=== Using stream:in with line vs. raw mode
@@ -402,7 +402,7 @@ logging.level.com.zaxxer.hikari = DEBUG
*Available since Camel 4.18*
-The validate plugin checks whether Camel source files (YAML, XML) are valid.
+The validate plugin checks whether Camel YAML source files are valid.
[source,bash]
----
diff --git a/docs/user-manual/modules/ROOT/pages/camel-jbang-kubernetes.adoc
b/docs/user-manual/modules/ROOT/pages/camel-jbang-kubernetes.adoc
index fb01a58b061b..560c3593992b 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-jbang-kubernetes.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-jbang-kubernetes.adoc
@@ -60,10 +60,10 @@ The export command provides several options to customize
the project:
|Add an OpenAPI spec (syntax: [configmap,file]:name).
|--env
-|Set an environment variable in the integration container, for instance "-e
MY_VAR=my-value".
+|Set an environment variable in the integration container, for instance "--env
MY_VAR=my-value".
|--volume
-|Mount a volume into the integration container, for instance "-v
pvcname:/container/path".
+|Mount a volume into the integration container, for instance "--volume
pvcname:/container/path".
|--connect
|A Service that the integration should bind to, specified as
[[apigroup/]version:]kind:[namespace/]name.
@@ -236,7 +236,7 @@ camel kubernetes export Sample.java
--trait=cronjob.enabled=true --trait=cronjob
=== Labels and annotations
-By default, resources have the label `camel.apache.org/integration` set to the
project name.
+By default, resources have the label `app.kubernetes.io/name` set to the
project name.
Add custom labels and annotations:
[source,bash]
@@ -722,11 +722,8 @@ Remove a deployment and all its resources:
[source,bash]
----
camel kubernetes delete --name=route
-camel kubernetes delete --name=route --cluster-type=openshift
----
-NOTE: If you used `--cluster-type` during export/run, you must specify it for
delete as well.
-
== Minikube deployment tips
Quick start for local development with Minikube (Camel 4.10+):
diff --git a/docs/user-manual/modules/ROOT/pages/camel-jbang-managing.adoc
b/docs/user-manual/modules/ROOT/pages/camel-jbang-managing.adoc
index e1dc5da91ae3..82de1651af4a 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-jbang-managing.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-jbang-managing.adoc
@@ -393,7 +393,7 @@ camel cmd logger
camel cmd logger --logging-level=DEBUG foo
----
-TIP: Use `--all` to change levels for all running integrations.
+TIP: Omit the integration name to change levels for all running integrations.
=== Per-category logging
diff --git a/docs/user-manual/modules/ROOT/pages/camel-jbang-mcp.adoc
b/docs/user-manual/modules/ROOT/pages/camel-jbang-mcp.adoc
index 613624b8afe7..d1d4c49d72af 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-jbang-mcp.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-jbang-mcp.adoc
@@ -574,6 +574,15 @@ process is running).
| `camel_runtime_memory`
| Show JVM memory usage (heap/non-heap), garbage collection stats, and thread
counts.
+| `camel_runtime_heap_histogram`
+| Get a class-level heap histogram showing instance counts and byte usage per
class.
+ Useful for diagnosing memory leaks and understanding which classes dominate
heap usage.
+
+| `camel_runtime_memory_leak`
+| Diagnose memory leaks in a running Camel integration using Java Flight
Recorder (JFR).
+ Use command 'start' to begin recording, 'stop' to get results, 'status' to
check state,
+ and 'query' to retrieve cached results. Supports dual-recording mode for
trend comparison.
+
| `camel_runtime_errors`
| Get captured routing errors from the running application. Returns error
details including exception,
exchange context, and route information.
@@ -664,4 +673,14 @@ instructions and executes each step by calling the
referenced tools.
for security-sensitive components and vulnerabilities, understand the route
structure and data flow, and
produce an actionable audit checklist organized into critical issues,
warnings, positive findings,
recommendations, and compliance notes.
+
+| `camel_diagnose_route`
+| `routeId` (optional), `symptom` (optional)
+| Guided workflow to diagnose issues with a running Camel route: gather
runtime state, errors, health,
+ message history, and produce a root cause analysis with actionable fixes.
+
+| `camel_optimize_route`
+| `routeId` (optional), `goal` (optional)
+| Guided workflow to optimize a Camel application's performance: analyze
throughput, identify bottlenecks,
+ review resource usage, and produce prioritized optimization recommendations.
|===
diff --git
a/dsl/camel-jbang/camel-jbang-plugin-kubernetes/src/main/java/org/apache/camel/dsl/jbang/core/commands/kubernetes/KubernetesExport.java
b/dsl/camel-jbang/camel-jbang-plugin-kubernetes/src/main/java/org/apache/camel/dsl/jbang/core/commands/kubernetes/KubernetesExport.java
index 9f0a084a1fd3..c192ca8d92a7 100644
---
a/dsl/camel-jbang/camel-jbang-plugin-kubernetes/src/main/java/org/apache/camel/dsl/jbang/core/commands/kubernetes/KubernetesExport.java
+++
b/dsl/camel-jbang/camel-jbang-plugin-kubernetes/src/main/java/org/apache/camel/dsl/jbang/core/commands/kubernetes/KubernetesExport.java
@@ -76,11 +76,11 @@ public class KubernetesExport extends Export {
protected String[] resources;
@CommandLine.Option(names = { "--env" },
- description = "Set an environment variable in the
integration container, for instance \"-e MY_VAR=my-value\".")
+ description = "Set an environment variable in the
integration container, for instance \"--env MY_VAR=my-value\".")
protected String[] envVars;
@CommandLine.Option(names = { "--volume" },
- description = "Mount a volume into the integration
container, for instance \"-v pvcname:/container/path\".")
+ description = "Mount a volume into the integration
container, for instance \"--volume pvcname:/container/path\".")
protected String[] volumes;
@CommandLine.Option(names = { "--connect" },
