oc-k8s/README.md

This package defines an Helm chart for kubernetes based opencloud services deployment.

It can be used to fully deploy opencloud in a development/lighweight kubernetes deployment, for quick testing
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.

# Locally built microservices deployment procedure

## Clone the repository

```
git clone https://cloud.o-forge.io/plm/oc-k8s.git
```

## Install kind

Follow instructions here https://kind.sigs.k8s.io/

## Install helm

Download suitable helm client here https://helm.sh/docs/intro/install/

## Fire up a kind cluster

Execute following script to create a single node development k8s cluster

```
create_kind_cluster.sh
```

It will create a *opencloud* docker container running kubernetes services.

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