GitLab 인스턴스의 이메일 전송에 Mailgun을 사용하고 GitLab에서 Mailgun 통합을 켜고 구성하면, 전송 실패를 추적하는 Mailgun 웹훅을 받을 수 있습니다. 통합을 설정하려면 다음 작업이 필요합니다.

1. Mailgun 도메인 구성.
2. Mailgun 통합 활성화.

통합을 완료하면 Mailgun의 temporary_failure 웹훅과 permanent_failure 웹훅이 GitLab 인스턴스로 전송됩니다.

Mailgun 도메인 구성#

GitLab에서 Mailgun을 켜기 전에, 웹훅을 받을 Mailgun 엔드포인트를 직접 설정합니다.

Mailgun 웹훅 가이드를 참고해 다음과 같이 설정합니다.

1. Event type을 Permanent Failure로 설정한 웹훅을 추가합니다.

2. 인스턴스의 URL을 입력하고 /-/mailgun/webhooks 경로를 포함합니다.

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

   https://myinstance.gitlab.com/-/mailgun/webhooks
   

3. Event type을 Temporary Failure로 설정한 웹훅을 하나 더 추가합니다.

4. 인스턴스의 URL을 입력하고 동일한 /-/mailgun/webhooks 경로를 사용합니다.

Mailgun 통합 활성화#

웹훅 엔드포인트를 위한 Mailgun 도메인 구성을 마치면, Mailgun 통합을 켤 수 있습니다.

1. Administrator 사용자로 GitLab에 로그인합니다.
2. 오른쪽 상단에서 Admin을 선택합니다.
3. 왼쪽 사이드바에서 Settings > General로 이동해 Mailgun 섹션을 확장합니다.
4. Enable Mailgun event receiver 체크박스를 선택합니다.
5. Mailgun HTTP 웹훅 서명 키를 입력합니다. 이 키는 Mailgun 문서에 설명되어 있으며 Mailgun 계정의 API 보안(https://app.mailgun.com/app/account/security/api_keys) 섹션에 표시됩니다.
6. Save changes를 선택합니다.