Repolode
jupyterhub

jupyterhub/repo2docker

저장소의 설정 파일을 바탕으로 Git 저장소를 Jupyter가 포함된 Docker 이미지로 빌드합니다.

스타
1,740
포크
389
열린 이슈
199
마지막 커밋
16시간 전

어떤 프로젝트인가요?

repo2docker는 GitHub나 로컬 경로에서 Git 저장소를 가져와, 저장소에 있는 설정 파일을 바탕으로 컨테이너 이미지를 빌드합니다. 저장소의 내용을 Jupyter 환경에서 살펴볼 수 있도록 이미지가 구성되므로, 필요한 의존성이 이미 설치된 프로젝트를 쉽게 공유할 수 있습니다.

저장소 URL을 지정해 `jupyter-repo2docker` 같은 명령 하나로 실행할 수 있습니다. 머신에서 Docker가 실행 중이어야 합니다. 빌드가 끝나면 도구가 로그인 토큰이 포함된 URL을 출력하며, 이 URL을 열면 저장소 파일이 있는 Jupyter Notebook이 실행됩니다.

설계는 Heroku Build Packs에서 영감을 얻었습니다. 저장소 자체에 환경을 어떻게 빌드할지 선언하는 방식입니다. Binder 스타일 서비스의 엔진으로 사용되며, Docker 데몬에 접근할 수 있으면 BinderHub가 컨테이너 안에서 실행할 수 있습니다. Linux와 macOS를 지원하며, PyPI에서 `jupyter-repo2docker`로 설치할 수 있습니다.

핵심 기능

  • 01GitHub 또는 로컬 경로에서 Git 저장소를 가져와 Docker 이미지로 빌드합니다.
  • 02저장소의 설정 파일을 읽어 환경 구성을 결정합니다.
  • 03빌드가 끝나면 저장소 내용을 포함한 Jupyter Notebook 서버를 실행합니다.
  • 04PyPI 또는 소스 코드에서 pip로 설치할 수 있습니다.
  • 05BinderHub에서 사용하는 방식처럼 Docker 데몬에 접근할 수 있으면 컨테이너 안에서 실행할 수 있습니다.

활용 사례

  • 연구 또는 교육용 저장소를 패키징해 필요한 의존성이 모두 설치된 상태로 다른 사람이 실행할 수 있게 합니다.
  • 수동 설정 없이 공유 코드 저장소를 재현 가능한 Jupyter 환경에서 실행합니다.
  • BinderHub를 통해 프로젝트의 Binder 스타일 실행 링크를 제공합니다.

빠른 시작

  1. 1

    Docker 설치(필수이며 실행 중이어야 함)

  2. 2

    PyPI에서 repo2docker 설치

    pip install jupyter-repo2docker
  3. 3

    저장소 빌드 및 실행

    jupyter-repo2docker https://github.com/norvig/pytudes

사용 전 알아둘 점

  • Linux와 macOS를 지원합니다. Windows는 공식적으로 지원되지 않습니다.
  • 사용 중인 컴퓨터에서 Docker가 실행 중이어야 합니다.

토픽

자주 묻는 질문

repo2docker은(는) 무엇인가요?
저장소의 설정 파일을 바탕으로 Git 저장소를 Jupyter가 포함된 Docker 이미지로 빌드합니다. repo2docker는 GitHub나 로컬 경로에서 Git 저장소를 가져와, 저장소에 있는 설정 파일을 바탕으로 컨테이너 이미지를 빌드합니다. 저장소의 내용을 Jupyter 환경에서 살펴볼 수 있도록 이미지가 구성되므로, 필요한 의존성이 이미 설치된 프로젝트를 쉽게 공유할 수 있습니다.
repo2docker은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
repo2docker은(는) BSD-3-Clause 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
repo2docker은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. repo2docker의 마지막 커밋은 2026년 11월 6일입니다.
repo2docker은(는) 어디에 사용할 수 있나요?
연구 또는 교육용 저장소를 패키징해 필요한 의존성이 모두 설치된 상태로 다른 사람이 실행할 수 있게 합니다. 수동 설정 없이 공유 코드 저장소를 재현 가능한 Jupyter 환경에서 실행합니다. BinderHub를 통해 프로젝트의 Binder 스타일 실행 링크를 제공합니다.
repo2docker는 어떻게 설치하나요?
Docker 설치(필수이며 실행 중이어야 함) PyPI에서 repo2docker 설치: pip install jupyter-repo2docker 저장소 빌드 및 실행: jupyter-repo2docker https://github.com/norvig/pytudes
repo2docker은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/jupyterhub/repo2docker

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트