Deploy NEST Desktop on HBP

Human Brain Project

The documentation shows how to deploy NEST Desktop from docker hub on HBP resources.

HBP provides two OpenShift infrastructures

Note

I strongly recommend to use the development page before you push NEST Desktop on https://openshift.hbp.eu.

Requirements

Step to deploy (in development)

First configure OpenID Connect client for NEST Desktop here.

You can copy command line from the web console of https://openshift-dev.hbp.eu.

Login to openshift-dev.hbp.eu:

oc login https://openshift-dev.hbp.eu:443 --token=<token>

Get status of current project:

oc status

You find a configuration and a bash files for setting up NEST Desktop on HBP. Execute the bash script and in the end it shows the IP needed for HBP authentication (see below):

cd infrastructure/openshift-dev.hbp.eu
bash setup-nest-desktop.sh

Further usage

Scaling up the replicas (pods or nodes):

oc scale --replicas=2 dc nest-desktop

Monitor log of a pod (Get pod name: oc get pod):

oc exec <pod> -- nest-server log

HBP Authentication and redirecting

To access to NEST Desktop on HBP infrastructure, an authentication of HBP membership is requested. You find the codes on https://github.com/babsey/hbp-auth.

Here are the steps how to setup authentication and redirecting to NEST Desktop properly. Before you have to modify the environment for HBP authentication, i.e. OIDC_CLIENT_ID, OIDC_CLIENT_SECRET and CLUSTER_IP of NEST Desktop (which is printed after setting up NEST Desktop).

cd projects/nest-desktop-dev
bash setup-nest-desktop-hbp-auth.sh

Deploy Production

If NEST Desktop is ready for the production, meaning to deploy on apps.hbp.eu. Perform all steps same as in Development (apps-dev.hbp.eu).

Maintenance

tba

Acknowledgements

Thanks for the help to integrate NEST Desktop on HBP resources:
  • Alberto Madonna (Concepting)
  • Collin McMurtrie (Contacting)
  • Fabrice Gaillard (Concepting of user authentication)
  • Jonathan Villemaire-Krajden (Concepting)
  • Martin Jochen Eppler (Contacting)