simplify k8s

Author: mmouly

decisioncenter/businessvalueeditor/README-KUBERNETES.md

@@ -7,38 +7,59 @@ Before following the steps below, make sure you have built the images as explain
 
 ## 1. Uploading ZIP file on a file server
 
-The customization ZIP file can be made available to Decision Center in two ways:
-1. the **legacy way**: by copying the JARs to a PVC and referencing this PVC using the parameter `decisionCenter.customlibPvc`
-1. or the **new way** (since 9.0 only): by copying the JARs on a file server and referencing the files to download from this file server using the parameter `decisionCenter.downloadUrl`
+Any file server reachable by Decision Center is suitable. 
 
-This document explains how to follow the **new way**. Any file server reachable by Decision Center is suitable. You can either use an existing one or follow the instructions [here](https://github.com/DecisionsDev/odm-docker-kubernetes/blob/vnext-release/contrib/file-server/README.md#setup-an-httpd-file-server) to deploy a httpd file server in a new pod.
+You can either use an existing one or follow the instructions [here](https://github.com/DecisionsDev/odm-docker-kubernetes/blob/vnext-release/contrib/file-server/README.md#setup-an-httpd-file-server) to deploy a httpd file server in a new pod.
 
-However you must use the **legacy way** if you deploy a version of ODM older than 9.0. Here are some [instructions](https://www.ibm.com/docs/en/odm/9.0.0?topic=kubernetes-customizing-decision-center-business-console) in the documentation.
-
-Upload the businessvalueeditor-1.0.zip file on the file server :
+Upload the **businessvalueeditor-1.0.zip** file on the file server :
 ```
 curl -T businessvalueeditor/businessvalueeditor-source/target/businessvalueeditor-1.0.zip $FILESERVER_URL
 ```
 
 ## 2. Deploying ODM
 
-Add the public IBM Helm charts repository:
+To get access to the ODM material, you must have an IBM entitlement key to pull the images from the IBM Cloud Container registry.
 
-```
-helm repo add ibmcharts https://raw.githubusercontent.com/IBM/charts/master/repo/ibm-helm
-helm repo update
-````
+This is what will be used in the next step of this tutorial.
 
-Check that you can access the ODM charts:
+#### a. Retrieve your entitled registry key
 
+- Log in to [MyIBM Container Software Library](https://myibm.ibm.com/products-services/containerlibrary) with the IBMid and password that are associated with the entitled software.
+
+- In the **Container Software and Entitlement Keys** tile, verify your entitlement on the **View library page**, and then go to *Entitlement keys* to retrieve the key.
+
+#### b. Create a pull secret by running the kubectl create secret command
+
+```bash
+oc create secret docker-registry my-odm-docker-registry --docker-server=cp.icr.io \
+    --docker-username=cp --docker-password="<ENTITLEMENT_KEY>" --docker-email=<USER_EMAIL>
 ```
-helm search repo ibm-odm-prod
-```
 
+Where:
+
+- `<ENTITLEMENT_KEY>`: The entitlement key from the previous step. Make sure to enclose the key in double quotes.
+- `<USER_EMAIL>`: The email address associated with your IBMid.
+
+> **Note**
+> The `cp.icr.io` value for the docker-server parameter is the only registry domain name that contains the images. You must set the docker-username to `cp` to use the entitlement key as the docker-password.
+
+The my-odm-docker-registry secret name is already used for the `image.pullSecrets` parameter when you run a Helm install of your containers. The `image.repository` parameter is also set by default to `cp.icr.io/cp/cp4a/odm`.
+
+#### c. Add the public IBM Helm charts repository
+
+```bash
+helm repo add ibm-helm https://raw.githubusercontent.com/IBM/charts/master/repo/ibm-helm
+helm repo update
 ```
-NAME                        	CHART VERSION	APP VERSION	DESCRIPTION
-ibmcharts/ibm-odm-prod      	<version>     <version>  	IBM Operational Decision Manager  License By in...
+
+#### d. Check your access to the ODM chart
+
+```bash
+$ helm search repo ibm-odm-prod
+NAME                    CHART VERSION APP VERSION DESCRIPTION
+ibm-helm/ibm-odm-prod   24.0.0        9.0.0.0     IBM Operational Decision Manager
 ```
+#### e. Install an IBM Operational Decision Manager release
 
 Create a file named **values.yaml**. This file will be used by the **helm install** command to specify the configuration parameters. 
 
@@ -51,6 +72,8 @@ decisionCenter:
 
 Add all the other parameters suitable to your platform in `values.yaml`. Check this [link](https://github.com/DecisionsDev/odm-docker-kubernetes/tree/master/platform) for help.
 
+If you are on OCP, you can use this [values.yaml](./businessvalueeditor-source/values.yaml) file by replacing `<FILESERVER_URL>` by the actual URL of the file server hosting the JARs.
+
 ```bash
 helm install businessvalueeditor-sample ibmcharts/ibm-odm-prod -f values.yaml
 ```