튜토리얼: 머지 리퀘스트 홈페이지에서 머지 리퀘스트 이해하기
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 이 튜토리얼은 머지 리퀘스트 관리를 위한 새로운 사용자 인터페이스를 소개합니다. 검토를 기다리는 작성자이든, 피드백을 제공하는 검토자이든, 이 페이지는 작업을 추적하는 데 도움이 됩니다.
히스토리
이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참조하세요.
이 튜토리얼은 머지 리퀘스트 관리를 위한 새로운 사용자 인터페이스를 소개합니다.
검토를 기다리는 작성자이든, 피드백을 제공하는 검토자이든, 이 페이지는 작업을 추적하는 데 도움이 됩니다. 작업을 명확한 카테고리로 분류하여 다음을 수행할 수 있도록 합니다:
- 주의가 필요한 머지 리퀘스트를 추적하는 시간을 줄입니다.
- 가장 긴급한 작업에 먼저 집중합니다.
- 기여 상태를 확인합니다.
- 진행 중인 작업이 잊혀지는 것을 방지합니다.
- 코드 리뷰 속도를 향상시킵니다.
실제 동작 확인#
GitLab.com에서 머지 리퀘스트 홈페이지를 보려면:
- Shift+m 키보드 단축키를 사용합니다.
- 왼쪽 사이드바에서 Merge requests를 선택합니다.
세 개의 탭으로 구성되어 있어 지금 당장 주의가 필요한 것에 집중하면서 다른 최근 작업에도 접근할 수 있습니다:
- Active: 이 머지 리퀘스트는 귀하 또는 팀원의 주의가 필요합니다.
- Merged: 이 머지 리퀘스트는 지난 14일 내에 머지되었으며 귀하가 담당자 또는 검토자였습니다.
- Search: 모든 머지 리퀘스트를 검색하고 필요에 따라 필터링합니다.
GitLab은 모든 페이지의 오른쪽 상단 모서리에 Active 머지 리퀘스트의 총 수를 표시합니다. 예를 들어 이 사용자는:
- 8개의 열린 이슈 ([work-item-issue])
- 3개의 활성 머지 리퀘스트 ([merge-request-open])
- 6개의 할 일 항목 ([todo-done])
각 테이블 행은 머지 리퀘스트에 관한 관련 정보를 열별로 그룹화합니다:
- Status - 머지 리퀘스트의 현재 상태.
- Title - 이슈에 대한 중요한 메타데이터:
- 머지 리퀘스트 제목.
- 담당자의 아바타.
- 추가 및 제거된 파일 수와 라인 수 (
+/-). - 마일스톤.
- Author - 작성자의 아바타.
- Reviewers - 검토자의 아바타. 녹색 체크 표시가 있는 검토자는 머지 리퀘스트를 승인했습니다.
- Checks - 머지 가능성에 대한 간결한 평가.
- 열린 스레드 수, 예:
0 of 3. - 현재 필수 승인 상태.
- 가장 최근 파이프라인 상태.
- 마지막 업데이트 날짜.
- 열린 스레드 수, 예:
표시 환경설정 설정#
오른쪽 상단에서 Display preferences ([preferences])를 선택하여 머지 리퀘스트를 정렬합니다:
- Workflow. 이 보기는 머지 리퀘스트를 상태별로 그룹화합니다. 작성자이든 검토자이든 상관없이 주의가 필요한 머지 리퀘스트가 먼저 표시됩니다.
- Role. 이 보기는 검토자인지 작성자인지에 따라 머지 리퀘스트를 그룹화합니다.
Workflow 보기에서 Active 탭은 다음 순서로 머지 리퀘스트를 정렬합니다:
- Returned to you
- Review requested
- Your merge requests
이러한 상태의 머지 리퀘스트는 Active 개수에서 제외됩니다:
- Waiting for assignee
- Waiting for approvals
- Approved by you
- Approved by others
Role 보기에서 Active 탭은 다음 순서로 머지 리퀘스트를 정렬합니다:
- Reviewer (Active)
- Reviewer (Inactive)
- Your merge requests (Active)
- Your merge requests (Inactive)
Role 보기 이해#
Role 보기는 귀하가 담당자 또는 검토자인 머지 리퀘스트를 그룹화합니다:
- Reviewer (Active): 귀하의 검토를 기다리고 있습니다.
- Reviewer (Inactive): 이미 귀하가 검토했습니다.
- Your merge requests (Active)
- Your merge requests (Inactive)
Active 목록의 머지 리퀘스트는 왼쪽 사이드바에 표시된 총계에 포함됩니다.
Workflow 보기 이해#
Workflow 보기는 머지 리퀘스트를 검토 프로세스의 위치에 따라 그룹화합니다. 이 보기는 다음에 취해야 할 조치를 이해하는 데 도움이 됩니다:
소스 코드 보기
%%{init: { "fontFamily": "GitLab Sans" }}%%
flowchart LR
accTitle: Understand the Workflow view
accDescr: Diagram showing how workflow view groups merge requests and where they are in the review process
A[Create a<br>merge request] --> B{Reviewers<br>added?}
B-->|Yes| D[<strong>Review<br>requested</strong>]
B -.->|No| C[<strong>Assigned<br>to you</strong>]
D -->|Approved| E[<strong>Approved<br>by others</strong>]
D -..->|Changes<br>requested| F[<strong>Returned<br>to you</strong>]
F -->|Author<br>makes changes| D
E -->G{All<br>approvals?}
G -->|Yes| K[Ready to merge!]
G -.->|No| J[Remains in<br><strong>Waiting for approvals</strong>]</code></pre></details></div>
이 검토 흐름은 다음을 가정합니다:
- Assignee는 머지 리퀘스트의 작성자입니다.
- Reviewers는 머지 리퀘스트의 작업을 검토하는 사용자입니다.
- 검토자는 Start a review와
Submit a review 기능을 사용합니다.
Active 상태 중 하나에 있는 머지 리퀘스트는 왼쪽 사이드바에 표시된 총계에 포함됩니다:
- 활성 상태: Returned to you, Review requested, Your merge requests
- 비활성 상태: Waiting for assignee, Waiting for approvals, Approved by you, Approved by others
Workflow 보기: 활성 상태#
이 머지 리퀘스트는 귀하 또는 팀원의 주의가 필요합니다.
Returned to you#
검토자가 피드백을 제공하거나 변경을 요청했습니다.
- 다음 단계: 검토자 코멘트를 처리하고 제안된 변경 사항을 구현합니다.
- 상태:
- Changes requested: 검토자가 변경을 요청했습니다.
- Reviewer commented: 검토자가 변경을 요청하지 않고 코멘트를 남겼습니다.
Review requested#
귀하가 이 머지 리퀘스트의 검토자입니다.
- 다음 단계: 머지 리퀘스트를 검토합니다. 승인 및 피드백을 제공합니다. 필요 시 변경을 요청합니다.
- 상태:
- Requested: 아직 검토를 시작하지 않았습니다.
- Review started: 검토를 시작했지만 아직 완료하지 않았습니다.
Your merge requests#
귀하가 머지 리퀘스트 작성자 또는 담당자입니다. 아직 검토자를 추가하지 않았습니다.
- 다음 단계: 검토 프로세스를 시작하기 위해 검토자를 추가합니다.
- 상태:
- Draft: 머지 리퀘스트가 초안으로 표시됩니다.
- Reviewers needed: 머지 리퀘스트가 초안이 아니지만 검토자가 없습니다.
Workflow 보기: 비활성 상태#
Active 탭은 진행 중인 모든 머지 리퀘스트를 상태별로 정렬하여 표시합니다.
지금 당장 귀하의 조치가 필요하지 않기 때문에 이 머지 리퀘스트는 활성 개수에서 제외됩니다:
Waiting for assignee#
승인을 기다리는 귀하의 할당된 머지 리퀘스트와 귀하가 변경을 요청한 검토.
- 다음 단계: 검토 및 승인을 기다립니다.
- 상태:
- You requested changes: 귀하가 검토를 완료하고 변경을 요청했습니다.
- You commented: 귀하가 코멘트를 달았지만 검토를 완료하지 않았습니다.
Waiting for approvals#
승인을 기다리는 귀하의 할당된 머지 리퀘스트와 귀하가 변경을 요청한 검토.
- 다음 단계: 모든 승인 요구사항이 충족될 때까지 기다립니다.
- 상태:
- Approvals required - 남은 필수 승인 수.
- Approved - 귀하가 승인했거나 모든 필수 승인이 충족되었습니다.
- Waiting for approvals.
Approved by you#
귀하가 검토하고 승인한 머지 리퀘스트.
- 다음 단계: 다른 승인 및 다른 머지 요구사항이 충족될 때까지 기다립니다.
- 상태:
- Approved - 귀하가 승인했으며 필수 승인이 충족되었습니다.
- Approval required - 귀하가 승인했지만 모든 필수 승인이 충족되지 않았습니다.
Approved by others#
다른 팀 구성원으로부터 승인을 받은 머지 리퀘스트.
- 다음 단계: 모든 요구사항이 충족된 경우 머지할 준비가 될 수 있습니다.
- 상태:
- Approved - 귀하의 머지 리퀘스트가 필요한 승인을 받았습니다.