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
Install OC-K8S
git clone https://cloud.o-forge.io/plm/oc-k8s.git
sudo cp oc-k8s.sh /usr/bin/oc-k8s
sudo chmod +x /usr/bin/oc-k8s
Install kind
Follow instructions here https://kind.sigs.k8s.io/
or
go install sigs.k8s.io/kind@v0.30.0 && kind create cluster
Install helm
Download suitable helm client here https://helm.sh/docs/intro/install/
Resume for a first start
oc-k8s start
or
./oc-k8s.sh start
To stop :
oc-k8s stop
or
./oc-k8s.sh start
Fire up a kind cluster
WARNING APACHE & NGINX ARE NOT RUNNING:
sudo /etc/init.d/apache2 stopsudo nginx -s stop
Execute following script to create a single node development k8s cluster
oc-k8s create cluster
or
./oc-k8s.sh create cluster
It will create a opencloud docker container running kubernetes services.
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:
oc-k8s build services [branch(default:mail)] [target(default:all)]
or
./oc-k8s.sh build services [branch(default:mail)] [target(default:all)]
Deploy the opencloud chart
oc-k8s create helm [env(default:dev)]
or
./oc-k8s.sh create helm [env(default:dev)]
Feel free to modify/create a new opencloud/dev-values.yaml. Provided setup should work out of the box, but is not suitable for production usage.
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
First steps
Go to http://beta.opencloud.com/users
Log in using default user/password combo ldapadmin/ldapadmin
Create a new user, or change the default one
Go to http://beta.opencloud.com
Log in using your fresh credentials
Do stuff
You can go to http://beta.opencloud.com/mongoexpress
... for mongo express web client access (default login/password is test/testme)
You can go to http://localhost/dashboard/
... for access to Traefik reverse proxy front-end