Kubernetes - openmrs/openmrs-contrib-itsmresources GitHub Wiki

Kubernetes is deployed with OpenStack Magnum.

The cluster can be set up / updated from https://github.com/openmrs/openmrs-contrib-itsm-terraform with:

./build.rb plan kubernetes
./build.rb apply kubernetes

OpenStack Magnum will automatically provision Kubernetes control plane and worker nodes.

The Kubernetes dashboard is configured to be accessible at https://k8s.openmrs.org/. You can get token credentials by running:

./build.rb terraform kubernetes 'output --raw kubernetes_dashboard_token'

The terraform outputs kubernetes/kubeconfig as well, if you want to use kubectl.

The cluster is configured with the nginx ingress controller behind an OpenStack Load Balancer. Use the nginx ingress class name.

There is also cert-manager deployed to create and renew SSL certificates for nginx ingress via letsencrypt. Add the cert-manager.io/cluster-issuer: letsencrypt annotation on your ingress to have SSL certificate.

The cluster has the following storage classes:

• default for Cinder attached volumes
• local-path for local storage volumes

Please note that local storage is limited to worker node disk size (60GB for m3.medium), but it has the best performance.

The O3 k8s deployment is at https://o3-k8s.openmrs.org/. It is the most robust deployment with MariaDB Galera, ElasticSearch, Minio and fully replicated OpenMRS backend and frontend services.