- 병합 요청의 모든 변경 사항 표시
- 한 번에 하나의 파일 표시
- 변경 사항 인라인으로 비교
- 변경 사항 측면별 비교
- 코멘트 확장 또는 축소
- 화이트스페이스 변경 무시
- 파일을 확인한 것으로 표시
- 병합 요청 충돌을 diff에서 표시
- diff에서 스캐너 검색 결과 표시
- 병합 요청 파일에 댓글 추가
- 이미지에 댓글 추가
- 리소스
병합 요청의 변경 사항
병합 요청(Merge Request)은 귀하의 저장소의 브랜치 내 파일에 대한 변경 세트를 제안합니다. 이러한 변경 사항은 현재 상태와 제안된 변경 사항 간의 차이로 표시됩니다. 기본적으로 diff는 제안된 변경 사항(소스 브랜치)과 대상 브랜치를 비교합니다. 기본적으로 파일의 변경된 부분만 표시됩니다.
이 예시는 텍스트 파일의 변경 내용을 보여줍니다. 기본 구문 강조 테마에서는:
-
현재 버전은 빨간색으로 표시되며 줄 앞에 빼기(
-
) 기호가 있습니다. -
제안된 버전은 초록색으로 표시되며 줄 앞에 더하기(
+
) 기호가 있습니다.
diff의 각 파일 헤더에는 다음이 포함되어 있습니다:
- 이 파일의 모든 변경 사항을 숨기는 파일 내용 숨기기().
- 경로: 이 파일의 전체 경로입니다. 이 경로를 복사하려면 파일 경로 복사()를 선택하십시오.
-
변경된 줄: 이 파일에서 추가된 줄과 삭제된 줄의 수입니다. 형식은
+2 -2
입니다. - 보기됨: 더 많은 변경 사항이 해당 파일에 추가될 때까지 이 파일을 보기됨으로 표시하십시오.
- 이 파일에 대한 일반적인 의견을 남기려면 이 파일에 의견 달기()를 선택하십시오. 특정 줄에 의견을 달지 않고 파일에 의견을 달 수 있습니다.
- 옵션: 더 많은 파일 보기 옵션을 표시하려면()를 선택하십시오.
diff에는 또한 파일 왼쪽에 있는 네비게이션과 의견 보조 기능도 포함되어 있습니다:
- 더 많은 콘텍스트 표시: 이전 20줄()을 선택하여 이전 20줄의 변경되지 않은 내용을 표시하거나 다음 20줄()을 선택하여 다음 20줄의 변경되지 않은 내용을 표시하십시오.
-
줄 번호는 두 개의 열에 표시됩니다. 이전 줄 번호는 왼쪽에 표시되고, 제안된 줄 번호는 오른쪽에 표시됩니다. 줄과 상호작용하려면:
- 의견 옵션을 표시하려면 줄 번호에 마우스를 올려놓으십시오.
- 링크를 복사하려면 Command를 누르고(또는 마우스 오른쪽 단추를 클릭) 줄 번호를 선택한 다음 링크 주소 복사를 선택하십시오.
- 줄을 강조 표시하려면 줄 번호를 선택하십시오.
병합 요청의 모든 변경 사항 표시
병합 요청에 포함된 변경 사항의 diff를 보려면 다음을 수행하십시오:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하여 프로젝트를 찾습니다.
- 코드 > 병합 요청을 선택하고 병합 요청을 찾습니다.
- 병합 요청 제목 아래에서 변경 사항을 선택하십시오.
- 병합 요청이 많은 파일을 변경하는 경우 특정 파일로 직접 이동할 수 있습니다:
- 파일 브라우저 표시()를 선택하거나 F를 눌러 파일 트리를 표시합니다.
- 보고자 하는 파일을 선택하십시오.
- 파일 브라우저를 숨기려면 파일 브라우저 표시를 선택하거나 F를 다시 누르십시오.
다양한 변경 사항이 있는 파일은 성능 향상을 위해 축소됩니다. GitLab은 다음과 같은 메시지를 표시합니다: 일부 변경 내용이 표시되지 않았음. 해당 파일의 변경 사항을 보려면 파일 확장을 선택하십시오.
생성된 파일 축소
- GitLab 16.8에서 도입되었으며 플래그인
collapse_generated_diff_files
로 비활성화됨. 기본적으로 비활성화됨.- GitLab 16.10에서 GitLab.com 및 셀프매니지드에서 활성화됨.
리뷰어가 코드 검토를 수행하는 데 필요한 파일에 집중할 수 있도록, GitLab은 여러 종류의 일반적으로 생성된 파일을 축소합니다. 이러한 파일은 코드 검토가 필요하지 않을 가능성이 낮기 때문에 기본적으로 축소됩니다:
-
.nib
,.xcworkspacedata
, 또는.xcurserstate
확장자가 있는 파일. -
package-lock.json
또는Gopkg.lock
과 같은 패키지 락 파일. -
node_modules
폴더 내의 파일. - 최소화된
js
또는css
파일. - 소스 맵 참조 파일.
- 프로토콜 버퍼 컴파일러에 의해 생성된 Go 파일.
파일이나 경로를 생성된 것으로 표시하려면, .gitattributes
파일에서 해당 파일에 대해 gitlab-generated
속성을 설정하십시오.
파일 축소된 상태로 보기
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
- Code > 병합 요청을 선택하고 병합 요청을 찾습니다.
- 병합 요청 제목 아래에서 변경 사항을 선택합니다.
- 보려는 파일을 찾아 파일 확장을 선택합니다.
파일 유형에 대한 축소 동작 구성
파일 유형의 기본 축소 동작을 변경하려면:
- 프로젝트의 루트 디렉터리에
.gitattributes
파일이 없는 경우, 이 이름의 빈 파일을 만듭니다. -
수정하려는 각 파일 유형에 대해
.gitattributes
파일에 라인을 추가하여 파일 확장자와 원하는 동작을 선언합니다:# .txt 확장자를 가진 모든 파일 축소 *.txt gitlab-generated # docs 디렉토리 내의 모든 파일 축소 docs/** gitlab-generated # package-lock.json은 축소하지 않음 package-lock.json -gitlab-generated
- 변경 사항을 커밋하고 푸시하여 기본 브랜치에 병합합니다.
이러한 변경 사항이 기본 브랜치로 병합되면, 프로젝트의 해당 유형의 모든 파일이 병합 요청에서 이 동작을 사용합니다.
생성된 파일이 어떻게 감지되는지에 대한 기술적인 세부 정보는
go-enry
리포지토리를 참조하세요.
한 번에 하나의 파일 표시
대규모 병합 요청의 경우 한 번에 하나의 파일을 검토할 수 있습니다. 이 설정을 병합 요청에서 일시적으로 변경하거나 모든 병합 요청에 적용할 수 있습니다.
이 병합 요청 전용
특정 병합 요청에 대한 보기 환경 설정을 임시로 변경하려면:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
- Code > 병합 요청을 선택하고 병합 요청을 찾습니다.
- 병합 요청 제목 아래에서 변경 사항을 선택합니다.
- 환경 설정 ()을 선택합니다.
- 한 번에 하나의 파일 표시 확인란을 선택하거나 선택 해제합니다.
이 변경은 사용자 설정에서의 선택을 재정의합니다. 브라우저의 쿠키를 지우거나 이 동작을 다시 변경할 때까지 유지됩니다.
모든 병합 요청에 대해
모든 병합 요청의 파일을 한 번에 하나씩 보려면:
- 왼쪽 사이드바에서 사용자 아바타를 선택합니다.
- 사용자 설정을 선택합니다.
- 동작 섹션으로 스크롤하고 병합 요청의 변경 탭에서 한 번에 하나의 파일 표시 확인란을 선택합니다.
- 변경 사항 저장을 선택합니다.
이 설정을 활성화한 후 GitLab은 병합 요청 검토 시 한 번에 하나의 파일만 표시합니다. 다른 변경된 파일 보려면 다음 중 하나를 수행합니다:
- 파일의 끝까지 스크롤하여 이전 또는 다음을 선택합니다.
- 파일 브라우저 표시 ()를 선택하고 표시할 다른 파일을 선택합니다.
변경 사항 인라인으로 비교
변경 내용을 인라인으로 볼 수 있습니다:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
- Code > 병합 요청을 선택하고 병합 요청을 찾습니다.
- 제목 아래에서 변경 사항을 선택합니다.
- 환경 설정 ()을 선택합니다.
- 변경 비교 영역에서 인라인을 선택합니다.
변경 사항은 기존 텍스트 이후에 표시됩니다.
변경 사항 측면별 비교
병합 요청의 변경 사항이 긴 경우, 변경 사항을 인라인이나 측면별로 볼 수 있습니다:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
- Code > 병합 요청을 선택하고 병합 요청을 찾습니다.
- 제목 아래에서 변경 사항을 선택합니다.
- 환경 설정 ()을 선택합니다.
- 변경 비교 영역에서 측면별을 선택합니다.
변경 사항이 서로 반대편에 표시됩니다.
코멘트 확장 또는 축소
코드 변경을 검토하는 경우 인라인 코멘트를 숨길 수 있습니다:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
- Code > 병합 요청을 선택하고 병합 요청을 찾습니다.
- 제목 아래에서 변경 사항을 선택합니다.
- 코멘트를 숨기려는 파일로 스크롤합니다.
- 코멘트가 연결된 행으로 스크롤하고 축소 ()를 선택합니다:
인라인 코멘트를 확장하여 다시 표시하려면:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
- Code > 병합 요청을 선택하고 병합 요청을 찾습니다.
- 제목 아래에서 변경 사항을 선택합니다.
- 표시하려는 축소된 코멘트를 포함하는 파일로 스크롤합니다.
- 코멘트가 연결된 행으로 스크롤하고 사용자 아바타를 선택합니다:
화이트스페이스 변경 무시
화이트스페이스 변경은 병합 요청에서 실질적인 변경 내용을 더 어렵게 파악할 수 있습니다. 화이트스페이스 변경 사항을 숨기거나 표시할 수 있습니다:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
- 코드 > 병합 요청을 선택하고 병합 요청을 찾습니다.
- 제목 아래에서 변경 사항을 선택합니다.
- 변경된 파일 목록 앞에서 환경설정 ()을 선택합니다.
-
화이트스페이스 변경 표시 확인란을 선택하거나 선택 해제합니다:
파일을 확인한 것으로 표시
- GitLab 13.9에서 도입됨 (기본으로 활성화된
local_file_reviews
라는 플래그와 함께).- GitLab 14.3에서 기능 플래그가 제거됨.
많은 파일이 포함된 병합 요청을 여러 번 검토할 때 이미 검토한 파일을 무시할 수 있습니다. 마지막 검토 이후 변경되지 않은 파일을 숨기려면:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
- 코드 > 병합 요청을 선택하고 병합 요청을 찾습니다.
- 제목 아래에서 변경 사항을 선택합니다.
- 파일 헤더에서 확인한 것으로 표시 확인란을 선택합니다.
확인한 것으로 표시된 파일은 해당 내용에 새 변경이 있는 경우 또는 확인한 것으로 표시 확인란을 지우는 경우에만 다시 표시됩니다.
병합 요청 충돌을 diff에서 표시
- GitLab 13.5에서 도입됨 (기본으로 비활성화된
display_merge_conflicts_in_diff
라는 플래그와 함께).- GitLab 15.7에서 GitLab.com 및 자체 호스팅에서 활성화됨.
- GitLab 15.8에서 일반 사용 가능. 기능 플래그
display_merge_conflicts_in_diff
가 제거됨.
diff에서 대상 브랜치에 이미 있는 변경 사항을 표시하지 않으려면 병합 요청의 소스 브랜치와 대상 브랜치의 HEAD를 비교합니다.
소스 브랜치와 대상 브랜치 간에 충돌이 있는 경우 병합 요청 diff에서 각 충돌 파일마다 경고를 표시합니다:
diff에서 스캐너 검색 결과 표시
diff에서 스캐너 검색 결과를 표시할 수 있습니다. 자세한 내용은 아래를 참조하세요:
병합 요청 파일에 댓글 추가
- GitLab 16.1에서 도입됨 (기본으로 활성화된
comment_on_files
라는 플래그와 함께).- GitLab 16.2에서 기능 플래그가 제거됨.
병합 요청 diff 파일에 댓글을 추가할 수 있습니다. 이러한 댓글은 리베이스와 파일 변경을 거치더라도 유지됩니다.
병합 요청 파일에 댓글을 추가하려면:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
- 코드 > 병합 요청을 선택하고 병합 요청을 찾습니다.
- 변경 사항을 선택합니다.
- 댓글을 달고 싶은 파일의 헤더에서 댓글 달기 ()를 선택합니다.
이미지에 댓글 추가
병합 요청 및 커밋 상세 보기에서 이미지에 댓글을 추가할 수 있습니다. 이러한 댓글은 스레드가 될 수도 있습니다.
- 이미지 위로 마우스를 가져갑니다.
- 댓글을 달고 싶은 위치를 선택합니다.
이미지 위에 아이콘이 표시되고 댓글 필드가 표시됩니다.
리소스
- 두 리비전 간의 차이를 계산하는 GitLab의 기술적인 세부 정보는 차이점 작업을 참조하세요.