An open API service indexing awesome lists of open source software.

https://github.com/radanalyticsio/base-notebook

An image for running Jupyter notebooks and Apache Spark in the cloud on OpenShift
https://github.com/radanalyticsio/base-notebook

apache-spark data-science jupyter-notebook notebook openshift

Last synced: about 1 year ago
JSON representation

An image for running Jupyter notebooks and Apache Spark in the cloud on OpenShift

Awesome Lists containing this project

README

          

[![Build status](https://travis-ci.org/radanalyticsio/base-notebook.svg?branch=master)](https://travis-ci.org/radanalyticsio/base-notebook)
[![Docker build](https://img.shields.io/docker/automated/radanalyticsio/base-notebook.svg)](https://hub.docker.com/r/radanalyticsio/base-notebook)
[![Layers info](https://images.microbadger.com/badges/image/radanalyticsio/base-notebook.svg)](https://microbadger.com/images/radanalyticsio/base-notebook)

# base-notebook

This is a container image intended to make it easy to run Jupyter notebooks with Apache Spark on OpenShift. You can use it as-is (by adding it to a project), or you can use it as the basis for another image. In the latter case, you'll probably want to add some notebooks, data, and/or additional packages to the derived image.

## Usage

### As a standalone image

For your convenience, binary image builds are available from Docker Hub.

* Add the image `radanalyticsio/base-notebook` to an OpenShift project.
* Set `JUPYTER_NOTEBOOK_PASSWORD` in the pod environment to something you can remember (this step is optional but highly recommended; if you don't do this, you'll need to trawl the logs for an access token for your new notebook).
* Create a route to the pod.

### As a base image

* As `nbuser` (uid 1011), add notebooks to `/notebooks` and data to `/data`.
* This process should be easier in the future; stay tuned!

## Notes

Make sure that this notebook image is running the same version of Spark as the external cluster you want to connect it to.

## Credits

This image was initially based on [Graham Dumpleton's images](https://github.com/getwarped/jupyter-stacks), which have some additional functionality (notably s2i support) that we'd like to incorporate in the future.