외부 참가자

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

GitLab 17.0에서 소개되었습니다.

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

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

서비스 데스크 티켓

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.
코멘트 편집기 아래의 경고 메시지.

예시:

외부 참가자에게 발송되는 알림

외부 참가자는 이슈에 대한 모든 공개 코멘트에 대해 알림을 받습니다. 비공개 커뮤니케이션을 위해서는 내부 코멘트를 사용하세요.

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

모든 외부 참가자 보기

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

필수 조건:

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

모든 외부 참가자의 디렉터리을 보려면:

이슈나 티켓으로 이동합니다.
아래로 스크롤하여 코멘트 편집기 아래에 있는 경고를 볼 수 있습니다. 외부 참가자 디렉터리이 있는 경고입니다.

외부 참가자 추가

원하는 경우 빠른 조치(quick action) /add_email를 사용하여 대화에 참여하고 싶은 외부 참가자를 추가할 수 있습니다.

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

새로운 외부 참가자는 new_participant 이메일을 받아 티켓에 추가되었음을 알 수 있습니다. GitLab은 매뉴얼으로 추가된 외부 참가자에게 thank_you 이메일을 보내지 않습니다.

외부 참가자는 자신에게 알림 이메일을 받지 못하는 주석에 대해 알림 이메일을 받지 않습니다.

필수 조건:

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

이슈나 티켓에 외부 참가자를 추가하려면:

이슈나 티켓으로 이동합니다.
/add_email user@example.com와 같은 빠른 조치를 포함하는 주석을 추가합니다. 최대 6개의 이메일 주소를 연달아 입력할 수 있습니다. 예: /add_email user@example.com user2@example.com

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

외부 참가자 제거

알림을 더 이상 받으면 안 되는 외부 참가자를 이슈 또는 서비스 데스크 티켓에서 /remove_email 빠른 조치를 사용하여 제거할 수 있습니다.

이슈나 티켓에서 제거된 외부 참가자는 새로운 알림을 받지 않습니다. 하지만 그들은 이전에 받은 이메일에 회신할 수 있고 새로운 코멘트를 이슈나 티켓에 추가할 수 있습니다.

필수 조건:

해당 프로젝트에서 적어도 Reporter 역할이 있어야 합니다.
이슈나 티켓에 최소한 하나의 외부 참가자가 있어야 합니다.

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

이슈나 티켓으로 이동합니다.
/remove_email user@example.com와 같은 빠른 조치를 포함하는 주석을 추가합니다. 최대 6개의 이메일 주소를 연달아 입력할 수 있습니다. 예: /remove_email user@example.com user2@example.com

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

외부 참가자