최초 프로젝트 설정, PR Merge

Seoyeon·2025년 9월 16일

백엔드

목록 보기

2/27

1단계: 최초 준비 (내 컴퓨터에 프로젝트 설정하기 - 딱 한 번만!)

1. GitHub에서 프로젝트 복제하기 (Clone)

가장 먼저 GitHub에 있는 프로젝트를 내 컴퓨터로 가져오기
이 작업은 Git Bash로 하는 게 간단하고 편함

Git Bash 실행: 시작 메뉴에서 Git Bash를 검색해서 실행

작업 폴더로 이동: 앞으로 프로젝트들을 모아둘 폴더로 이동
cd: 폴더 이동 명령어

# 예시: 내 문서 폴더 안에 Projects 라는 폴더를 만들고 거기로 이동
cd ~/Documents/Projects

프로젝트 복제: 아래 명령어를 그대로 입력해서 팀 프로젝트를 내 컴퓨터로 다운로드
```
git clone https://github.com/2025-UNIS-NIEDU/2025-NIEDU-BACK.git
```
이제 Projects 폴더 안에 2025-NIEDU-BACK이라는 폴더가 생김
일단 Git Bash는 여기까지 쓰고 닫기

2. IntelliJ에서 프로젝트 열기

이제 방금 다운로드한 프로젝트를 IntelliJ에서 열기

IntelliJ를 실행하고 첫 화면에서 Open을 클릭
파일 탐색기가 열리면, 방금 clone으로 생성된 2025-NIEDU-BACK 폴더를 선택하고 OK
오른쪽 아래에 "Trust Project" 라는 팝업이 뜨면 꼭 파란색 Trust Project 버튼을 누르기
IntelliJ가 프로젝트를 인식하고 필요한 파일(Gradle)들을 다운로드. 오른쪽 아래에 진행률 표시줄이 사라질 때까지 잠시 대기.

이제 IntelliJ에 프로젝트 세팅 완료!

2단계: 실제 작업 흐름 (이슈 생성부터 머지까지)

이제부터는 IntelliJ와 GitHub 웹사이트만 사용

1. GitHub에서 이슈 생성하기

GitHub 리포지토리 페이지로 가서 Issues 탭 > New issue 버튼을 클릭
Title: [이슈 타입]{공백}내용 (예시)chore: Initial project setup 이라고 적고 이슈를 생성
생성된 이슈 번호 (예: #12)를 확인하고 기억하기!!!!!!!

2. IntelliJ 터미널에서 작업 준비하기

IntelliJ에서 터미널 열기: IntelliJ 화면 맨 아래에 있는 Terminal 탭을 클릭해서 터미널 창 열기( 앞으로 Git Bash 대신 이거 사용)
최신 코드로 업데이트: 터미널에 아래 명령어들을 순서대로 입력
```
git switch main
git pull origin main
```
내 작업 브랜치 생성: 기억해둔 이슈 번호를 사용해서 새 브랜치를 만들기
```
# 예시: 이슈 번호가 12번일 경우
git switch -c 이슈 타입/#이슈 번호/내용
```

명령어 분석 쪼개보기

git switch

: 말 그대로 브랜치를 바꾸겠다 라는 뜻의 명령어. (git checkout과 비슷한 역할)

-c

: "만들어서(Create)" 라는 의미의 옵션(flag)
: -c가 붙으면 단순히 기존 브랜치로 이동하는 게 아니라, 새로운 브랜치를 생성한 뒤 그곳으로 이동

CHORE/12/init_project

:새로 만들 브랜치의 이름

이름 규칙

CHORE: 작업의 종류 (chore: 자잘한 수정, feat: 기능 개발, fix: 버그 수정 등)
3: 이 작업이 관련된 GitHub 이슈(Issue) 번호
init_project: 어떤 작업인지 요약한 설명

3. 코드 수정 및 커밋하기

IntelliJ 왼쪽의 Project 탐색기에서 README.md 파일을 찾아 더블클릭해서 열기
파일 내용을 수정하고 Ctrl + S (Mac은 Cmd + S)로 저장

다시 IntelliJ 터미널로 돌아와 아래 명령어들을 입력해 변경사항을 저장(커밋)

# 1. 수정한 파일 선택
git add .

# 2. 커밋 메시지와 함께 저장 (메시지 끝에 이슈 번호 넣기!)
git commit -m "[이슈 타입]{공백}내용{공백}(#이슈번호)"
예시) : git commit -m "CHORE: Initial project setup (#12)"

4. GitHub에 업로드하고 PR 만들기

IntelliJ 터미널에서 아래 명령어로 내 브랜치를 GitHub에 올리기(push).

# 예시: 이슈 번호가 12번일 경우
git push --set-upstream origin 이슈 타입/#이슈 번호/내용

GitHub 리포지토리 페이지로 돌아가면 나타나는 "Compare & pull request" 버튼을 누르기
PR 내용을 확인하고, 오른쪽 사이드바에서 Reviewers를 찾아 지정 (이때 자동으로 알림이 감!)
Create pull request 버튼을 눌러 PR 생성을 완료
Closes #이슈번호 달아야지 자동으로 이슈 닫힘 (반드시 띄어쓰기하기!!!!!!!!!!!)

5. 머지하고 마무리하기

이제 리뷰어가 코드를 보고 승인(Approve)해줄 때까지 기다림
승인이 완료되면 PR 페이지에 초록색 Merge pull request 버튼이 활성화. 버튼을 눌러 코드를 최종적으로 합침
머지 후 나타나는 Delete branch 버튼을 눌러 작업했던 브랜치를 삭제하면 모든 과정이 깔끔하게 끝남

승인하기

1단계: PR 확인하러 가기

GitHub에 접속하면 오른쪽 위에 종 모양 아이콘에 알림이 와있음 -> 그걸 클릭해서 해당 PR로 바로 이동
또는, 프로젝트 리포지토리 페이지에서 Pull requests 탭을 누르면 목록이 보임

2단계: 변경된 내용 확인하기

PR 페이지에 들어가면 여러 탭이 있는데, 가장 중요한 건 Files changed 탭

Files changed 탭을 클릭해서 어떤 코드가 바뀌었는지 확인
- 초록색 배경 (+): 새로 추가된 코드
- 빨간색 배경 (-): 삭제된 코드
- 하얀색 배경: 변경되지 않은 주변 코드

코드를 보면서 "이 변경이 원래 요청했던 기능에 맞는지", "오타나 논리적인 오류는 없는지" 등을 가볍게 훑어보기

3단계: 리뷰 남기기 (피드백 또는 승인)

수정할 부분이 보일 때 (댓글 남기기)

수정이 필요한 코드 줄에 마우스를 가져다 대면 파란색 + 버튼이 나타남
버튼을 눌러 댓글을 작성하고 Start a review 버튼을 누르기.

특별히 문제 없을 때 (바로 승인하기)

Files changed 탭 오른쪽 위에 있는 초록색 Review changes 버튼을 클릭
팝업창이 뜨면 Approve 라디오 버튼을 선택
간단한 코멘트를 남기고 Submit review 버튼을 누름

4단계: PR 머지하기 (Merge)

리뷰를 통해 코드가 문제없다고 판단되면, 이제 이 변경사항을 main 브랜치에 합치기(Merge)

다시 Conversation 탭으로 돌아오기
리뷰가 승인(Approve)된 상태라면, 아래쪽에 초록색 Merge pull request 버튼이 활성화되어있음
이 버튼을 누르고, 다시 나타나는 초록색 Confirm merge 버튼을 누르면 모든 변경사항이 main 브랜치에 안전하게 반영
머지가 완료되면 Delete branch 버튼이 나타나는데, 이걸 눌러 작업이 끝난 브랜치를 깔끔하게 삭제해주면 모든 과정이 끝남

Seoyeon

이전 포스트

쿠버네티스(Kubernetes)

다음 포스트