[camel-k] branch main updated: doc(kamelets): custom repository

[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 b14c50d  doc(kamelets): custom repository
b14c50d is described below

commit b14c50d04687882458c00146f70590ddf5b31fcf
Author: Pasquale Congiusti <pa...@gmail.com>
AuthorDate: Wed Jan 5 15:46:00 2022 +0100

    doc(kamelets): custom repository
    
    Closes #2765
---
 .../modules/ROOT/pages/kamelets/kamelets-user.adoc | 29 ++++++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/docs/modules/ROOT/pages/kamelets/kamelets-user.adoc b/docs/modules/ROOT/pages/kamelets/kamelets-user.adoc
index 351957c..c8b5689 100644
--- a/docs/modules/ROOT/pages/kamelets/kamelets-user.adoc
+++ b/docs/modules/ROOT/pages/kamelets/kamelets-user.adoc
@@ -239,6 +239,35 @@ from('timer:tick')
 You can run this integration without specifying other parameters, the Kamelet endpoint will be implicitly configured by the Camel K operator that will
 automatically mount the secret into the integration Pod.
 
+[[kamelets-default-catalog]]
+== Kamelets Catalog
+
+When you install a Camel K Operator, you will have automatically a wide set of canned Kamelets available to be used. The catalog and the related documentation is available at link:/camel-kamelets/next/index.html[Apache Kamelets Catalog]. There is a CLI command very useful to have a quick list of the available Kamelets:
+[source,shell]
+----
+$ kamel kamelet get
+----
+
+These Kamelets are installed by default when you install Camel K operator. You will be able to use them without worrying to install each of them, just look at the documentation and be ready to experiment how easy they are.
+
+[[kamelets-custom-catalog]]
+=== Use a custom Catalog
+
+You can overwrite the default catalog by adding certain configuration to the `IntegrationPlatform`. In order to add a new repository, you must edit the `IntegrationPlatfom` and edit the `.spec.kamelet.repositories[].uri` field, which expects an array of repository URIs where you can host your catalog of Kamelets, ie: 
+[source,yaml]
+----
+spec:
+  ...
+  kamelet:
+    repositories:
+    - uri: github:my-org/my-repo
+  ...
+----
+
+By default the value is null, which means they fallback to the Apache Kamelets Catalog.
+
+NOTE: this option is experimental and may be subjected to changes in future versions.
+
 [[kamelets-usage-binding]]
 == Binding Kamelets