히스토리

• GitLab 17.7에서 wiki_comments라는 기능 플래그와 함께 위키 페이지의 댓글과 스레드가 도입되었습니다. 기본적으로 비활성화되어 있습니다.
• GitLab 17.9에서 위키 페이지의 댓글과 스레드가 일반 공급되었습니다. 기능 플래그 wiki_comments가 제거되었습니다.

GitLab은 댓글, 스레드, 코드 변경 제안을 통한 소통을 권장합니다. 댓글은 Markdown과 빠른 작업을 지원합니다.

댓글은 두 가지 유형을 사용할 수 있습니다:

• 표준 댓글.
• 스레드 안의 댓글이며, 해결할 수 있습니다.

커밋 diff 댓글에서 코드 변경을 제안할 수 있으며, 상대 사용자는 사용자 인터페이스에서 이를 수락할 수 있습니다.

댓글을 추가할 수 있는 위치#

다음과 같은 위치에서 댓글을 생성할 수 있습니다:

• 커밋 diff.
• 커밋.
• 디자인.
• 에픽.
• 이슈.
• 머지 리퀘스트.
• 스니펫.
• 태스크.
• OKR.
• 위키 페이지.

각 객체는 최대 5,000개의 댓글을 가질 수 있습니다.

멘션#

@username 또는 @groupname으로 GitLab 인스턴스의 사용자나 그룹(하위 그룹 포함)을 멘션할 수 있습니다. GitLab은 멘션된 모든 사용자에게 할 일 항목과 이메일로 알립니다. 사용자는 알림 설정에서 이 설정을 직접 변경할 수 있습니다.

어떤 댓글이 본인과 관련되어 있는지 빠르게 확인할 수 있습니다. GitLab 이 본인(현재 인증된 사용자)에 대한 멘션을 다른 색상으로 강조 표시하기 때문입니다.

작업 항목이나 머지 리퀘스트에서 누군가를 멘션하면 그 사용자는 참여자가 됩니다.

모든 멤버 멘션#

히스토리

• GitLab 16.1에서 disable_all_mention이라는 플래그가 도입되었습니다. GitLab.com에서는 활성화되어 있습니다. GitLab Self-Managed 및 GitLab Dedicated에서는 비활성화되어 있습니다.
• GitLab 18.8.5에서 GitLab Self-Managed 및 GitLab Dedicated에서 활성화되었습니다.
• GitLab 19.0에서 기능 플래그 disable_all_mention 이 제거되었습니다.

댓글과 설명에서 @all 멘션은 피합니다. @all은 프로젝트, 이슈, 머지 리퀘스트의 참여자뿐 아니라 해당 프로젝트 상위 그룹의 모든 멤버를 멘션합니다. 이 사용자 전원이 이메일 알림과 할 일 항목을 받게 되며, 이를 스팸으로 받아들일 수 있습니다.

댓글과 설명에 @all을 입력하면 모든 사용자를 멘션하지 않고 일반 텍스트로 표시됩니다. 이 변경 이전에 Markdown 텍스트에 있던 기존 @all 멘션은 그대로 유지되며 링크로 남습니다.

그룹 설정에서 알림과 멘션을 비활성화할 수 있습니다.

이슈 또는 머지 리퀘스트에서 그룹 멘션#

댓글에서 그룹을 멘션하면 그룹의 모든 멤버의 할 일 목록에 할 일 항목이 추가됩니다.

1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. 머지 리퀘스트 또는 이슈로 이동합니다:
   • 머지 리퀘스트는 Code > Merge requests를 선택하고 해당 머지 리퀘스트를 찾습니다.
   • 이슈는 Plan > Work items를 선택하고 해당 이슈를 찾습니다.
3. 댓글에 @를 입력한 다음 사용자, 그룹, 하위 그룹 네임스페이스를 입력합니다. 예를 들어 @alex, @alex-team, @alex-team/marketing과 같이 입력합니다.
4. Comment를 선택합니다.

GitLab은 모든 그룹 및 하위 그룹 멤버에게 할 일 항목을 생성합니다.

자세한 내용은 하위 그룹 멘션을 참고합니다.

머지 리퀘스트 diff에 댓글 추가#

머지 리퀘스트 diff에 댓글을 추가하면 다음 경우에도 댓글이 유지됩니다:

• 리베이스 후 강제 푸시하는 경우.
• 커밋을 수정(amend)하는 경우.

커밋 diff 댓글을 추가하려면 다음을 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. 왼쪽 사이드바에서 Code > Merge requests를 선택하고 해당 머지 리퀘스트를 찾습니다.
3. Commits 탭을 선택한 다음 커밋 메시지를 선택합니다.
4. 댓글 작성을 시작합니다:
   • 파일 전체에 댓글을 남기려면 대상 파일을 찾은 다음 파일 헤더에서 Comment on this file ([comment])을 선택합니다.
   • 특정 줄에 댓글을 남기려면 대상 줄 번호를 찾습니다. 줄 번호 위에 커서를 올린 다음 Comment ([comment])를 선택합니다. 여러 줄을 선택하려면 Comment ([comment]) 아이콘을 끌어다 놓습니다.
5. 댓글을 입력합니다.
6. 댓글을 제출합니다:
   • 댓글을 즉시 추가하려면 Add comment now를 선택하거나 다음 키보드 단축키를 사용합니다:
     • macOS: Shift+Command+Enter
     • 그 밖의 운영 체제: Shift+Control+Enter
   • 리뷰를 마칠 때까지 댓글을 게시하지 않으려면 Start a review를 선택하거나 다음 키보드 단축키를 사용합니다:
     • macOS: Command+Enter
     • 그 밖의 운영 체제: Control+Enter

댓글은 머지 리퀘스트의 Overview 탭에 표시됩니다.

이 댓글은 프로젝트의 Code > Commits 페이지에는 표시되지 않습니다.

이메일 전송으로 댓글에 답변#

"이메일 답변"을 구성했다면 이메일을 보내 댓글에 답변할 수 있습니다.

• 표준 댓글에 답변하면 또 다른 표준 댓글이 생성됩니다.
• 스레드 댓글에 답변하면 해당 스레드에 답변이 생성됩니다.
• 이슈 이메일 주소로 이메일을 보내면 표준 댓글이 생성됩니다.

이메일 답변에서도 Markdown과 빠른 작업을 사용할 수 있습니다.

댓글 답변 만료#

표준 댓글이나 스레드 댓글을 생성하는 이메일 답변에는 2년의 보존 정책이 적용됩니다.

댓글 수정#

본인이 작성한 댓글은 언제든지 수정할 수 있습니다. Maintainer 또는 Owner 권한이 있는 사용자는 다른 사람이 작성한 댓글도 수정할 수 있습니다.

댓글을 수정하려면 다음을 수행합니다.

1. 댓글에서 Edit comment (✏️)를 선택합니다.
2. 내용을 수정합니다.
3. Save changes를 선택합니다.

멘션을 추가하는 댓글 수정#

히스토리

• GitLab 18.10에서 email_on_added_mentions라는 기능 플래그와 함께 알림 이메일 발송이 도입되었습니다. 기본적으로 비활성화되어 있습니다.
• GitLab 18.11에서 일반 공급되었습니다. 기능 플래그 email_on_added_mentions가 제거되었습니다.

기본적으로 사용자를 멘션하면 GitLab은 해당 사용자에게 할 일 항목을 생성하고 알림 이메일을 보냅니다.

기존 댓글을 수정해 이전에 없던 사용자 멘션을 추가하면 GitLab은 다음을 수행합니다:

• 멘션된 사용자에게 할 일 항목을 생성합니다.
• 멘션된 사용자에게 알림 이메일을 보냅니다.

토론을 잠가 댓글 방지#

이슈나 머지 리퀘스트에서 공개 댓글을 막을 수 있습니다. 잠근 뒤에는 프로젝트 멤버만 댓글을 추가하고 수정할 수 있습니다.

사전 요구 사항:

• 머지 리퀘스트에서는 Developer, Maintainer, Owner 권한 중 하나가 있어야 합니다.
• 이슈에서는 Planner, Reporter, Developer, Maintainer, Owner 권한 중 하나가 있어야 합니다.

이슈 또는 머지 리퀘스트를 잠그려면 다음을 수행합니다.

1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. 머지 리퀘스트 또는 이슈로 이동합니다:
   • 머지 리퀘스트는 Code > Merge requests를 선택하고 해당 머지 리퀘스트를 찾습니다.
   • 이슈는 Plan > Work items를 선택하고 해당 이슈를 찾습니다.
3. 오른쪽 상단 모서리에서 Merge request actions 또는 Issue actions (⋮)를 선택한 다음 Lock discussion을 선택합니다.

GitLab은 페이지 상세 정보에 시스템 노트를 추가합니다.

닫힌 이슈나 머지 리퀘스트를 다시 열려면 먼저 잠겨 있는 토론을 모두 잠금 해제해야 합니다.

기밀 항목에 대한 댓글#

기밀 항목에 접근할 권한이 있는 사용자만 해당 항목의 댓글 알림을 받습니다. 항목이 이전에 기밀이 아니었다면 접근 권한이 없는 사용자가 참여자로 표시될 수 있습니다. 이러한 사용자는 항목이 기밀인 동안에는 알림을 받지 않습니다.

알림을 받을 수 있는 대상:

• 권한과 관계없이 항목에 배정된 사용자.
• Guest, Planner, Reporter, Developer, Maintainer, Owner 권한 중 하나가 있는 경우, 항목을 작성한 사용자.
• 항목이 속한 그룹이나 프로젝트에서 Planner, Reporter, Developer, Maintainer, Owner 권한을 가진 사용자.

내부 노트 추가#

히스토리

• GitLab 18.2에서 GitLab Wiki에 대해 도입되었습니다.

공개 이슈, 에픽, 위키 페이지, 머지 리퀘스트에 추가한 정보를 보호하려면 내부 노트를 사용합니다. 내부 노트는 공개 댓글과 다음과 같이 다릅니다:

• 최소 Reporter 권한이 있는 프로젝트 멤버만 내부 노트를 볼 수 있습니다.
• 내부 노트는 일반 댓글로 변환할 수 없습니다.
• 내부 노트에 대한 모든 답변도 내부 노트가 됩니다.
• 내부 노트에는 Internal note 배지가 표시되며 공개 댓글과 다른 색상으로 표시됩니다:

사전 요구 사항:

• 프로젝트에 대해 Reporter, Developer, Maintainer, Owner 권한 중 하나가 있어야 합니다.

내부 노트를 추가하려면 다음을 수행합니다.

1. 이슈, 에픽, 위키 페이지, 머지 리퀘스트의 Comment 텍스트 상자에 댓글을 입력합니다.
2. 댓글 아래에서 Make this an internal note를 선택합니다.
3. Add internal note를 선택합니다.

이슈 전체를 기밀로 표시하거나 기밀 머지 리퀘스트를 생성할 수도 있습니다.

댓글만 표시#

댓글이 많은 토론에서는 댓글만 표시하거나 변경 기록(시스템 노트)만 표시하도록 필터링할 수 있습니다. 시스템 노트에는 설명 변경, 다른 GitLab 객체에서의 멘션, 레이블, 담당자, 마일스톤 변경이 포함됩니다. GitLab은 이 설정을 저장해 사용자가 보는 모든 이슈, 머지 리퀘스트, 에픽에 적용합니다.

1. 머지 리퀘스트, 이슈, 에픽에서 Overview 탭을 선택합니다.
2. 페이지 오른쪽의 Sort or filter 드롭다운 목록에서 필터를 선택합니다:
   • Show all activity: 모든 사용자 댓글과 시스템 노트를 표시합니다.
   • Show comments only: 사용자 댓글만 표시합니다.
   • Show history only: 활동 노트만 표시합니다.

활동 정렬 순서 변경#

기본 순서를 반대로 바꿔 최신 항목이 위에 오도록 정렬된 활동 피드를 사용할 수 있습니다. GitLab은 이 설정을 로컬 저장소에 저장해 사용자가 보는 모든 이슈, 머지 리퀘스트, 에픽에 적용합니다. 이슈와 에픽은 같은 정렬 설정을 공유하고, 머지 리퀘스트는 별도의 설정을 유지합니다.

활동 정렬 순서를 변경하려면 다음을 수행합니다.

1. 이슈를 열거나, 머지 리퀘스트 또는 에픽에서 Overview 탭을 엽니다.
2. Activity 제목까지 아래로 스크롤합니다.
3. 페이지 오른쪽에서 정렬 순서를 변경합니다:
   • 이슈 및 에픽: Sort or filter 드롭다운 목록에서 Newest first 또는 Oldest first(기본값)를 선택합니다.
   • 머지 리퀘스트: 정렬 방향 화살표 버튼으로 Sort direction: Ascending(오래된 순, 기본값)과 Sort direction: Descending(최신 순)을 전환합니다.

설명 변경 기록 보기#

기록에 나열된 설명 변경 사항을 확인할 수 있습니다.

변경 사항을 비교하려면 Compare with previous version을 선택합니다.

댓글 작성자에게 이슈 배정#

댓글을 작성한 사용자에게 이슈를 배정할 수 있습니다.

1. 댓글에서 More Actions (⋮) 메뉴를 선택합니다.
2. Assign to comment author를 선택합니다.
3. 배정을 해제하려면 이 버튼을 다시 선택합니다.

표준 댓글에 답변하여 스레드 생성#

표준 댓글에 답변하면 스레드가 생성됩니다.

사전 요구 사항:

• Guest, Planner, Reporter, Developer, Maintainer, Owner 권한 중 하나가 있어야 합니다.
• 이슈, 머지 리퀘스트, 에픽에 있어야 합니다. 커밋과 스니펫의 스레드는 지원되지 않습니다.

댓글에 답변해 스레드를 생성하려면 다음을 수행합니다.

1. 댓글의 오른쪽 상단 모서리에서 Reply to comment ([reply])를 선택해 답변 영역을 표시합니다.
2. 답변을 입력합니다.
3. Reply 또는 Add comment now를 선택합니다(답변하는 UI 위치에 따라 다릅니다).

GitLab은 최상위 댓글을 스레드로 변환합니다.

댓글에 답변하지 않고 스레드 생성#

표준 댓글에 답변하지 않고도 스레드를 생성할 수 있습니다.

사전 요구 사항:

• Guest, Planner, Reporter, Developer, Maintainer, Owner 권한 중 하나가 있어야 합니다.
• 이슈, 머지 리퀘스트, 커밋, 스니펫에 있어야 합니다.

스레드를 생성하려면 다음을 수행합니다.

1. 댓글을 입력합니다.
2. 댓글 아래 Comment 오른쪽에서 아래쪽 화살표([chevron-down])를 선택합니다.
3. 목록에서 Start thread를 선택합니다.
4. 다시 Start thread를 선택합니다.

스레드 해결#

히스토리

• GitLab 17.3에서 태스크, 목표, 핵심 결과에 대한 해결 가능한 스레드가 일반 공급되었습니다.
• 에픽의 해결 가능한 스레드:
• GitLab 17.5에서 도입되었습니다. 에픽의 새로운 형태가 활성화되어 있어야 합니다.
• GitLab 18.1에서 일반 공급되었습니다.

대화가 끝나면 스레드를 해결할 수 있습니다. 해결된 스레드는 접히지만 사용자는 계속 댓글을 추가할 수 있습니다.

해결된 스레드는 스레드를 해결할 권한이 있는 사용자가 나중에 다시 열 수 있습니다. 해결된 스레드를 다시 열려면 스레드를 확장하고 Reopen thread를 선택합니다.

사전 요구 사항:

• 에픽, 이슈, 태스크, 목표, 핵심 결과, 머지 리퀘스트에 있어야 합니다.
• Developer, Maintainer, Owner 권한 중 하나가 있거나 해당 이슈 또는 머지 리퀘스트의 작성자여야 합니다.

스레드를 해결하려면 다음을 수행합니다.

1. 해당 스레드로 이동합니다.
2. 다음 중 하나를 수행합니다:
   • 원본 댓글의 오른쪽 상단 모서리에서 Resolve thread ([check-circle])를 선택합니다.
   • 마지막 답변 아래의 Reply 필드에서 Resolve thread를 선택합니다.
   • 마지막 답변 아래의 Reply 필드에 텍스트를 입력하고 Resolve thread 체크박스를 선택한 다음 Add comment now를 선택합니다.

스레드를 다시 열 때도 같은 동작을 수행할 수 있습니다.

머지 리퀘스트는 다음과 같이 더 유연한 스레드 관리 옵션을 제공합니다:

• 열린 스레드를 새 이슈로 이동합니다.
• 모든 스레드가 해결될 때까지 머지를 막습니다.

GitLab Duo Chat으로 이슈 토론 요약#

Model information

• 기본 LLM
• Amazon Q 용 LLM: Amazon Q Developer
• 자체 호스팅 모델을 사용하는 GitLab Duo에서 사용 가능

히스토리

• GitLab 17.3에서 summarize_notes_with_duo라는 기능 플래그와 함께 GitLab Duo로 이동되고 베타로 변경되었습니다. 기본적으로 비활성화되어 있습니다.
• GitLab 17.4에서 기본적으로 활성화되었습니다.
• GitLab 17.6 이상에서 GitLab Duo 애드온이 필요하도록 변경되었습니다.
• GitLab 18.0에서 Premium을 포함하도록 변경되었습니다.

이슈의 토론 요약을 생성합니다.

개요 영상 보기

사전 요구 사항:

• 해당 이슈를 볼 권한이 있어야 합니다.

이슈 토론의 요약을 생성하려면 다음을 수행합니다.

1. 이슈에서 Activity 섹션까지 스크롤합니다.
2. View summary를 선택합니다.

이슈의 댓글이 최대 10개의 목록 항목으로 요약됩니다. 응답을 바탕으로 후속 질문을 할 수 있습니다.

데이터 사용: 이 기능을 사용하면 해당 이슈의 모든 댓글 텍스트가 대규모 언어 모델로 전송됩니다.