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
+----