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

tsato 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 7bbf80e8 doc: add more details about installation on IKS/ICR
7bbf80e8 is described below

commit 7bbf80e87966ec19448c24fb7492c2694b69f342
Author: Tadayoshi Sato <[email protected]>
AuthorDate: Tue Jan 18 15:10:34 2022 +0900

    doc: add more details about installation on IKS/ICR
---
 .../ROOT/pages/installation/platform/iks.adoc      | 11 ++++---
 .../ROOT/pages/installation/registry/icr.adoc      | 37 +++++++++++++++++++---
 2 files changed, 40 insertions(+), 8 deletions(-)

diff --git a/docs/modules/ROOT/pages/installation/platform/iks.adoc 
b/docs/modules/ROOT/pages/installation/platform/iks.adoc
index 9a1ede7..67585f5 100644
--- a/docs/modules/ROOT/pages/installation/platform/iks.adoc
+++ b/docs/modules/ROOT/pages/installation/platform/iks.adoc
@@ -1,19 +1,22 @@
 [[installation-on-iks]]
 = Installing Camel K on IBM Kubernetes Service (IKS)
 
-This guide assumes you've already created an IBM Kubernetes cluster on 
https://cloud.ibm.com, also installed the 
https://cloud.ibm.com/docs/cli?topic=cli-install-ibmcloud-cli[IBM Command line 
tool] and kubectl command
+This guide assumes you've already created an IBM Kubernetes cluster on 
https://cloud.ibm.com, also installed the 
https://cloud.ibm.com/docs/cli?topic=cli-install-ibmcloud-cli[IBM Command line 
tool] and `kubectl` command.
 
-On the list of kubernetes clusters for you account, you need to select the 
cluster and copy the (_clusterId_) to add the cluster `ibmcloud ks cluster 
config --cluster <clusterid>`
+On the list of kubernetes clusters for you account, you need to select the 
cluster and copy the (_clusterId_) to add the cluster: `ibmcloud ks cluster 
config --cluster <clusterid>`
 
 After executing the configuration string, you should be able to execute:
 
 ```
 kubectl get pods --all-namespaces
 ```
-NOTE: IKS provide an internal container registry feature. Camel K is able to 
leverage that registry.
+[NOTE]
+====
+IKS provide an internal container registry feature. Camel K is able to 
leverage that registry.
 
 You could create a customized namespace on 
xref:installation/registry/icr.adoc[IBM container registry] in order to host 
your integration images.
-please take note of the namespace and region created to configure them on the 
installation step.
+Please take note of the namespace and region created to configure them on the 
installation step.
+====
 
 You can now download *kamel* CLI tool the from 
https://github.com/apache/camel-k/releases[release page]
 and put it on your system path.
diff --git a/docs/modules/ROOT/pages/installation/registry/icr.adoc 
b/docs/modules/ROOT/pages/installation/registry/icr.adoc
index 5b2857e..16532f3 100644
--- a/docs/modules/ROOT/pages/installation/registry/icr.adoc
+++ b/docs/modules/ROOT/pages/installation/registry/icr.adoc
@@ -1,11 +1,14 @@
 [[configuring-container-registry]]
 = Configuring a Namespace on IBM Container Registry (ICR)
 
-You can use a Namespace of IBM Container Registry to host Camel K images.
+You can use a namespace of IBM Container Registry to host Camel K images.
 
-In order to push images to `icr.io`, you need to provide a valid key to Camel 
K.
+In order to push images to `icr.io`, you need to provide valid credentials 
(secret) to Camel K.
 
-The fast way to obtain a Namespace on ICR is by 
https://cloud.ibm.com/docs/cli?topic=cli-install-ibmcloud-cli[IBM Command line 
tool]:
+[[creating-namespace]]
+== Creating a Namespace
+
+The fast way to obtain a namespace on ICR is by 
https://cloud.ibm.com/docs/cli?topic=cli-install-ibmcloud-cli[IBM Command line 
tool]:
 
 - Install https://cloud.ibm.com/docs/cli?topic=cli-install-ibmcloud-cli[IBM 
Command line tool]:
 +
@@ -13,7 +16,7 @@ The fast way to obtain a Namespace on ICR is by 
https://cloud.ibm.com/docs/cli?t
 ----
 $ ibmcloud plugin install container-registry -r 'IBM Cloud'
 ----
-- Log in to your IBM Cloud account.
+- Log in to your IBM Cloud account:
 +
 [source,console]
 ----
@@ -31,3 +34,29 @@ $ ibmcloud cr region-set us-south
 ----
 $ ibmcloud cr namespace-add <my_namespace>
 ----
+
+[[providing-registry-secret]]
+== Providing Registry Secret
+
+Once you have a registry namespace, create a secret with the credentials in 
order for Camel K to access it.
+
+Firstly, make sure to log in to ICR so that the local Docker config file has 
the credentials for it:
+
+[source,console]
+----
+$ ibmcloud cr login
+----
+
+Then create a secret with the Docker config file `$HOME/.docker/config.json` 
(or in case of Podman, `$XDG_RUNTIME_DIR/containers/auth.json`):
+
+[source,console]
+----
+$ kubectl create secret generic my-icr-secret 
--from-file=.dockerconfigjson=$HOME/.docker/config.json 
--type=kubernetes.io/dockerconfigjson
+----
+
+Now you can proceed to install Camel K with the following command:
+
+[source,console]
+----
+$ kamel install --registry <region>.icr.io --organization <my_namespace> 
--registry-secret my-icr-secret
+----

Reply via email to