(camel-k) 04/04: feat(doc): Kustomize installation procedure

[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

commit e6fcd0ffb1abc10cdfb414b2c4c33aace538c754
Author: Gaelle Fournier <ga...@gmail.com>
AuthorDate: Tue Dec 12 15:38:58 2023 +0100

    feat(doc): Kustomize installation procedure
---
 .../ROOT/pages/installation/installation.adoc      | 40 ++++++++++++++++++++--
 1 file changed, 38 insertions(+), 2 deletions(-)

diff --git a/docs/modules/ROOT/pages/installation/installation.adoc b/docs/modules/ROOT/pages/installation/installation.adoc
index 605dd6ff6..f0b40a294 100644
--- a/docs/modules/ROOT/pages/installation/installation.adoc
+++ b/docs/modules/ROOT/pages/installation/installation.adoc
@@ -29,6 +29,8 @@ For CRC, this means executing `oc login -u system:admin` then `kamel install --c
 
 Camel K can be installed using https://kustomize.io[Kustomize], providing an interface for configuring more advanced features.
 
+**First you need to get the kustomize files**
+
 ```
 # Clone the project repository
 $ https://github.com/apache/camel-k.git
@@ -36,13 +38,47 @@ $ cd camel-k
 # You can use any release branch or skip this step to use it the last code on `main`
 $ git checkout release-a.b.x
 $ cd install
-$ kubectl apply -k setup-cluster
+```
+
+**Next you need to apply configuration at cluster level**
+
+```
+$ kubectl kustomize --load-restrictor LoadRestrictionsNone setup-cluster/ | kubectl create -f -
+```
+
+**Then the roles and privileges needs to be added**
+
+```
 $ kubectl apply -k setup
+$ kubectl apply -k config/rbac/namespaced
+# For openshift
+$ kubectl apply -k config/rbac/openshift
+$ kubectl apply -k config/rbac/openshift/namespaced
+```
+
+Should you want your operator operator to watch all namespaces (global operator), you will replace `config/rbac/namespaced` by `config/rbac/descoped` and `config/rbac/openshift/namespaced` by `config/rbac/openshift/descoped`.
+
+**Finally the operator can be deployed**
+
+```
 $ kubectl apply -k operator
 $ kubectl apply -k platform
 ```
 
-NOTE: you probably want to edit the configuration. Please, do any change right after cloning the repository.
+By default the operator is configured to get the registry information from a Configmap expected the namespace `kube-public` like this example:
+
+```
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: local-registry-hosting
+  namespace: kube-public
+data:
+  localRegistryHosting.v1: |
+    hostFromContainerRuntime: "registry:5000"
+```
+
+NOTE: you probably want to edit the configuration. Please, do any change right after cloning the repository. Be careful to avoid making any modification in the `install/config` folder.
 
 More information on the xref:installation/advanced/kustomize.adoc[Kustomize Camel K installation procedure] page.