[GitHub] Issue, Project 활용

H_dev·2022년 11월 1일

🎯 목표

이번 글에서는 GitHub에서 제공하는 project, issue가 무엇인지, 어떻게 사용하는지 흐름을 정리한다.

전에 GitHub를 사용하면서 project, issue 같은 기능을 그냥 무시하고 제멋대로 썼었다 ㅋㅋ
회사에서 스터디를 하게 됐는데 이번 기회에 무슨 기능인지 정리해보기로 했다.

✨ Issue ?

프로젝트의 기획, 작업, 개선 사항, 버그 수정, 새로 추가될 기능 등 모든 것을 이슈 라고 한다.
GitHub 에서는 이 모든 활동에 대해 이슈를 등록하고, 그것을 기반으로 작업을 진행할 수 있다.
Jira에서 이슈를 생성해 작업을 진행하는 것과 같고, 그 외에도 이슈 open, close 개념은 같다.

💻 Project ?

프로젝트는 작업의 진행도를 한 눈에 볼 수 있고, 이슈들을 하나의 작업(task)로 나타내서 그 작업이 어느정도 진행되었는지 확인하고 관리할 수 있는 메뉴이다. (원하는 뷰 형식으로 사용할 수 있다. 보통은 칸반 보드 형태로 사용하는 것 같다.)

(참고) kanban board

✔ 프로젝트 생성

먼저 Project를 생성하고, 위의 칸반 보드 형태로 구성해 작업에 대한 진행도를 확인하고 관리할 수 있도록 구성해보는 실습위주로 진행해볼 것이다.

자신의 github home에서 Projects -> New project

다음으로 아래와 같은 화면이 보인다. Board 형태로 진행할 것이니 Board를 선택하고 Create 한다.

생성이 완료되면 아래와 같이 빈 보드가 생성이 된다.

보드 안에 들어가게 될 이슈에 해당 프로젝트를 할당하게 되면, 이슈가 연결되어 작업 진행도를 한눈에 파악할 수 있게된다.

또한, 보드 아래의 + Add item를 하게 되면 item이 등록되고, 작업을 나타낼 수 있는것은 물론 그 자리에서 issue로 컨버팅이 가능하다.

✔ 이슈 생성 및 할당

다음으로, Issue 사용법을 알아보자
제일 먼저, 위에서 생성한 project를 레포지토리에 등록해줘야 한다.
repository -> Projects -> Add project

다음으로 issue 등록하기 위해 이동한다.

Issue -> New issue 를 누르면 나오는 등록 화면은 다음과 같다.

해당 이슈에 대한 제목과 코멘트를 작성해야하고,
중요한 것은 오른쪽의 4가지 항목이다.

Assignees : 담당자

Labels : 해당 작업의 유형

Label 항목에서 bug 등 기본항목을 전부 지우는 게 가능하고, 취향대로 커스터마이징이 가능하다.

Projects : 연결할 project (진행도를 한번에 볼 수 있는 메뉴)

Milestone : 프로젝트가 도달해야하는 목표지점

Milestone을 사용하면, 한 가지의 목표에 여러 이슈가 등록되어 있을 때 해당 목표의 진행도가 얼마나 되는지 게이지 바 형태로 볼 수 있다. (위 이미지에서 [테스트] 를 선택했을 때)

생성법 : issue -> Milestones -> New milestone