Turn git repositories into Jupyter-enabled Docker Images
 
 
 
 
 
 
Go to file
yuvipanda 38755650c2 Rewrite everything
We will now just generate Dockerfiles for each repository
based on the contents of the repository. We thus combine
the detector and builder in one go - making it a lot simpler
to understand and extend. It also lets us to compose them
together - making it easy to have Julia stuff in a
virtualenv based container or whatever. This was particularly
hard with s2i, since it was built on the core idea of one
container being able to run one kind of application well.
2017-07-28 19:32:53 -07:00
docs Add doc requirements 2017-06-02 13:13:31 -07:00
repo2docker Commit Julia's s2i assemble files! 2017-07-01 01:11:52 -07:00
s2i-builders Rewrite everything 2017-07-28 19:32:53 -07:00
.dockerignore
.gitignore Commit Julia's s2i assemble files! 2017-07-01 01:11:52 -07:00
COPYING.md
Dockerfile
MANIFEST.in
Makefile Add makefile for building and pushing image 2017-05-28 19:25:56 -07:00
README.md Update readme link 2017-06-02 13:15:16 -07:00
install-s2i.bash
setup.cfg
setup.py Commit Julia's s2i assemble files! 2017-07-01 01:11:52 -07:00

README.md

jupyter-repo2docker

jupyter-repo2docker, a command line tool, builds a docker image from a git repository and can push the image to a docker registry.

Installation

To install from pypi, the python packaging index:

python3 -m pip install jupyter-repo2docker

To install from source:

git clone https://github.com/jupyterhub/jupyter-repo2docker.git
cd jupyter-repo2docker
python3 -m pip install .

Usage

To access help for the application:

jupyter-repo2docker -h

Technical Overview for Contributors

jupyter-repo2docker uses other tools (Source to Image or just docker) for doing the actual building of the image.

The repo2docker directory contains the application which detects which build method to use, and how to invoke that build method.

The s2i-builders directory contains builder images which can be used to provide custom conda and venv environments suitable for running JupyterHub.

Documentation

Creating a new builder