GitLab을 Mattermost에 연결
GitLab 코드 저장소와 커뮤니케이션 플랫폼 간의 컨텍스트 전환을 줄이고 집중력을 높이기 위해 GitLab와 Mattermost를 통합하세요. Mattermost는 GitLab의 SaaS(Software-as-a-Service) 및 온프레미스 버전을 모두 지원합니다.
GitLab 코드 저장소와 커뮤니케이션 플랫폼 간의 컨텍스트 전환을 줄이고 집중력을 높이기 위해 GitLab와 Mattermost를 통합하세요. 머지, 이슈 댓글, 머지 리퀘스트 댓글, 파이프라인, 풀 리뷰 등 기본 이벤트 외에 알림을 트리거할 이벤트를 제어할 수 있습니다. 새로운 및 닫힌 머지 리퀘스트, 새로운 및 닫힌 이슈, 태그 생성 이벤트에 대한 실시간 업데이트와 알림으로 팀이 Mattermost 채널 구독에서 직접 집중력 있게 작업을 이어나갈 수 있도록 합니다.
Mattermost는 GitLab의 SaaS(Software-as-a-Service) 및 온프레미스 버전을 모두 지원합니다.
배포#
Mattermost 시스템 관리자는 다음 단계를 수행하여 GitLab 통합을 배포해야 합니다.
통합 설치#
- Mattermost에서 제품 메뉴 를 열고 앱 마켓플레이스를 선택합니다.
- GitLab을 검색하거나 스크롤하여 찾은 후 설치를 선택합니다.
통합 설정#
내장 설정 마법사(권장) 또는 수동 구성 단계를 따라 GitLab 통합을 구성할 수 있습니다.
GitLab 통합을 구성하는 권장 방법은 내장 설정 마법사를 사용하는 것입니다. 마법사는 GitLab에서 OAuth 앱 만들기를 포함한 각 구성 단계를 안내합니다.
- 모든 Mattermost 채널에서
/gitlab setup슬래시 명령어를 실행합니다. - 대화형 프롬프트를 따라 설정을 완료합니다.
마법사는 다음 과정을 안내합니다:
- GitLab에서 OAuth 앱 만들기 및 구성
- Mattermost에서 플러그인 설정 구성
- 팀에 통합 공지
/gitlab setup oauth: GitLab에서 OAuth2 애플리케이션을 구성합니다./gitlab setup announce: 지정된 채널에 통합 가용성을 공지합니다.
설정 마법사 대신 수동으로 통합을 구성하려면 아래 단계를 따르세요.
GitLab에서 OAuth 앱 등록
https://gitlab.com/-/profile/applications또는https://gitlab.YOURDOMAIN.com/-/profile/applications로 이동하여(YOURDOMAIN.COM을 GitLab URL로 변경) GitLab에 OAuth 앱을 등록합니다.- 다음 값을 설정합니다:
- Name:
Mattermost GitLab Plugin - <YOUR COMPANY NAME> - Redirect URI:
https://YOUR-MATTERMOST-URL.COM/plugins/com.github.manland.mattermost-plugin-gitlab/oauth/complete.YOUR-MATTERMOST-URL.COM을 Mattermost URL로 바꿉니다. 이 값은 로그인에 사용하는 Mattermost 서버 URL과 일치해야 합니다. - Scopes에서
api및read_user를 선택합니다. - 변경 사항을 저장합니다. 결과 화면에서 Application ID와 Secret 필드를 복사합니다.
- Mattermost에서 시스템 콘솔 > 플러그인 > GitLab으로 이동하고 다음 설정을 구성한 후 저장을 선택합니다:
- GitLab에서 OAuth 앱을 등록할 때 얻은 GitLab URL, GitLab OAuth Client ID, GitLab OAuth Client Secret을 입력합니다.
- Generate를 선택하여 Webhook Secret 및 At Rest Encryption Key를 생성합니다.
- (선택 사항) GitLab Group: 통합을 단일 GitLab 그룹으로 잠급니다.
- (선택 사항) Enable Private Repositories: 프라이빗 저장소 작업 기능을 활성화합니다. 프라이빗 저장소가 활성화되면 영향을 받는 사용자에게 알림이 전송되며, 프라이빗 저장소에 접근하려면 GitLab 계정을 다시 연결해야 합니다.
- (선택 사항) Enable Child Pipeline Notifications: 활성화하면 부모 파이프라인 이벤트 외에 자식 파이프라인 이벤트에 대한 알림을 허용합니다. 비활성화하면 부모 파이프라인 알림만 전송됩니다. 이 설정은 자식 파이프라인을 광범위하게 사용하는 복잡한 CI/CD 파이프라인 구조를 가진 환경에서 알림 노이즈를 줄이는 데 도움이 됩니다.
- (선택 사항) Enable Code Previews: GitLab 파일 퍼머링크의 자동 확장을 코드 미리보기로 제어합니다. 옵션:
- Enable for public projects (기본값): 공개 GitLab 저장소에 대해서만 미리보기를 표시합니다.
- Enable for public and private projects: 공개 및 프라이빗 저장소 모두에 대해 미리보기를 표시합니다.
Mattermost에서 통합 구성
이 설정은 프라이빗 GitLab 저장소에 접근 권한이 있는 사용자가 공개 Mattermost 채널에 퍼머링크를 게시하는 경우 기밀 코드가 공개 채널에 유출될 가능성이 있습니다. 플러그인은 게시자의 GitLab 권한을 사용하여 자동으로 미리보기를 생성하여 접근 권한이 없는 다른 채널 구성원이 기밀 코드를 볼 수 있게 됩니다.
- Disable: 코드 미리보기 기능을 완전히 비활성화합니다.
지원되는 퍼머링크 유형:
- 단일 줄 퍼머링크: 대상 줄 및 3줄 컨텍스트 표시
- 파일 퍼머링크: 파일 정보 표시(코드 미리보기 없음)
- 줄 범위 퍼머링크: 파일 정보 표시(코드 미리보기 없음)
미리보기 제한:
- 미리보기당 최대 10줄 표시(단일 줄 퍼머링크는 컨텍스트 제한으로 인해 미리보기 줄이 더 적을 수 있음)
업그레이드#
새 버전이 출시될 때 이 통합을 업데이트하는 것을 권장합니다. 일반적으로 업데이트는 원활하게 이루어지며 Mattermost의 사용자 경험을 방해하지 않습니다. 최신 릴리즈, 이전 릴리즈, 호환성 고려 사항은 릴리즈 페이지를 방문하세요.
활성화#
통합을 설정한 후 팀에게 GitLab 계정을 Mattermost에 연결할 수 있음을 알립니다.
사용#
GitLab 상호 연결 기능을 사용하려는 사용자는 GitLab 계정을 Mattermost에 연결해야 합니다.
연결되면 누군가가 귀하를 언급하거나, 리뷰를 요청하거나, 귀하의 머지 리퀘스트/이슈에 댓글을 달거나, 수정하거나, GitLab에서 이슈를 귀하에게 할당할 때 Mattermost의 GitLab 봇으로부터 다이렉트 메시지를 받게 됩니다.
GitLab 계정을 Mattermost에 연결#
모든 Mattermost 채널에서 /gitlab connect 슬래시 명령어를 실행하여 Mattermost 계정을 GitLab 계정과 연결합니다.
/gitlab disconnect 슬래시 명령어를 실행하여 GitLab 계정 연결을 끊습니다. /gitlab me 슬래시 명령어를 실행하여 GitLab에 연결된 계정을 확인합니다.
연결되면 /gitlab help 슬래시 명령어를 실행하여 사용 가능한 기능을 확인합니다.
시작하기#
/gitlab todo 슬래시 명령어를 실행하여 할 일 목록, 할당된 이슈, 할당된 머지 리퀘스트, 리뷰를 기다리는 머지 리퀘스트 목록을 가져옵니다. 또는 왼쪽 사이드바에 있는 옵션을 사용합니다.
/gitlab webhook 슬래시 명령어를 실행하여 GitLab이 Mattermost에 이벤트를 보내도록 합니다. 예: /gitlab webhook add group[/project]
채널 구독#
/gitlab subscriptions list를 실행하여 모든 구독을 검토합니다.
/gitlab subscriptions add group[/project] [features] 슬래시 명령어를 실행하여 Mattermost 채널을 구독하고 GitLab 프로젝트의 새 머지 리퀘스트, 이슈 또는 기타 기능에 대한 게시물을 받습니다. 게시물 수신을 구독 취소하고 중단하려면 /gitlab subscriptions delete group[/project] 슬래시 명령어를 실행합니다.
채널 구독에서 지원되는 기능:
merges- 머지 리퀘스트가 머지될 때 알림 받기issues- 이슈가 생성될 때 알림 받기pushes- 커밋이 브랜치에 푸시될 때 알림 받기issue_comments- 이슈에 댓글이 달릴 때 알림 받기merge_request_comments- 머지 리퀘스트에 댓글이 달릴 때 알림 받기tag- 태그가 생성될 때 알림 받기pipeline- 파이프라인 이벤트에 대해 알림 받기(플러그인 구성에서 활성화된 경우 자식 파이프라인 이벤트 포함)wiki- 위키 페이지 이벤트에 대해 알림 받기releases- 릴리즈가 생성될 때 알림 받기deployments- 배포 이벤트에 대해 알림 받기
/gitlab subscriptions add group[/project] releases,deployments
알림을 받거나 구독하려는 각 프로젝트에 대해 /gitlab webhook 슬래시 명령어를 실행하여 GitLab에서 보낸 이벤트를 보려는 채널에 웹훅을 만듭니다. 예: /gitlab webhook add group[/project]
GitLab 버전 1.2 이전의 경우:
- GitLab에서 구독하려는 프로젝트로 이동하고 사이드바에서 Settings > Integrations를 선택합니다.
- 다음 값을 설정합니다:
- URL:
https://YOUR-MATTERMOST-URL.COM/plugins/com.github.manland.mattermost-plugin-gitlab/webhook.https://YOUR-MATTERMOST-URL.COM을 Mattermost URL로 바꿉니다. URL에/plugins/com.github.manland.mattermost-plugin-gitlab/webhook을 추가해야 합니다. 그렇지 않으면 웹훅이 작동하지 않습니다. - Secret Token: 앞서 생성한 웹훅 시크릿을 복사합니다.
- Triggers에서 모든 이벤트를 선택합니다.
- 웹훅을 추가합니다.
이슈 만들기 및 댓글 관리#
슬래시 명령어와 대화형 모달을 사용하여 Mattermost에서 직접 GitLab 이슈를 만들고 이슈 댓글을 관리할 수 있습니다.
GitLab 이슈 만들기#
/gitlab issue create 슬래시 명령어를 실행하여 새 GitLab 이슈를 만들 수 있는 대화형 모달을 엽니다. 모달에서 다음 작업을 수행할 수 있습니다:
- 이슈 제목 및 설명 설정
- 레이블 할당
- 담당자 설정
- 마일스톤 설정
- 대상 프로젝트 선택
기존 이슈에 댓글 첨부#
/gitlab issue comment [issue-number] 슬래시 명령어를 실행하여 기존 GitLab 이슈에 댓글을 첨부합니다. 이를 통해 Mattermost에서 직접 댓글을 작성하고 제출할 수 있는 대화형 모달이 열립니다.
설정 업데이트#
/gitlab settings [setting] [value] 슬래시 명령어를 실행하여 통합 기본 설정을 업데이트합니다:
- 개인 알림을 켜거나 끕니다.
- 매일 처음 연결할 때의 알림을 켜거나 끕니다.
도움 받기#
Mattermost 고객은 Mattermost 지원 케이스를 열 수 있습니다. 버그를 보고하려면 Mattermost GitLab 플러그인 저장소에서 GitHub 이슈를 열어주세요.
질문, 피드백 및 지원을 위해 Mattermost 커뮤니티 서버의 공개 통합 및 앱 채널에 참여하세요.
Mattermost Team Edition 및 Free 고객은 Mattermost 피어-투-피어 문제 해결 포럼을 방문하여 글로벌 Mattermost 커뮤니티의 도움을 받을 수 있습니다.
Mattermost와 GitLab을 통한 릴리즈 관리에 관한 온디맨드 웨비나를 시청하여 릴리즈 프로세스를 간소화하고 표준화하는 방법을 알아보세요.