Turn git repositories into Jupyter-enabled Docker Images
 
 
 
 
 
 
Go to file
yuvipanda e81703aaaf Cleanup dockerfile a little
- Don't do pip install -U pip - this makes the image build more
  non-deterministic than necessary. 17.04 has the latest version of
  pip, and we can stick to newest ubuntu quite aggressivley to keep
  up in the cases it matters.
- Set --no-cache-dir in pip install, so we don't actually build
  wheels - they are useless in our situation. This also lets us not
  have to install wheels
- Make note about
2017-05-27 18:09:02 -07:00
repo2docker move dockerfile appendix into LegacyBinderDockerBuildPack.dockerfile_appendix 2017-05-25 15:37:33 -07:00
s2i-builders Move the s2i builders into a subdir 2017-05-22 16:18:49 -07:00
.dockerignore Update gitignore + add dockerignore 2017-05-09 20:43:27 -07:00
.gitignore update manifest for sdist 2017-05-24 17:21:11 -07:00
Dockerfile Cleanup dockerfile a little 2017-05-27 18:09:02 -07:00
LICENSE Initial commit 2017-05-09 01:37:07 -07:00
MANIFEST.in update manifest for sdist 2017-05-24 17:21:11 -07:00
README.md Add link to builder doc 2017-05-24 17:49:59 -07:00
builder.md Fix format of command 2017-05-24 10:00:44 -07:00
install-s2i.bash Upgrade version of s2i 2017-05-22 15:15:31 -07:00
setup.cfg apply platform tag to wheels 2017-05-24 10:01:24 -07:00
setup.py bump version to 0.2.0 2017-05-24 17:17:57 -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