외부 참가자

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed

GitLab 17.0에서 소개됨.

외부 참가자는 GitLab 계정이 없는 사용자로, 이메일을 통해 이슈 또는 서비스 데스크 티켓과 상호 작용할 수 있습니다. 이들은 이슈나 티켓에 대한 공개 코멘트에 대한 알림을 서비스 데스크 이메일을 통해 받을 수 있습니다.

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

개요는 GitLab 서비스 데스크에서 다중 외부 참가자를 참조하세요.

서비스 데스크 티켓

GitLab은 서비스 데스크 티켓의 외부 작성자를 외부 참가자로 추가합니다. 보통 그것은 티켓을 생성한 초기 이메일의 ‘From’ 헤더에서의 이메일 주소입니다.

`Cc` 헤더에서 외부 참가자 추가

기본적으로 GitLab은 서비스 데스크 티켓을 생성한 이메일의 발신자만 외부 참가자로 추가합니다.

GitLab을 구성하여 Cc 헤더의 모든 이메일 주소도 서비스 데스크 티켓에 추가할 수 있습니다. 이 기능은 초기 이메일과 thank_you 이메일에 대한 모든 답변에 대하여 작동합니다.

Cc 헤더에서 추가된 외부 참가자는 thank_you 이메일이 아닌 new_participant 이메일을 받아 티켓에 추가되었음을 알 수 있습니다.

사전 요구 사항:

프로젝트에 적어도 Maintainer 역할이 있어야 합니다.

프로젝트에서 설정을 활성화하려면 다음 단계를 수행하세요:

왼쪽 사이드바에서 검색 또는 이동을 선택하여 프로젝트를 찾습니다.
설정 > 일반을 선택합니다.
서비스 데스크를 확장합니다.
Cc 헤더에서 외부 참가자 추가를 선택합니다.
변경 사항 저장을 선택합니다.

외부 참가자로서

외부 참가자는 이슈나 티켓에 대한 각 공개적 코멘트에 대한 알림을 받습니다. 이를 통해 서비스 데스크 이메일을 사용합니다.

알림 이메일에 회신

외부 참가자는 받은 알림 이메일에 회신할 수 있습니다. 이로써 이슈나 티켓에 새로운 코멘트가 생성되며, GitLab 사용자명 대신 외부 참가자의 이메일 주소가 표시됩니다. 이메일 주소 뒤에는 (external participant)가 표시됩니다.

알림 이메일 구독 취소

외부 참가자는 기본 서비스 데스크 이메일 템플릿에서 구독 취소 링크를 사용하여 이슈나 티켓의 구독을 취소할 수 있습니다.

만약 감사(thank_you), 새로운 참가자(new_participant), 새로운 노트(new_note) 이메일 템플릿을 사용자 정의하는 경우, 해당 템플릿에 구독 취소 링크인 %{UNSUBSCRIBE_URL} 플레이스홀더를 추가할 수 있습니다.

외부 참가자가 성공적으로 구독을 취소하려면 GitLab 인스턴스가 접근 가능해야 합니다(예: 공개 인터넷에서). 그렇지 않은 경우 템플릿에서 구독 취소 링크를 제거하는 것을 고려해 보세요.

GitLab 사용자로서

외부 참가자의 이메일 주소를 보려면 프로젝트에 적어도 Reporter 역할이 있어야 합니다.

다음 두 가지 조건이 모두 참인 경우 외부 참가자의 이메일 주소가 숨겨집니다:

프로젝트의 구성원이 아니거나 Guest 역할 권한이 있는 경우
이슈나 티켓이 공개적인(기밀 아님)인 경우

이에 따라 외부 참가자의 이메일 주소가 다음에서 숨겨집니다:

서비스 데스크 티켓의 작성자 필드
외부 참가자를 언급하는 시스템 노트의 모든 내용
REST 및 GraphQL API
코멘트 편집기 아래의 경고 메시지

예시:

외부 참가자에게 발송된 알림

외부 참가자는 이슈에 대한 모든 공개 코멘트에 대해 알림을 받습니다. 비밀 통신을 위해서는 내부 코멘트(internal notes)를 사용하세요.

외부 참가자는 다른 이슈나 티켓 이벤트에 대해 알림을 받지 않습니다.

모든 외부 참가자 보기

새로운 코멘트에 대한 서비스 데스크 이메일을 수신하는 모든 외부 참가자에 대한 개요를 얻을 수 있습니다.

사전 요구 사항:

프로젝트에 적어도 Reporter 역할이 있어야 합니다.

외부 참가자 목록을 보려면 다음 단계를 수행하세요:

이슈나 티켓으로 이동합니다.
코멘트 편집기 아래로 스크롤합니다.
이슈나 티켓이 외부 참가자를 가지고 있는 경우, 코멘트 편집기 아래에 경고가 표시되며 모든 외부 참가자 목록이 나열됩니다.

외부 참가자 추가

GitLab 13.8에서 issue_email_participants라는 플래그로 추가됨. 기본적으로 활성화됨.

이 기능의 가용성은 feature flag에 의해 제어됩니다. 자세한 내용은 이력을 참조하세요.

어느 시점에서라도 대화에 그들을 포함시키고자 할 때, /add_email 빠른 조치(quick action)를 사용하여 외부 참가자를 추가하세요.

추가되면 외부 참가자는 서비스 데스크 이메일을 통해 알림을 받기 시작합니다.

새로운 외부 참가자는 티켓에 추가되었음을 알리는 new_participant 이메일을 받지만, 수동으로 추가된 외부 참가자에게는 thank_you 이메일이 전송되지 않습니다.

외부 참가자가 /add_email 빠른 조치를 포함하는 코멘트에 대한 알림 이메일을 받지 않기 때문에, 외부 참가자를 전용 코멘트에 추가해야 합니다.

사전 요구 사항:

프로젝트에 적어도 Reporter 역할이 있어야 합니다.

이슈나 티켓에 외부 참가자를 추가하려면 다음 단계를 수행하세요:

이슈나 티켓으로 이동합니다.
단일로 /add_email user@example.com 빠른 조치를 포함하는 코멘트를 추가합니다. 최대 6개의 이메일 주소를 연결할 수 있습니다. 예: /add_email user@example.com user2@example.com

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

외부 참가자 제거

GitLab 13.8에서 도입됨, issue_email_participants이라는 플래그로 기본으로 활성화됨.

플래그: 이 기능의 가용성은 기능 플래그로 제어됩니다. 자세한 정보는 이력을 참조하십시오.

알림을 더 이상 받지 말아야 하는 경우 /remove_email 빠른 동작을 사용하여 이슈나 서비스 데스크 티켓에서 외부 참가자를 제거하세요.

이슈나 티켓에서 그들을 제거한 후에는 새로운 알림을 받지 않습니다. 하지만 그들은 이전에 받은 이메일에 회신하거나 이슈나 티켓에 새로운 코멘트를 생성할 수 있습니다.

필수 조건:

프로젝트에 대한 적어도 리포터 역할이 있어야 합니다.
이슈나 티켓에서 적어도 하나의 외부 참가자가 있어야 합니다.

이슈나 티켓에서 기존의 외부 참가자를 삭제하려면:

해당 이슈나 티켓으로 이동합니다.
/remove_email user@example.com이라는 빠른 동작만 포함하는 코멘트를 추가합니다. 최대 6개의 이메일 주소를 연결할 수 있습니다. 예: /remove_email user@example.com user2@example.com

성공 메시지와 해당 이메일 주소가 있는 새로운 시스템 노트가 표시되어야 합니다.

외부 참가자