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).
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 |
It is easy to add additional images. The basic steps involved are:
- Open an Issue to discuss adding your image.
- Copy the
base-notebook
directory and name it something informative. - Modify the contents of the
binder
directory, adding any configuration you need according to the repo2docker documentation. - Edit the TravisCI configuration file to inclue the new image.
- Push your changes to GitHub and open a Pull Request.
The images in Pangeo-stacks are built and deployed continuously using TravisCI. Images are versioned using the CALVER system.
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
- 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.