히스토리

• GitLab 17.0에서 도입되었습니다.

외부 참여자는 GitLab 계정이 없는 사용자로, 이메일로만 이슈나 Service Desk 티켓에 참여할 수 있습니다. 이슈나 티켓의 공개 댓글은 Service Desk 이메일로 알림을 받습니다.

한 이슈나 티켓의 외부 참여자는 최대 10명입니다.

개요는 GitLab Service Desk의 다중 외부 참여자를 참고합니다.

Service Desk 티켓#

GitLab은 Service Desk 티켓의 외부 작성자를 외부 참여자로 추가합니다. 보통 티켓을 생성한 최초 이메일의 From 헤더에 있는 이메일 주소입니다.

Cc 헤더에서 외부 참여자 추가#

기본적으로 GitLab은 Service Desk 티켓을 생성한 이메일의 발신자만 외부 참여자로 추가합니다.

Cc 헤더에 있는 모든 이메일 주소도 Service Desk 티켓에 추가하도록 GitLab을 구성할 수 있습니다. 이 설정은 최초 이메일과 thank_you 이메일에 대한 모든 회신에 적용됩니다.

Cc 헤더에서 추가된 외부 참여자는 티켓에 추가되었음을 알리기 위해 thank_you 이메일 대신 new_participant 이메일을 받습니다.

필수 조건:

• 프로젝트에 대해 Maintainer 또는 Owner 권한이 있어야 합니다.

프로젝트에서 이 설정을 켜려면 다음과 같이 진행합니다:

1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. 왼쪽 사이드바에서 Settings > General을 선택합니다.
3. Service Desk를 확장합니다.
4. Add external participants from the Cc header를 선택합니다.
5. Save changes를 선택합니다.

외부 참여자로서#

외부 참여자는 Service Desk 이메일을 통해 이슈나 티켓의 공개 댓글마다 알림을 받습니다.

알림 이메일에 응답#

외부 참여자는 받은 알림 이메일에 회신할 수 있습니다. 회신하면 이슈나 티켓에 새 댓글이 생성되며, GitLab 사용자 이름 대신 외부 참여자의 이메일 주소가 표시됩니다. 이메일 주소 뒤에는 (external participant)가 붙습니다.

알림 이메일 구독 취소#

외부 참여자는 기본 Service Desk 이메일 템플릿의 구독 취소 링크로 해당 이슈나 티켓의 구독을 취소할 수 있습니다.

thank_you, new_participant, new_note 이메일 템플릿을 사용자 지정하는 경우, %{UNSUBSCRIBE_URL} 플레이스홀더로 템플릿에 구독 취소 링크를 추가할 수 있습니다.

외부 참여자가 구독을 취소하려면 GitLab 인스턴스에 접근할 수 있어야 합니다(예: 공용 인터넷에서). 그렇지 않다면 템플릿에서 구독 취소 링크를 제거하는 방안을 검토합니다.

GitLab이 보내는 이메일에는 지원되는 이메일 클라이언트와 소프트웨어가 외부 참여자의 구독을 자동으로 취소할 수 있는 특수 헤더도 들어 있습니다.

GitLab 사용자로서#

외부 참여자의 이메일 주소를 보려면 프로젝트에 대해 Reporter, Developer, Maintainer, Owner 중 하나의 권한이 있어야 합니다.

다음 조건이 모두 참이면 외부 참여자의 이메일 주소가 가려집니다:

• 프로젝트의 멤버가 아니거나 Guest 권한입니다.
• 이슈나 티켓이 공개(비밀이 아님)입니다.

이때 외부 참여자의 이메일 주소는 다음 위치에서 가려집니다:

• Service Desk 티켓의 작성자 필드.
• 외부 참여자를 언급하는 모든 시스템 노트.
• REST 및 GraphQL API.
• 댓글 편집기 아래의 경고 메시지.

예를 들면 다음과 같습니다:

외부 참여자에게 보내는 알림#

외부 참여자는 이슈의 모든 공개 댓글에 대해 알림을 받습니다. 비공개로 소통하려면 내부 노트를 사용합니다.

외부 참여자는 그 밖의 이슈나 티켓 이벤트에 대해서는 알림을 받지 않습니다.

모든 외부 참여자 보기#

새 댓글에 대해 Service Desk 이메일을 받는 모든 외부 참여자를 한눈에 확인합니다.

필수 조건:

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

모든 외부 참여자 목록을 보려면 다음과 같이 진행합니다:

1. 해당 이슈나 티켓으로 이동합니다.
2. 댓글 편집기까지 스크롤합니다.
3. 이슈나 티켓에 외부 참여자가 있으면 댓글 편집기 아래에 모든 외부 참여자를 나열하는 경고가 표시됩니다.

외부 참여자 추가#

히스토리

• GitLab 18.10에서 일반 공급되었습니다. 기능 플래그 issue_email_participants가 제거되었습니다.

대화에 언제든 참여자를 포함하려면 /add_email 빠른 작업으로 외부 참여자를 추가합니다.

추가되면 외부 참여자는 Service Desk 이메일로 알림을 받기 시작합니다.

새 외부 참여자는 티켓에 추가되었음을 알리는 new_participant 이메일을 받습니다. 수동으로 추가한 외부 참여자에게는 GitLab이 thank_you 이메일을 보내지 않습니다.

/add_email 빠른 작업이 포함된 댓글에 대해서는 알림 이메일이 발송되지 않으므로, 외부 참여자는 별도의 댓글에서 추가하는 것이 좋습니다.

필수 조건:

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

이슈나 티켓에 외부 참여자를 추가하려면 다음과 같이 진행합니다:

1. 해당 이슈나 티켓으로 이동합니다.
2. 빠른 작업 /add_email user@example.com만 포함한 댓글을 추가합니다. 이메일 주소는 최대 6개까지 이어서 지정할 수 있습니다. 예: /add_email user@example.com user2@example.com

성공 메시지와 함께 이메일 주소가 담긴 새 시스템 노트가 표시됩니다.

외부 참여자 제거#

히스토리

• GitLab 18.10에서 일반 공급되었습니다. 기능 플래그 issue_email_participants가 제거되었습니다.

외부 참여자가 더 이상 알림을 받지 않아야 한다면 /remove_email 빠른 작업으로 이슈나 Service Desk 티켓에서 외부 참여자를 제거합니다.

이슈나 티켓에서 제거되면 새 알림을 받지 않습니다. 다만 이전에 받은 이메일에는 계속 회신할 수 있고, 그 회신으로 이슈나 티켓에 새 댓글을 만들 수 있습니다.

필수 조건:

• 프로젝트에 대해 Planner, Reporter, Developer, Maintainer, Owner 중 하나의 권한이 있어야 합니다.
• 이슈나 티켓에 외부 참여자가 한 명 이상 있어야 합니다.

이슈나 티켓에서 기존 외부 참여자를 제거하려면 다음과 같이 진행합니다:

1. 해당 이슈나 티켓으로 이동합니다.
2. 빠른 작업 /remove_email user@example.com만 포함한 댓글을 추가합니다. 이메일 주소는 최대 6개까지 이어서 지정할 수 있습니다. 예: /remove_email user@example.com user2@example.com

성공 메시지와 함께 이메일 주소가 담긴 새 시스템 노트가 표시됩니다.