README.md

jupyterhub-on-gcloud
no kubernetes

This project is part of DigiKlausur project project to deploy jupyterhub on a server (Google cloud engine) for teaching. However, due to unreliabily of a single server running jupyterhub, we are switching to Kubernetes. This deployment is useful for small class consisting of maximum 50-60 students.

Installation

Created Freitag 21 September 2018

• Create instance on google vm

  • VM Instance
    • Change server to europe-west1-b
    • Costumize cpu and memory
    • Choose boot disk and change the disk size
    • Firewall: allow http and https traffic
  • Snapshot
    • Create a snapshot for backup
  • IP external
    • Create reserved static ip
    • Attach static ip to the instance

• On the instance

  • Install nginx: sudo apt install nginx
  • Install certbot
    • Go to: https://certbot.eff.org/lets-encrypt/debianstretch-nginx
    • Install: sudo apt-get install python-certbot-nginx -t stretch-backports
    • Obtain ssl certificate (got certbot url)
      • sudo certbot certonly --authenticator standalone --pre-hook "nginx -s stop" --post-hook "nginx"
    • Configure let's encript
    • cd /etc/letsencrypt
    • sudo chmod 777 -R archive/
    • sudo chmod 777 -R live/
    • Shutdown pc, and configure cloud dns in gcloud and in your dns provider
      • In your dns provider
      • Add A record in the name server that points to your ip address
      • In google dns cloud
        • Create zone and add your domain and your name server (A, NS and CNAME record)
  • Create cookie secret, proxy auth token and dhparam.pem for jupyterhub
    • Create cookie secret
      • mkdir /srv/jupyterhub
      • cd /srv/ jupyterhub
      • sudo touch jupyterhub_cookie_secret
      • sudo chown :sudo jupyterhub_cookie_secret
      • sudo chmod g+rw jupyterhub_cookie_secret
      • sudo openssl rand -hex 32 > jupyterhub_cookie_secret
      • sudo chmod 600 jupyterhub_cookie_secret
    • Create proxy auth token
      • cd /srv/jupyterhub
      • sudo touch proxy_auth_token
      • sudo chown :sudo proxy_auth_token
      • sudo chmod g+rw proxy_auth_token
      • sudo openssl rand -hex 32 > proxy_auth_token
      • sudo chmod 600 proxy_auth_token
    • Generate dhparam.pem
      • cd /etc/nginx
      • sudo touch dhparam.pem
      • sudo chown :sudo dhparam.pem
      • sudo chmod g+rw dhparam.pem
      • sudo openssl dhparam -out /etc/nginx/ssl/dhparam.pem 2048
      • sudo chmod 600 dhparam.pem
  • Modify nginx config
    • Modify nginx config or copy role/nginx/nginx.conf
    • Modify /etc/nginx/sites-enabled/default and copy the configuration as in role/nginx/sites-enabled/default (replace with your domain name)
  • Install jupyterhub: https://jupyterhub.readthedocs.io/en/stable/quickstart.html
    • Install python 3.5: no greater than 3.5, otherwise it will break nodejs and npm
    • Install pip3: sudo apt install python3-pip
    • Install nodejs: https://nodejs.org/en/download/package-manager/
    • Install jupyter notebook: sudo pip3 install jupyter
    • Install jupyterhub
      • sudo python3 -m pip install jupyterhub
      • sudo npm install -g configurable-http-proxy
      • sudo python3 -m pip install notebook
    • Install systemd spawner: https://github.com/jupyterhub/systemdspawner
  • Install nbgrader
    • Global install + assignment list
      • pip3 install nbgrader
      • jupyter serverextension enable --system --py nbgrader
      • jupyter nbextension install --system --py nbgrader --overwrite
      • jupyter nbextension enable --sys-prefix assignment_list/main --section=tree
      • jupyter serverextension enable --sys-prefix nbgrader.server_extensions.assignment_list
      • Extensions
        • pip3 install jupyterlab
        • jupyter labextension install jupyterlab-drawio
        • Contrib
          • pip3 install jupyter_contrib_nbextensions
          • jupyter contrib nbextension install --sys-prefix
          • enable contrib extensions:
            • jupyter nbextension enable --sys-prefix codefolding/main
            • jupyter nbextension enable --sys-prefix nbTranslate/main
            • jupyter nbextension enable --sys-prefix collapsible_headings/main
        • RISE (presentation) a. ttps://github.com/damianavila/RISE
    • Instructor only (local)
      • jupyter nbextension enable --user --py nbgrader

Releasing feedback to student assignment directory

• Before releasing feedback, the html files containing the feedback have to be generated with nb grader.

nbgrader feedback assignment_id

• Now, we can send back the feedbacks to student directory

sudo config/release_feedback.py --assignment_id WuS-01

• Arguments:
  • --assignment_id : specify the assignment id
  • --student_id : create feedback for a specific student
  • --student_group : create feedback for the students in a group (Linux group)
• If there is no student id specified, then it will generate feedback for all students

Generating pdfs from the feedback