[GitLab] 지메일을 SMTP 메일 발송 서버로 설정하자

GitLab의 메일 발송 서버를 지메일로 설정하는 이유

GitLab은 여러가지 알림을 메일로 제공하는 기능이 있다. 메일발송 서버를 로컬에 만들어서 사용하는 방법은 사용하기는 간단하지만 보안적인 측면이나 메일 도달성(관리를 하지 않으면 스팸메일로 분류됨)을 고려하면 적합하지 않다. 그러므로 잘 알려진 메일 발송 서비스를 이용하는 것이 장기적으로 봤을 때 유리하다. 무료로 사용할 수 있는 메일 발송 서버로 가장 흔히 사용하는 것 중 하나로 지메일(Gmail)이 있다. 본 글에서는 지메일로 메일 발송을 하기 위해 GitLab SMTP를 설정하는 방법을 설명한다.

 

1. 지메일 관련 보안 설정을 하고 앱 비밀번호를 발급 받는다.

이 부분은 본 글에서 자세히 설명하지 않는다. 구글 정책과 화면이 자주 바뀌어서 적어놓아도 몇달 후면 의미가 없는 경우가 다수 있었기 때문이다. 앱 비밀번호를 발급 받으면 아래의 사진처럼 비밀번호가 나타난다.

앱 비밀번호가 생성된 화면

반응형

2. SMTP 설정 수정

아래의 명령어로 GitLab 설정 파일로 가서 SMTP(Simple Mail Transfer Protocol) 설정을 아래의 사진처럼 수정한다.

vi /etc/gitlab/gitlab.rb

기존 SMTP 설정

설정을 보면 위의 사진처럼 SMTP 설정이 주석처리 된 것을 알 수 있다. 아래 사진처럼 SMTP 설정을 적절하게 변경한다.

 

변경한 SMTP 설정

3. GitLab 재설정

설정을 수정했으면 GitLab에 반영해야 한다. 아래의 명령어로 GitLab을 재설정한다.

gitlab-ctl reconfigure

재설정 명령어를 실행한 화면

4. 메일 발송 테스트

잘 설정되었는지를 확인하기 위해 메일 발송을 테스트한다. 아래의 명령어를 입력하여 GitLab 콘솔로 진입한다.

gitlab-rails console

아래의 명령어를 입력하여 메일발송을 테스트한다.

Notify.test_email('example@gmail.com', 'GitLab 메일링 테스트입니다', 'GitLab SMTP를 수정하였기에 메일링 테스트를 진행합니다.').deliver_now

메일을 발송한 화면

메일을 수신한 화면

 

메일이 잘 발송되고 잘 수신되었음을 확인할 수 있다.

 

참고문서

1. "SMTP 설정", GitLab 공식문서. @원문보기