repo2docker/README.md

44 wiersze
1.0 KiB
Markdown

# 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:
```bash
python3 -m pip install jupyter-repo2docker
```
To install from source:
```bash
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](https://github.com/openshift/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](builder.md)