[camel-k] branch main updated: chore(doc): detailed builder runtime info

[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 a421a3c90 chore(doc): detailed builder runtime info
a421a3c90 is described below

commit a421a3c90143a80a5aa42b11acc029d7cc0c62d9
Author: Pasquale Congiusti <pa...@gmail.com>
AuthorDate: Mon Jul 17 14:44:35 2023 +0200

    chore(doc): detailed builder runtime info
---
 docs/modules/ROOT/pages/running/runtime-version.adoc | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/modules/ROOT/pages/running/runtime-version.adoc b/docs/modules/ROOT/pages/running/runtime-version.adoc
index 09e9120e1..89091427f 100644
--- a/docs/modules/ROOT/pages/running/runtime-version.adoc
+++ b/docs/modules/ROOT/pages/running/runtime-version.adoc
@@ -10,6 +10,12 @@ kamel run my-route.yaml -t camel.runtime-version=1.17.0
 
 Having the ability to choose the runtime, gives you the ability to specify which Camel version you want to run. Each Camel K Runtime is bound to a well defined version of Camel (see the compatibility matrix).
 
+== How does it work
+
+This feature requires the dynamic generation of a builder that contains all the tooling expected by the build phase. In particular, this is a requirement for Quarkus native builds which, from now on, can be only done with builder `Pod` strategy.
+
+When you are creating a new runtime for which a [CamelCatalog](/camel-k/next/architecture/cr/camel-catalog.html) does not yest exist, Camel K Operator is in charge to create such a catalog. The creation of a new Catalog binds to the creation of a container image builder which will later be used by the builder `Pod` to build a Camel application which is specific to such a runtime.
+
 == Pin a runtime version
 
 By default each Camel K version uses a specific runtime version, ie, Camel K 2.0 uses Camel K Runtime 2.16.0. Using the trait will let you pin to a well defined version, avoiding to unintentionally upgrade the runtime of the integrations running when you perform an operator upgrade. See more info in the xref:contributing/upgrade.adoc#maintain-runtime-integrations[Camel K upgrade documentation].