repo2docker:将代码库转换为启用jupyter的docker映像
aicrowd-repo2docker的Python项目详细描述
repo2docker
repo2docker
获取git存储库并基于
在存储库中找到的配置文件。
见repo2docker documentation 有关使用repo2docker的更多信息。
有关支持问题,请搜索或发到https://discourse.jupyter.org/c/binder。
请参阅contributing guide以获取有关为 雷波道克。
见our roadmap 了解项目的方向。
使用repo2docker
先决条件
- Docker来构建和运行存储库。community edition 是推荐的。
- Python3.4+。
支持Linux和MacOS。See documentation note about Windows support.
安装
这是一个安装repo2docker
的快速指南,请参阅我们的a full guide文档。
从pypi安装:
pip install jupyter-repo2docker
从源安装:
git clone https://github.com/jupyter/repo2docker.git
cd repo2docker
pip install -e .
使用量
repo2docker的核心特性是(从github或本地)获取git存储库, 根据存储库中的规范构建容器映像&; (可选)启动可用于浏览存储库的容器。
请注意,Docker需要在您的计算机上运行才能正常工作。
示例:
jupyter-repo2docker https://github.com/norvig/pytudes
建造之后(可能需要一段时间!),它应该在您的终端中输出 例如:
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
如果你复制粘贴到浏览器中,你会看到一个jupyter笔记本 你刚刚建立的储存库的内容!
有关如何使用repo2docker
的详细信息,请参见
usage guide。
存储库规范
repo2docker在源存储库中查找配置文件
确定Docker映像的构建方式。获取配置列表
repo2docker
可以使用的文件,请参见
complete list of configuration files。
repo2docker的哲学灵感来自 Heroku Build Packs。