[camel-k] branch main updated: doc(dependencies): note on dynamic URIs

[pc...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

pcongiusti pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/camel-k.git


The following commit(s) were added to refs/heads/main by this push:
     new 590f0a1  doc(dependencies): note on dynamic URIs
590f0a1 is described below

commit 590f0a107f0637d4f9d547f99e1bdaf82c70689e
Author: Pasquale Congiusti <pa...@gmail.com>
AuthorDate: Thu Aug 26 18:19:07 2021 +0200

    doc(dependencies): note on dynamic URIs
    
    Closes #2085
---
 .../ROOT/pages/configuration/dependencies.adoc     | 26 ++++++++++++++++++++--
 1 file changed, 24 insertions(+), 2 deletions(-)

diff --git a/docs/modules/ROOT/pages/configuration/dependencies.adoc b/docs/modules/ROOT/pages/configuration/dependencies.adoc
index fa6d49c..e565a8a 100644
--- a/docs/modules/ROOT/pages/configuration/dependencies.adoc
+++ b/docs/modules/ROOT/pages/configuration/dependencies.adoc
@@ -15,10 +15,32 @@ This dependency resolution mechanism is transparent to the user, that will just
 
 Automatic resolution is also a nice feature in xref:running/dev-mode.adoc[dev mode], because you are allowed to add all components you need *without exiting the dev loop*.
 
-You can explicitly add dependency explicitly using the `-d` flag. This is useful when you need to use dependencies that are not included in the Camel catalog. For example:
+NOTE: Camel K won't be able to automatically the dependencies when your routes specify dynamic URIs.
+
+[[dependencies-explicit]]
+== Add explicit dependencies
+
+You can explicitly add dependency using the `-d` flag of the `kamel run` command. This is useful when you need to use dependencies that are not included in the Camel catalog or when the URI of your routes cannot be automatically discovered (see Dynamic URIs). For example:
 
 ```
 kamel run -d mvn:com.google.guava:guava:26.0-jre -d camel-mina2 Integration.java
 ```
 
-This feature can also be disabled if needed (although we discourage you from doing it) by disabling the _dependencies_ trait (`-t dependencies.enabled=false`).
+With that command you will add a dependency of Guava and the Camel Mina component. This feature can also be disabled if needed (although we discourage you from doing it) by disabling the _dependencies_ trait (`-t dependencies.enabled=false`).
+
+[[dependencies-dynamic]]
+== Dynamic URIs
+
+Unfortunately, Camel K won't be able to always discover all your dependencies. When you are creating an URI dynamically, then you will also need to instruct Camel K on which is the expected component to load (via `-d` parameter). An example is illustrated in the following code snippet:
+
+[source,java]
+.DynamicURI.java
+----
+...
+String myTopic = "purchases"
+from("kafka:" + myTopic + "? ... ")
+    .to(...)
+...
+----
+
+Here the `from` URI is dynamically created from some variables that will be resolved at runtime. In cases like this, you will need to specify the component and the related dependency to be loaded in the `Integration`.
\ No newline at end of file