본문 바로가기

IT

GitHub Issues / Projects 제대로 써보기: 실전 적용 가이드

 

GitHub Issues / Projects 제대로 써보기: 실전 적용 가이드

✅ GitHub Issues와 Projects는 단순한 메모장이 아니다!

✅ 할 일 관리 + 이슈 추적 + 협업을 한 번에 해결하는 강력한 툴이다!

✅ 개인 프로젝트부터 팀 협업까지 실전에서 바로 적용할 수 있도록 단계별 가이드를 제공한다!

1. GitHub Issues / Projects를 왜 사용해야 할까?

GitHub를 단순한 코드 저장소로만 사용하면:

  • ❌ 작업 흐름이 불명확
  • ❌ 누가 어떤 작업을 하는지 파악하기 어려움
  • ❌ 이슈 관리 없이 커밋이 쌓여 프로젝트 정리가 어려움

🚀 GitHub Issues와 Projects를 활용하면:

  • ✅ 작업 진행 상태를 한눈에 파악 가능
  • ✅ 이슈 - PR - 코드 변경 내역 연계 가능
  • ✅ 자동화 기능으로 반복적인 작업을 줄일 수 있음

2. GitHub Issues: 실전 활용법

📌 예제: "사용자 로그인 기능 추가" 이슈 만들기

### 로그인 기능 구현  
**설명:**  
- 사용자가 이메일과 비밀번호를 입력하여 로그인할 수 있는 기능을 추가합니다.  
- JWT 토큰을 사용하여 인증 처리합니다.  

#### 작업 목록  
- [ ] 로그인 API 개발  
- [ ] 프론트엔드 로그인 폼 UI 추가  
- [ ] JWT 토큰을 통한 세션 관리 구현  
- [ ] 로그인 실패 처리 및 오류 메시지 추가  

**우선순위:** High  
**관련 이슈:** #5 (회원가입 기능)  
    

📌 라벨(Label) 설정

  • 🐛 bug → 버그 수정 관련
  • feature → 새로운 기능 개발
  • 📖 documentation → 문서 작업
  • 🎯 high-priority → 긴급 우선 작업
  • 🏗️ in-progress → 작업 진행 중

3. GitHub Projects: 칸반 보드 활용법

Column 내용
To Do 계획된 작업
In Progress 진행 중인 작업
Review 코드 리뷰 대기 중
Done 완료된 작업

✅ GitHub Actions & 자동화 활용

name: Close Issue on PR Merge

on:
  pull_request:
    types: [closed]

jobs:
  close-issue:
    runs-on: ubuntu-latest
    steps:
      - name: Close related issue
        uses: peter-evans/close-issue@v1
        with:
          comment: "This issue has been resolved with PR #${{ github.event.pull_request.number }}"
    

4. 실전 활용 예제

Column 이슈 내용
To Do #1 회원가입 기능, #2 로그인 기능
In Progress #3 버그 수정 진행 중
Review PR 대기 중 (#5)
Done 완료된 작업

5. 마무리: GitHub Issues / Projects로 개발 환경 최적화

🚀 이제 GitHub를 제대로 활용해보세요!

  • ✅ 개인 프로젝트: 할 일 정리
  • ✅ 팀 프로젝트: 협업 관리
  • ✅ 오픈소스 기여: 이슈 & PR 관리

💡 지금 시작해 보기!

  • 🔹 Issues에서 새 작업 정리
  • 🔹 Projects에서 칸반 보드 구성
  • 🔹 GitHub Actions를 활용한 자동화 적용

GitHub Issues와 Projects를 활용해 개발 생산성을 극대화하세요! 🚀