Mailgun

Tier: Free, Premium, Ultimate Offering: Self-managed

GitLab 인스턴스에서 이메일을 보내는데 Mailgun을 사용하고 Mailgun 통합이 활성화되어 GitLab에 구성된 경우, 배달 실패를 추적하기 위해 Mailgun의 웹훅을 수신할 수 있습니다. 통합을 설정하려면 다음을 수행해야 합니다:

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

통합을 완료한 후, Mailgun temporary_failure 및 permanent_failure 웹훅이 GitLab 인스턴스로 전송됩니다.

Mailgun 도메인 구성

  • GitLab 15.0에서 /-/members/mailgun/permanent_failures URL이 Deprecated되었습니다.
  • GitLab 15.0에서 일시적 및 영구적 실패 모두를 처리하기 위한 URL로 변경되었습니다.

GitLab에서 Mailgun을 활성화하려면 웹훅을 수신할 자체 Mailgun 엔드포인트를 설정해야 합니다.

Mailgun 웹훅 가이드를 사용하는 방법:

  1. 이벤트 유형을 Permanent Failure로 설정하여 웹훅을 추가합니다.

  2. 인스턴스의 URL과 /-/mailgun/webhooks 경로를 포함합니다.

    예를 들어: 

    https://myinstance.gitlab.com/-/mailgun/webhooks
  3. 이벤트 유형을 Temporary Failure로 설정하여 다른 웹훅을 추가합니다.
  4. 인스턴스의 URL을 입력하고 동일한 /-/mailgun/webhooks 경로를 사용합니다.

Mailgun 통합 활성화

웹훅 엔드포인트를 위해 Mailgun 도메인을 구성한 후, Mailgun 통합을 활성화할 준비가 되었습니다:

  1. 관리자 사용자로 GitLab에 로그인합니다.
  2. 왼쪽 사이드바에서 맨 아래로 스크롤하여 Admin을 선택합니다.
  3. 왼쪽 사이드바에서 설정 > 일반으로 이동하고 Mailgun 섹션을 확장합니다.
  4. Mailgun 활성화 확인란을 선택합니다.
  5. Mailgun HTTP 웹훅 서명 키를 Mailgun 설명서 및 Mailgun 계정의 API 보안(https://app.mailgun.com/app/account/security/api_keys) 섹션에서 표시된대로 입력합니다.
  6. 변경 사항 저장을 선택합니다.