mirror
/
repo2docker
kopia lustrzana https://github.com/jupyterhub/repo2docker
1
0
Forkuj 0
Kod Zgłoszenia Projekty Wydania Wiki Aktywność
Turn git repositories into Jupyter-enabled Docker Images
500 Commity
6 Gałęzie
21 Tagi
6,4 MiB
Python 95.9%
Shell 2.3%
Nix 0.8%
Dockerfile 0.4%
R 0.3%
Pozostałe 0.3%
 
 
 
 
 
 
Go to file
Min RK 1ffec7ded6 do not reuse BuildPack instances 
rather than instantiating all buildpacks ahead of time, only instantiate as needed.

Makes it clear that a given BuildPack should only perform a single build
and a new BuildPack should be created for a subsequent build.
 		2018-02-09 13:14:34 +01:00
docker add git-credential-env 2017-11-17 16:05:46 +01:00
docs Merge pull request #204 from yuvipanda/docfixes 2018-02-01 08:13:09 -08:00
repo2docker do not reuse BuildPack instances 2018-02-09 13:14:34 +01:00
tests willingc comment on r readme 2018-02-06 11:19:40 -08:00
travis
…
.dockerignore Explicitly add a .dockerignore rather than symlink 2017-10-04 18:17:38 -07:00
.gitignore Explicitly add a .dockerignore rather than symlink 2017-10-04 18:17:38 -07:00
.travis.yml Fix trailing space in .travis.yml 2018-02-08 02:53:18 -08:00
CONTRIBUTING.md Add docs on freezing dependencies 2018-02-08 11:15:53 -08:00
Dockerfile add ability for port mapping to work with non jupyter-workflow 2018-01-11 16:49:09 -08:00
LICENSE
…
MANIFEST.in Move conda support files next to the code 2017-11-30 01:44:25 -08:00
Makefile
…
README.md addressing carol's comments 2017-12-08 11:53:15 -08:00
dev-requirements.txt Add a CONTRIBUTING.md 2018-02-07 23:34:28 -08:00
readthedocs.yml docs typeo 2017-10-11 16:39:08 -07:00
setup.cfg
…
setup.py Use v0.5.0 than v0.5 to be consistent 2018-02-07 11:37:37 -08:00

README.md

jupyter-repo2docker

Build Status Documentation Status

jupyter-repo2docker takes as input a repository source, such as a GitHub repo. It then builds, runs, and/or pushes Docker images built from that source.

See the repo2docker documentation for more information.

Pre-requisites

  1. Docker to build & run the repositories. The community edition is recommended.
  2. Python 3.4+.

Installation

To install from pypi, the python packaging index:

pip install jupyter-repo2docker

To install from source and start contributing:

git clone https://github.com/jupyter/repo2docker.git
cd repo2docker
pip install -e .

Usage

The core feature of repo2docker is to fetch a repo (from github or locally), build a container image based on the specifications found in the repo & optionally launch a local Jupyter Notebook you can use to explore it.

Note that Docker needs to be running on your machine for this to work.

Example:

jupyter-repo2docker https://github.com/jakevdp/PythonDataScienceHandbook

After building (it might take a while!), it should output in your terminal something like:

    Copy/paste this URL into your browser when you connect for the first time,
    to login with a token:
        http://0.0.0.0:36511/?token=f94f8fabb92e22f5bfab116c382b4707fc2cade56ad1ace0

If you copy paste that URL into your browser you will see a Jupyter Notebook with the contents of the repository you had just built!

For more information on how to use repo2docker, see the usage guide.

Repository specifications

Repo2Docker looks for configuration files in the source repository to determine how the Docker image should be built. It is philosophically similar to Heroku Build Packs.

For a list of the configuration files that repo2docker can use, see the usage guide.