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 <pasquale.congiu...@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].
