Updating doc, and deployment procedure

README.md

@@ -6,19 +6,25 @@ or to ease opencloud dependencies (dex, mongo, mongo-express, ...) deployment.
 Kind (https://kind.sigs.k8s.io/) is used here as a lightweight kubernetes deployment. Obviously, any kubenetes compliant 
 environment is a legitimate target.
 
-HOW TO:
+# Locally built microservices deployment procedure
 
-1. Install kind
+## Clone the repository
+
+```
+git clone https://cloud.o-forge.io/plm/oc-k8s.git
+```
+
+## Install kind
 
 Follow instructions here https://kind.sigs.k8s.io/
 
-2. Install helm
+## Install helm
 
 Download suitable helm client here https://helm.sh/docs/intro/install/
 
-3. Fire up a kind cluster
+## Fire up a kind cluster
 
-Execute following script
+Execute following script to create a single node development k8s cluster
 
 ```
 create_kind_cluster.sh
@@ -26,8 +32,42 @@ create_kind_cluster.sh
 
 It will create a *opencloud* docker container running kubernetes services.
 
-4. Deploy the opencloud chart
+## Clone all the microservices repositories taking part of the opencloud environment
+
+Execute following script to clone all the needed parts:
+
+```
+clone_opencloud_microservices.sh
+```
+
+## Build everything
+
+You need to build and publish all the opencloud microservices images in the kind cluster before deploying the Helm package.
+
+Proceed as following:
+
+```
+build_opencloud_microservices.sh
+```
+
+## Deploy the opencloud chart
 
 ```
 install_development.sh
 ```
+
+## Hostname settings
+
+Edit your /etc/hosts file, and add following line:
+
+```
+127.0.0.1 beta.opencloud.com
+```
+
+## Done
+
+Everything should be operational now, go to http://beta.opencloud.com and enjoy the ride
+
+# Prebuilt microservices deployment procedure
+
+TODO