Mattermost 알림 통합을 사용하면 GitLab 이벤트(예: issue created)에 대한 알림을 Mattermost로 보낼 수 있습니다. Mattermost와 GitLab을 모두 구성해야 합니다.

Mattermost 슬래시 명령을 사용하여 Mattermost 안에서 GitLab을 제어할 수도 있습니다.

GitLab 알림을 수신하도록 Mattermost 구성#

Mattermost 통합을 사용하려면 Mattermost에서 수신 웹훅 통합을 생성해야 합니다.

1. Mattermost 인스턴스에 로그인합니다.
2. 수신 웹훅을 활성화합니다.
3. 수신 웹훅을 추가합니다.
4. 표시 이름, 설명, 채널을 선택합니다. 이 값은 GitLab에서 재정의할 수 있습니다.
5. 저장한 다음 GitLab에 필요한 웹훅 URL을 복사합니다.

Mattermost 인스턴스에서 수신 웹훅이 차단되어 있을 수 있습니다. 이 경우 Mattermost 관리자에게 다음 위치에서 켜 달라고 요청합니다.

• Mattermost 5.12 이상 버전에서는 Mattermost System Console > 통합 > 통합 관리 입니다.
• Mattermost 5.11 이하 버전에서는 Mattermost System Console > 통합 > 사용자 지정 통합 입니다.

표시 이름 재정의는 기본적으로 꺼져 있습니다. 관리자에게 같은 섹션에서 켜 달라고 요청합니다.

Mattermost에 알림을 보내도록 GitLab 구성#

Mattermost 인스턴스에 수신 웹훅을 설정한 뒤에는 GitLab에서 알림을 보내도록 설정할 수 있습니다.

1. 상단 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.

2. 왼쪽 사이드바에서 설정 > 통합을 선택합니다.

3. Mattermost 알림을 선택합니다.

4. 알림을 생성할 GitLab 이벤트를 선택합니다. 선택한 각 이벤트마다 알림을 받을 Mattermost 채널을 최대 10개까지 입력합니다. 해시 기호(#)는 추가하지 않아도 됩니다.

5. 통합 구성을 채웁니다.

   • 웹훅: Mattermost의 수신 웹훅 URL이며, http://mattermost.example/hooks/5xo…와 비슷한 형식입니다.
   • 사용자 이름: 선택 사항. Mattermost로 보내는 메시지에 표시되는 사용자 이름입니다. 봇의 사용자 이름을 바꾸려면 값을 입력합니다.
   • 실패한 파이프라인만 알림: 파이프라인 이벤트를 선택했고 실패한 파이프라인에 대한 알림만 받으려는 경우에 사용합니다.
   • 상태 변경 시에만 알림: 파이프라인 이벤트를 선택했고 ref의 파이프라인 상태가 변경될 때만 알림을 받으려는 경우에 사용합니다.
   • 알림을 보낼 브랜치: 알림을 보낼 대상 브랜치입니다.
   • 알림을 받을 레이블: 선택 사항. 이슈나 머지 리퀘스트가 알림을 트리거하려면 갖춰야 하는 레이블입니다. 모든 이슈와 머지 리퀘스트에 알림을 보내려면 비워 둡니다.
   • 알림을 받을 레이블 동작: 알림을 받을 레이블 필터를 사용하면 이슈나 머지 리퀘스트에 필터에 지정한 레이블 중 하나라도 포함될 때 메시지가 전송됩니다. 이슈나 머지 리퀘스트에 필터에 정의한 레이블이 모두 포함된 경우에만 메시지를 보내도록 선택할 수도 있습니다.