31일차. 깃 브랜치 만들기

 

 

 

 

 

 

 

 

 

오늘은 깃허브에서 브랜치를 나누고 올리는 방법에 대해 알아보았다.

개인 프로젝트는 어떻게 할지에 대해 고민해보고 깃허브에 올리는 것도 만들어보았다//

준비물 (지금 당장 필요한 것 2개)

1. 깃허브 계정 (로그인돼 있어야 함)
2. 컴퓨터에 Git 설치돼 있어야 함 → 안 돼 있으면 여기서 1분 설치: https://git-scm.com/downloads

1단계: 새 레포 만들기 (깃허브 웹에서 1분)

1. https://github.com/new 접속
2. 아래처럼 입력 후 Create repository 클릭

 

항목입력할 내용

Repository name	lca-calculator (또는 원하는 이름)
Description	생애주기 평가(LCA) 계산기 프로젝트
Public / Private	Public (포트폴리오면 무조건 Public!)
Add a README file	체크 해제
Add .gitignore	체크 해제
Choose a license	MIT License (추천)

→ 초록색 Create repository 버튼 클릭!

2단계: 로컬에 클론 + develop 브랜치 만들기 (터미널에서 2분)

터미널(맥은 Terminal, 윈도우는 Git Bash나 PowerShell) 열고 아래 순서대로 복붙!

Bash

 

# 1. 바탕화면이나 원하는 폴더로 이동
cd ~/Desktop        # 맥/리눅스
# cd C:\Users\너이름\Desktop   # 윈도우

# 2. 방금 만든 레포 클론
git clone https://github.com/너아이디/lca-calculator.git
cd lca-calculator

# 3. develop 브랜치 만들고 바로 푸시 (이제부터 여기서 개발!)
git checkout -b develop
git push -u origin develop

3단계: main 브랜치 보호 설정 (깃허브 웹에서 2분)

1. 깃허브 레포로 들어가기 → Settings 탭 클릭
2. 왼쪽 메뉴 Branches 클릭
3. Add rule 버튼 클릭
4. 아래처럼 입력 후 초록색 Add rule 클릭

 

항목설정값

Branch name pattern	main
Require a pull request...	체크
Require approvals	1 (혼자면 1로 해도 됨)
Dismiss stale approvals...	체크
Require status checks...	체크 해제 (나중에 CI 넣을 때 켜기)
Require linear history	체크 (강력 추천! 충돌 거의 없어짐)
Include administrators	체크

→ 이제 main은 PR 없으면 절대 못 건드림!

4단계: .github 폴더 + 자동화 파일 만들기 (복붙만 하면 됨)

터미널에서 그대로 복붙!

Bash

 

# 1. .github 폴더 만들기
mkdir .github
mkdir .github/workflows

# 2. PR 템플릿 만들기
cat > .github/pull_request_template.md << 'EOF'
## 작업 내용
- [ ] 새 기능 / 버그 수정 / 리팩토링 / 문서

## 관련 이슈
Closes #

## 체크리스트
- [ ] 코드 정상 동작 확인
- [ ] develop 브랜치 최신화함
- [ ] 불필요한 로그 삭제함
EOF

# 3. 자동 브랜치 삭제 워크플로우 만들기 (PR 머지되면 자동 삭제!)
cat > .github/workflows/auto-delete.yml << 'EOF'
name: Auto Delete Merged Branch
on:
  pull_request:
    types: [closed]

jobs:
  delete-branch:
    if: github.event.pull_request.merged == true
    runs-on: ubuntu-latest
    steps:
      - name: Delete branch
        uses: dawidd6/action-delete-branch@v3
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          branches: ${{ github.event.pull_request.head.ref }}
EOF

5단계: 최고의 .gitignore 만들기 (LCA 프로젝트용)

Bash

 

cat > .gitignore << 'EOF'
# Python / Node
__pycache__/
*.pyc
node_modules/
dist/
build/
.env
.venv
venv/

# 데이터 파일 (용량 큰 거 올라가지 않게!)
data/*.xlsx
data/*.csv
*.xlsx
*.csv

# IDE
.vscode/
.idea/
*.swp

# OS
.DS_Store
Thumbs.db
EOF

6단계: README에 브랜치 전략 넣기 (포트폴리오용 필수!)

Bash

 

cat > README.md << 'EOF'
# LCA Calculator

생애주기 평가(LCA)를 쉽게 계산해주는 웹 앱

## 브랜치 전략
| 브랜치           | 용도                              | 보호 | 삭제 시점       |
|------------------|-----------------------------------|------|-----------------|
| `main`           | 항상 배포 가능한 완성본           | 강력 | 절대 삭제 금지  |
| `develop`        | 현재 개발 중인 최신 코드          | 보호 | 유지            |
| `feature/...`    | 새 기능 개발                      | 없음 | 머지 후 삭제    |
| `hotfix/...`     | 긴급 버그 수정                    | 없음 | 머지 후 삭제    |
| `release/vX.Y.Z` | 배포 직전 테스트 및 버전 정리     | 보호 | 태그 후 삭제    |

> 모든 작업은 develop → feature 브랜치에서 시작  
> 기능 완료 → develop → main 순으로 머지  
> PR 머지 후 자동으로 브랜치 삭제됩니다
EOF

7단계: 첫 커밋하고 푸시 (마지막!)

Bash

 

git add .
git commit -m "chore: init project with perfect branch strategy"
git push

끝! 이제 당신 깃허브 상태

• main (보호됨)
• develop (지금 여기서 개발 시작!)
• .github 폴더에 PR 템플릿 + 자동 브랜치 삭제
• 최고의 .gitignore
• 포트폴리오급 README

지금 당장 시작할 첫 feature 브랜치 예시

Bash

 

git checkout develop
git checkout -b feature/lca-input-form
# 여기서 코딩 시작!!!

 

 

 

---

 develop 브랜치가 언제 필요하냐?

 main = 항상 깨끗하고 배포 가능한 버전

 develop = 여러 기능(feature) 브랜치들이 합쳐지는 작업 공간
즉:

• 팀원들은 feature 브랜치에서 작업
• 작업이 어느 정도 되면 develop으로 merge
• develop에서 전체 테스트
• 안정화되면 develop → main으로 merge

지금 너희 팀이 여러 명이 동시에 작업하는 구조라서
 develop 브랜치를 지금 만들어두면 충돌 관리가 매우 쉬워짐.

 

5:01

앞으로 이렇게 하면 될거 같아요 develop으로 merge하고 테스트해서 메인으로 끌어가는 것으로

 

 

---

git branch

 

git switch -c feature-lucy

git add .

git commit -m "feat: 여기 너가 한 내용 한 줄 요약"

git push -u origin feature-lucy

# 1. 새 브랜치 만들고 바로 그 브랜치로 이동 (현재 main 기준으로)
git switch -c feature-brbr# 2. 너가 수정한 파일들 커밋 (이미 커밋 안 했으면)
git add .
git commit -m "feat: 여기 너가 한 내용 한 줄 요약"# 3. 원격에 처음 푸시 + 트래킹 설정 (이거 제일 중요!)
git push -u origin feature-brbr