[camel-k] 01/02: Added installations steps to IBM Kubernetes Service(IKS)

[nf...@apache.org]

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

nferraro pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/camel-k.git

commit e5017a779f782468e30a5ea501fea704b1ea8bc1
Author: JuanJosePerez <ju...@geniussportsmedia.com>
AuthorDate: Sat Oct 3 21:52:12 2020 -0500

    Added installations steps to IBM Kubernetes Service(IKS)
---
 docs/modules/ROOT/pages/installation/iks.adoc      | 23 ++++++++++++++++++++
 .../ROOT/pages/installation/installation.adoc      |  1 +
 .../ROOT/pages/installation/registry/icr.adoc      | 25 ++++++++++++++++++++++
 3 files changed, 49 insertions(+)

diff --git a/docs/modules/ROOT/pages/installation/iks.adoc b/docs/modules/ROOT/pages/installation/iks.adoc
new file mode 100644
index 0000000..2b1d9ea
--- /dev/null
+++ b/docs/modules/ROOT/pages/installation/iks.adoc
@@ -0,0 +1,23 @@
+[[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
+
+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.
+
+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.
+
+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.
+
+After configure *kamel* CLI, you could start with the https://camel.apache.org/camel-k/latest/installation/installation.html#procedure[standard installation] or https://camel.apache.org/camel-k/latest/installation/installation.html#helm[installation via Helm].
+
+Finally you are ready to work with Camel K. 
diff --git a/docs/modules/ROOT/pages/installation/installation.adoc b/docs/modules/ROOT/pages/installation/installation.adoc
index e4416a3..4b22499 100644
--- a/docs/modules/ROOT/pages/installation/installation.adoc
+++ b/docs/modules/ROOT/pages/installation/installation.adoc
@@ -15,6 +15,7 @@ before installing it. Customized instructions are needed for the following clust
 - xref:installation/crc.adoc[Red Hat CodeReady Containers (CRC)]
 - xref:installation/gke.adoc[Google Kubernetes Engine (GKE)]
 - xref:installation/openshift.adoc[OpenShift]
+- xref:installation/iks.adoc[IBM Kubernetes Services (IKS)]
 
 Other cluster types (such as OpenShift clusters) should *not need* prior configuration.
 
diff --git a/docs/modules/ROOT/pages/installation/registry/icr.adoc b/docs/modules/ROOT/pages/installation/registry/icr.adoc
new file mode 100644
index 0000000..967124b
--- /dev/null
+++ b/docs/modules/ROOT/pages/installation/registry/icr.adoc
@@ -0,0 +1,25 @@
+[[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.
+
+In order to push images to `gcr.io`, you need to provide a valid key to Camel K.
+
+The fast way to obtain create 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]:
+    ```
+    ibmcloud plugin install container-registry -r 'IBM Cloud'
+    ```
+- Log in to your IBM Cloud account.
+    ```
+    ibmcloud login -a https://cloud.ibm.com
+    ```
+- Ensure that you're targeting the correct IBM Cloud Container Registry region.
+    ```
+    ibmcloud cr region-set us-south
+    ```
+- Choose a name for your namespace, and create that namespace.
+    ```
+    ibmcloud cr namespace-add <my_namespace>
+    ```
\ No newline at end of file