풀 리퀘스트 생성 및 관리
Codeflow에서 풀 리퀘스트를 생성하고 검토·병합하는 방법을 설명합니다.
풀 리퀘스트 생성
풀 리퀘스트는 작업 브랜치의 변경 사항을 기준 브랜치에 병합하기 전에 검토와 승인을 요청하는 기능입니다. 풀 리퀘스트를 생성하려면 최종 병합 대상인 기준 브랜치, 변경 사항이 포함된 작업 브랜치, 변경 사항을 검토하고 승인할 리뷰어를 선택해야 합니다.
리포지토리의 승인 규칙에 따라 지정된 리뷰어 승인 등 조건을 충족해야 병합할 수 있습니다.
- 카카오클라우드 콘솔 > Developer Tools > Codeflow 메뉴로 이동합니다.
- 리포지토리 메뉴에서 풀 리퀘스트를 생성할 리포지토리를 선택한 후, 풀 리퀘스트 탭으로 이동합니다.
- 풀 리퀘스트 목록에서 [풀 리퀘스트 생성] 버튼을 클릭합니다.
- 필요한 정보를 입력한 후 [생성] 버튼을 클릭합니다.
- 상세 페이지에서 생성된 풀 리퀘스트를 확인합니다.
리포지토리 규모 및 브랜치 간 변경 사항이 많은 경우 풀 리퀘스트 생성에 시간이 소요될 수 있습니다. 생성이 완료되기 전에 다시 생성을 시도하면 요청이 정상적으로 처리되지 않을 수 있으므로, 잠시 기다린 후 풀 리퀘스트 목록에서 생성 여부를 확인해 주세요.
풀 리퀘스트 조회
Codeflow에서는 특정 리포지토리의 풀 리퀘스트만 집중해서 보거나, 권한이 있는 모든 리포지토리의 업무를 한곳에서 통합하여 조회할 수 있습니다. 조회 목적에 따라 아래의 두 가지 방식을 활용할 수 있습니다.
리포지토리 기준 조회
특정 프로젝트의 전반적인 코드 리뷰 및 병합 현황을 파악하고 싶을 때 사용합니다. 리포지토리 상세 화면의 풀 리퀘스트 탭으로 이동하여 조회할 수 있습니다. 목록에서는 풀 리퀘스트의 번호, 이름, 기준 브랜치, 작업 브랜치, 생성자, 생성 일시를 확인할 수 있습니다.
- 생성자는 목록의 [⋮] 버튼에서 풀 리퀘스트를 취소·병합·삭제할 수 있습니다.
- 리뷰어는 상세 화면으로 이동하여 풀 리퀘스트를 승인·반려·리뷰 취소할 수 있습니다.
전체 통합 조회
여러 프로젝트에 걸쳐 당장 처리해야 할 업무(생성했거나 리뷰해야 할 PR)를 빠르게 확인하고 싶을 때 사용합니다. 좌측 풀 리퀘스트 메뉴에서 조회할 수 있습니다. 통함 검색이 목적이며, 관련 제어(취소·병합·삭제, 승인·반려·리뷰)는 상세 화면에서 진행할 수 있습니다.
풀 리퀘스트 상태
풀 리퀘스트의 진행 여부는 상태로, 리뷰어 검토 결과는 승인 상태로 구분합니다.
| 상태 | 승인 상태 | 설명 |
|---|---|---|
OPEN | Pending | 승인 또는 검토가 진행 중인 상태 |
OPEN | Approved | 승인 조건이 충족된 상태 |
OPEN | Rejected | 승인되지 않고 반려된 상태 |
CLOSED | Merged | 승인 후 기준 브랜치에 병합된 상태 |
CLOSED | Canceled | 풀 리퀘스트가 취소된 상태 |
풀 리퀘스트 상세
풀 리퀘스트 목록에서 항목을 선택하면 상세 페이지로 이동합니다. 상세 페이지에서는 풀 리퀘스트의 기본 정보, 활동, 커밋, 변경 파일을 확인할 수 있습니다.
세부 정보
상세 페이지의 세부 정보에서는 풀 리퀘스트 이름, 브랜치, 생성자, 리뷰어, 상태, 승인 규칙, 승인 상태를 확인할 수 있습니다. 생성자는 풀 리퀘스트를 취소·병합·삭제할 수 있으며, 리뷰어는 풀 리퀘스트를 승인·반려하거나 리뷰를 취소할 수 있습니다.
리포지토리의 승인 규칙에 따라 지정된 리뷰어 승인 등 조건을 충족해야 생성자가 병합할 수 있습니다.
활동
풀 리퀘스트에 대한 의견이나 검토 내용을 코멘트로 작성할 수 있으며, 상태 변경과 리뷰어 변경 등 주요 변경 이력을 시간순으로 확인할 수 있습니다.
커밋
커밋 목록에서는 커밋 메시지 , 커밋 ID, 작성자, 커밋 일시를 확인할 수 있습니다.
변경된 파일
변경 파일 목록에서 파일별 변경 내용(diff)과 추가·삭제된 라인 수를 확인할 수 있습니다. 변경 내용은 통합 보기 또는 분할 보기 방식으로 제공됩니다.
- 파일 경로를 확인하거나 복사할 수 있습니다.
- 파일 보기를 클릭하면 코드 탭의 파일 상세 화면으로 이동합니다.
- 코드 라인 단위로 코멘트를 작성할 수 있습니다. 리뷰어에 본인이 포함되어 있지 않은 경우 자동으로 리뷰어에 추가됩니다. 단, 생성자는 제외됩니다.
1MB를 초과하는 diff 파일은 보기 모드가 제한되므로, 로컬 Git 클라이언트를 사용하여 변경 사항을 확인해 주세요.
풀 리퀘스트 취소/병합/삭제
생성자는 풀 리퀘스트 목록의 [⋮] 버튼 또는 상세 페이지 좌측 상단의 버튼에서 풀 리퀘스트를 취소, 병합, 삭제할 수 있습니다. 풀 리퀘스트를 취소하면 승인 상태가 Canceled로 변경되고, 병합하면 Merged로 변경됩니다. 삭제한 풀 리퀘스트는 목록에서 제거됩니다.
풀 리퀘스트에 대한 취소/병합/삭제는 생성자만 가능합니다.
- 코드 충돌이 발생한 경우 코드를 수정해 충돌을 해결해야 병합할 수 있습니다.
- 변경된 파일이 없는 경우 병합할 수 없습니다. 새 커밋을 푸시해 변경 사항을 추가하거나, 풀 리퀘스트를 취소 또는 삭제해 주세요.
풀 리퀘스트 승인/반려/리뷰 취소
리뷰어는 풀 리퀘스트 목록의 [⋮] 버튼 또는 상세 페이지 좌측 상단의 버튼에서 풀 리퀘스트를 승인, 반려하거나 리뷰를 취소할 수 있습니다. 풀 리퀘스트를 승인하면 승인 상태가 Approved로 변경되고, 반려하면 Rejected로 변경됩니다. 리뷰를 취소하면 승인 상태가 다시 Pending으로 변경됩니다.
풀 리퀘스트에 대한 승인/반려/리뷰 취소는 리뷰어만 가능합니다.