Deploy on Kubernetes

We use Kubernetes at the moment for frontend deployments of MOLGENIS. We deploy a frontend and configure a backend.

Rancher

For internal deployment we use Rancher as orchestrator for Kubernetes.

Depoying only the frontend (production)

Login to Rancher https://rancher.molgenis.org:7777.

  • You can login with your University account:

login

  • Choose a cluster you want to deploy on:

choose-cluster

  • Click on 'Apps'

  • Click on 'Launch'

launch-app

  • Search for: 'frontend'

search-frontend

  • Choose 'molgenis-frontend'

choose-frontend

  • Fill in the form
    • The releasename resolves to the releasename.environment.molgenis.org. So for example vkgl.test.molgenis.org.
    • The namespace allows you to find your instance quickly when you want to debug
    • The environment determines in what domain you want to deploy
    • The version should be the version compatible with the backend you are going or have deployed. For MOLGENIS 8.x we have now:
      • 8-lts - which contains fixed versions for all apps
      • 8-stable - which serves features and bugfixes for all the apps but maintains the major version
      • latest - which contains the latest released versions of all the apps on https://npmjs.org
    • The backend service is disabled by default (only relevant when deploying the MOLGENIS chart). By determning the backend url you specify the MOLGENIS backend instance that will be serving the actual data, For instance https://molgenisxx.gcc.rug.nl.

fill-form

  • Click on 'Launch'

click-launch

The instance will now be deployed.

Users

The users will be served from the MOLGENIS backend and are configured there as well.

Helm

When you deploy on Kubernetes solely, you can use Helm charts to deploy MOLGENIS.

You need a few prerequisites to deploy with Helm.

First of all you need to install the helm tiller on the target cluster:

helm init

Then add the MOLGENIS helm repository to your local helm configuration:

helm repo add molgenis https://helm.molgenis.org

Then update the repositories locally:

helm repo update

You can now install MOLGENIS by executing:

helm install molgenis-frontend