/carina-jupyterhub

🔗 Jupyterhub backed by carina!
  1. Python 81.2%
  2. HTML 18.8%
Python HTML

Clone with HTTPS

Use Git or checkout with SVN using the web URL.

Download ZIP
Find file
Switch branches/tags
Nothing to show
Latest commit 2e447e7 Jan 22, 2016 @betatim Merge pull request #3 from captainsafia/use-carina-cli 
Update README to use Carina CLI
Permalink
Failed to load latest commit information.
carinahub Better docs, random ports, and usernames Nov 24, 2015
templates First commit Nov 24, 2015
.dockerignore First commit Nov 24, 2015
.gitignore More ignoring Nov 24, 2015
Dockerfile First commit Nov 24, 2015
LICENSE Real software needs a license Nov 24, 2015
README.md Update README.md Jan 22, 2016
jupyterhub_config.py Update import for public_ips Dec 15, 2015
setup.py First commit Nov 24, 2015

README.md

carina-jupyterhub

Jupyterhub backed by carina!

Wat?

carina-jupyterhub allows you to host a jupyterhub instance where the users bring their own computing power. You host the jupyterhub frontend, and your users bring the computing power. Amazing!

Impress your friends

To setup your own jupyterhub frontend hosted on carina, create a new cluster on carina and complete the following steps.

Obtaining Access Creditentials

Using Carina CLI

  1. Install and configure the Carina CLI with your Carina username and API key.
  2. Run eval $(carina env name-of-your-cluster) to set up your environment.

Use Carina Credentials Zip

  1. Click "Get Access" on the Carina web interface to download a zip of your credentials.
  2. Unzip the credentials zip file.
  3. Run source docker.env from the unzipped access file.

Running JupyterHub on Carina

  1. docker run --net=host -ti --rm -p 8000 betatim/carina-jupyterhub:25112015 bash
  2. In the container modify jupyterhub_config.py with sed -i -e "s/public_ips()\[0\]/\'`ip addr list eth0 |grep "inet "|cut -d' ' -f6|cut -d/ -f1`'/g" jupyterhub_config.py This replaces public_ips()[0] with the public IP of your cluster in jupyterhub_config.py
  3. start jupyterhub: jupyterhub. This will eventually print JupyterHub is now running at http://SomeIPAddress:8000/. Congratulations, you now running jupyterhub on a carina cluster!

To use the service you just built:

  1. Create a second carina cluster, and download the access credentials using the "Get Access" button in the web UI.
  2. Visit http://SomeIPAddress:8000 enter a short username, and upload the credentials file of your second cluster as the Credentials file
  3. Share http://SomeIPAddress:8000 with your friends (they have to repeat these last three steps)!

Be safe out there!

While not an immediate threat to your health, please think carefully about the security implications of running untrusted code, giving away credentials to computing resources, etc before doing any of the above.