pbranson / pangeo-stacks

Pangeo Stacks

Currated Docker images for use with Jupyter and Pangeo

This repository contains a few currated Docker images that can be used with deployments of the Pangeo Helm Chart. Each of the images in this repository are configured and built using repo2docker and are continuously deployed to DockerHub. Importantly, each image built in this repo includes the minimum required libraries to do scalable computations with Pangeo (via dask-kubernetes).

Current Notebook Images:

Image	Description	Link	Badges
base-notebook	A bare-bones image with Jupyter and Dask.	DockerHub
pangeo-notebook	A complete image with lots of Python packages	DockerHub
pangeo-ocean	Am image for ocean.pangeo.io and pangeo_ocean_examples	DockerHub

Adding new images

It is easy to add additional images. The basic steps involved are:

1. Open an Issue to discuss adding your image.
2. Copy the base-notebook directory and name it something informative.
3. Modify the contents of the binder directory, adding any configuration you need according to the repo2docker documentation.
4. Edit the TravisCI configuration file to inclue the new image.
5. Push your changes to GitHub and open a Pull Request.

CI/CD

The images in Pangeo-stacks are built and deployed continuously using TravisCI. Images are versioned using the CALVER system.

Build locally

The images here can be built locally using repo2docker. The following example demonstrates how to build the base-notebook image:

repo2docker --no-run --user-name=jovyan --user-id 1000 \
    --appendix="`cat appendix.txt`" \
    --image-name=pangeo/base-notebook ./base-notebook

Related projects

• Jupyter/docker-stacks: Ready-to-run Docker images containing Jupyter applications
• repo2docker: A tool to build, run, and push Docker images from source code repositories that run via a Jupyter server
• Pangeo Helm Chart: The helm chart for installing Pangeo.