Zero to JupyterHub with EE

Overview

The goal of this page is to provide guidance on standing up a JupyterHub server for Earth Engine developers who use the Python API. Potential use cases for such a server are for supporting a small research group or for teaching a workshop.

These instructions largely just refer to relevant sections of the comprehensive Zero To JupyterHub tutorial that is maintained by the Jupyter project team, and anyone setting up a JupyterHub should read that tutorial first.

These instructions:

• only discuss deploying and configuring Kubernetes on Google Cloud Platform.
• utilize a customized user environment via a Docker image that includes the Earth Engine Python API and additional libraries that are useful for working with geospatial data.

Prerequisites

• A Google account with access to Google Cloud Platform. Signup here.
• A Google account with access to Earth Engine. Signup here.
• A GitHub account. Signup here.

Setup

Google Cloud Platform (GCP) Setup

Create a GCP Project

Todo...

Enable Billing

Todo...

Enable the Relevant Google APIs

Todo...

Create a Kubernetes Cluster

Todo...

Helm

Install Helm

Todo...

Initialize Helm

Todo...

Add the JupyterHub Helm chart

Todo...

Add GitHub Authentication

Todo...

Customizing the content served by JupyterHub

Todo...

Operations

Todo...

Teardown

After you are finished using your JupyterHub, you should shut down the resources so you do not incur any additional costs

Delete the Helm Namespace

Follow these instructions: http://zero-to-jupyterhub.readthedocs.io/en/latest/turn-off.html#delete-the-helm-namespace

Shut down the GCP Resources

Follow these instructions: http://zero-to-jupyterhub.readthedocs.io/en/latest/turn-off.html#google-cloud-platform

References

• Zero to JupyterHub (Docs, GitHub)
• JupyterHub (Docs, GitHub)
• JupyterLab (Docs, GitHub)
• Earth Engine Python API (Docs, GitHub)
• GEE Community - Jupyter Contributions (GitHub)