개발관련 팁

Jupyter Notebook과 GitHub를 연동

atomicdev 2024. 11. 22. 13:14
728x90

Jupyter Notebook과 GitHub를 연동하여 코드와 데이터를 관리하는 방법을 설명합니다. 이 과정은 Jupyter Notebook에서 작업한 내용을 GitHub 저장소에 업로드하고 관리할 수 있도록 설정하는 단계로 나뉩니다.


1. Git 설치 및 설정

GitHub와 연동하려면 Git이 설치되어 있어야 합니다.

Git 설치

  1. Git 공식 웹사이트에서 운영체제에 맞는 Git을 다운로드하고 설치합니다.
  2. 설치 후 터미널에서 다음 명령어를 실행하여 Git이 제대로 설치되었는지 확인합니다:
git --version

Git 사용자 정보 설정

GitHub에 올릴 때 사용자 정보를 설정해야 합니다:

git config --global user.name "Your Name" git config --global user.email "your.email@example.com"
 

2. GitHub 저장소 생성

  1. GitHub에 로그인합니다.
  2. New Repository를 클릭하여 새로운 저장소를 생성합니다.
  3. 저장소 이름을 입력하고 Initialize this repository with a README를 체크한 후 Create Repository 버튼을 클릭합니다.

3. GitHub와 Jupyter Notebook 프로젝트 폴더 연동

프로젝트 폴더 초기화

  1. Jupyter Notebook 작업 디렉터리로 이동합니다.
    cd /path/to/your/jupyter-notebook-folder
     
  2. Git 저장소를 초기화합니다:
    git init

 

 

원격 저장소 연결

  1. GitHub에서 생성한 저장소 URL을 복사합니다.
  2. 원격 저장소를 연결합니다:
    git remote add origin https://github.com/your-username/your-repository.git

4. Jupyter Notebook 파일 관리

파일 추가 및 커밋

  1. 작업한 Jupyter Notebook 파일을 Git에 추가합니다:
    git add .
  2. 파일 변경 사항을 커밋합니다:
    git commit -m "Initial commit with Jupyter Notebook"

 

 

파일 푸시 (GitHub에 업로드)

GitHub 저장소에 파일을 푸시합니다:

git push -u origin main

 

 


5. GitHub에서 Jupyter Notebook 미리보기

GitHub는 .ipynb 파일을 자동으로 렌더링하여 미리보기할 수 있습니다. 업로드 후 GitHub 저장소에서 해당 파일을 클릭하면 바로 볼 수 있습니다.


6. 이후 작업 흐름

새로운 작업 후 업데이트

  1. 작업한 내용을 저장 후 GitHub에 업로드:
    git add . git commit -m "Updated notebook with new analysis" git push
     

GitHub 저장소에서 업데이트 내용 가져오기

다른 장치나 사용자가 저장소를 업데이트했다면 최신 내용을 가져옵니다:

bash
코드 복사
git pull

7. (선택) Jupyter Notebook에서 Git 사용

Jupyter Notebook 확장 프로그램을 설치하면 Jupyter 인터페이스 내에서 Git 작업을 수행할 수 있습니다.

Jupyter Git 확장 설치

  1. Jupyter Lab Git 확장을 설치합니다:
    pip install jupyterlab-git
     
  2. Jupyter Lab 서버를 실행하면 인터페이스에서 Git 옵션이 활성화됩니다.

 


문제 해결

  1. Permission denied 오류: SSH 키를 설정하거나 HTTPS 인증 정보를 확인합니다.
  2. 브랜치 충돌: git pull 명령어로 최신 내용을 먼저 병합합니다.
  3. 작업 파일 손실 방지: 항상 git status를 통해 파일 변경 사항을 확인하고 커밋합니다.

이 과정을 따라 하면 Jupyter Notebook과 GitHub 간 연동을 원활히 수행할 수 있습니다.

728x90