2025.05.19 GitHub 초기 커밋 구조 만들기

GitHub 초기 커밋 구조 만들기 (Poetry 프로젝트 기준)

VS Code + Python + Poetry 환경에서 GitHub로 버전 관리를 시작하는 방법을 정리한 기록입니다.

---

✅ 1. Git 저장소 초기화

Poetry 프로젝트 폴더에서 Git 저장소를 초기화합니다:

bash

복사편집

git init

---

✅ 2. .gitignore 파일 생성

Poetry, Python, VS Code 환경에 맞춘 .gitignore 파일을 루트에 생성하고 아래 내용을 추가합니다:

gitignore

복사편집

# Byte-compiled / cache __pycache__/ *.py[cod] *.pyo # Poetry / Python virtual environments *.lock .venv/ .env .poetry/ *.egg-info/ # VS Code .vscode/ # Logs and dumps *.log logs/ *.sqlite3 # Jupyter/IPython .ipynb_checkpoints/

---

✅ 3. 커밋 작성

처음에는 .gitignore, README.md, pyproject.toml, src/, tests/ 등이 포함된 상태에서 커밋합니다:

bash

복사편집

git add . git commit -m "🎉 Initial commit: project setup with Poetry and source layout"

만약 user.name 또는 user.email이 설정되지 않았다는 오류가 뜬다면:

bash

복사편집

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

---

✅ 4. GitHub 저장소 생성

1. GitHub 로그인
2. 오른쪽 상단 New → Repository 클릭
3. 저장소 이름: autobot-trader (또는 원하는 이름)
4. 나머지는 기본 설정 유지 후 Create repository

---

✅ 5. 원격 저장소 연결 및 푸시

GitHub에서 안내되는 주소를 복사하여 터미널에서 다음과 같이 입력:

bash

복사편집

git remote add origin https://github.com/your-username/autobot-trader.git git branch -M main git push -u origin main

푸시 시 로그인 인증이 필요할 수 있으며, GitHub 비밀번호 대신 Personal Access Token(PAT) 입력이 필요합니다.

---

✅ 6. 결과 확인

GitHub 저장소에서 커밋 이력, 파일 구조, .gitignore 적용 여부를 확인합니다.

---

💡 참고 구조 예시

css

복사편집

autobot-trader/ ├── .gitignore ├── README.md ├── pyproject.toml ├── poetry.lock ├── src/ │ └── autobot_trader/ │ ├── __init__.py │ └── main.py └── tests/ └── __init__.py

---

이제 프로젝트는 안전하게 GitHub에 백업되었으며, 협업 및 자동화 준비가 완료된 상태입니다! 🚀
다음 글에서는 strategies/, telegram_bot.py, run.py 등의 구조 확장 방법을 다룰 예정입니다.