슬래시 명령어를 사용하여 Mattermost 채팅 환경에서 이슈 생성과 같은 일반적인 GitLab 작업을 실행할 수 있습니다.

GitLab은 별도로 구성된 Mattermost 알림의 일부로 Mattermost에 이벤트(예: issue created)를 보낼 수도 있습니다.

사용 가능한 슬래시 명령어 목록은 슬래시 명령어를 참조하세요.

구성 옵션#

GitLab은 Mattermost 슬래시 명령어를 구성하는 다양한 방법을 제공합니다. 이러한 옵션 중 하나를 사용하려면 Mattermost 3.4 이상이 있어야 합니다.

• Linux 패키지 설치: Mattermost는 Linux 패키지에 번들되어 있습니다. Linux 패키지 설치를 위한 Mattermost 구성은 Linux 패키지 Mattermost 문서를 참조하세요.
• Mattermost가 GitLab과 동일한 서버에 설치된 경우: 자동 구성을 사용합니다.
• 다른 모든 설치의 경우: 수동 구성을 사용합니다.

자동으로 구성#

Mattermost가 GitLab과 동일한 서버에 설치된 경우 Mattermost 슬래시 명령어를 자동으로 구성할 수 있습니다:

1. 상단 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 왼쪽 사이드바에서 Settings > Integrations를 선택합니다.
3. Mattermost slash commands를 선택합니다.
4. Enable integration 아래에서 Active 체크박스가 선택되어 있는지 확인합니다.
5. Add to Mattermost를 선택하고 Save changes를 선택합니다.

수동으로 구성#

Mattermost에서 슬래시 명령어를 수동으로 구성하려면 다음을 수행해야 합니다:

1. Mattermost에서 사용자 정의 슬래시 명령어 활성화. 이 단계는 자체 컴파일 설치에만 필요합니다.
2. GitLab에서 구성 값 가져오기.
3. Mattermost에서 슬래시 명령어 만들기.
4. Mattermost 토큰을 GitLab에 제공.

Mattermost에서 사용자 정의 슬래시 명령어 활성화#

Mattermost 관리자 콘솔에서 사용자 정의 슬래시 명령어를 활성화하려면:

1. 관리자 권한이 있는 사용자로 Mattermost에 로그인합니다.
2. 사용자 이름 옆에서 ⋮ Settings 아이콘을 선택하고 System Console을 선택합니다.
3. Integration Management를 선택하고 다음 값을 TRUE로 설정합니다:
   • Enable Custom Slash Commands
   • Enable integrations to override usernames
   • Enable integrations to override profile picture icons
4. Save를 선택하되 이 브라우저 탭을 닫지 마세요. 이후 단계에서 필요합니다.

GitLab에서 구성 값 가져오기#

GitLab에서 구성 값을 가져오려면:

1. 다른 브라우저 탭에서 관리자 액세스 권한이 있는 사용자로 GitLab에 로그인합니다.
2. 오른쪽 상단 모서리에서 Admin을 선택합니다.
3. 왼쪽 사이드바에서 Settings > Integrations를 선택합니다.
4. Mattermost slash commands를 선택합니다. GitLab은 Mattermost 설정에 대한 잠재적인 값을 표시합니다.
5. Request URL 값을 복사합니다. 다른 모든 값은 제안 사항입니다.
6. 이 브라우저 탭을 닫지 마세요. 이후 단계에서 필요합니다.

Mattermost에서 슬래시 명령어 만들기#

Mattermost에서 슬래시 명령어를 만들려면:

1. Mattermost 브라우저 탭에서 팀 페이지로 이동합니다.

2. ⋮ Settings 아이콘을 선택하고 Integrations를 선택합니다.

3. 왼쪽 사이드바에서 Slash commands를 선택합니다.

4. Add Slash Command를 선택합니다.

5. 새 명령어에 대한 Display Name 및 Description을 제공합니다.

6. 애플리케이션 구성에 따라 Command Trigger Word를 제공합니다:

   • Mattermost 팀에 하나의 프로젝트만 연결하려면 트리거 단어로 /gitlab을 사용합니다.
   • 여러 프로젝트를 연결하려면 /project-name 또는 /gitlab-project-name과 같이 프로젝트와 관련된 트리거 단어를 사용합니다.

7. Request URL에 GitLab에서 복사한 값을 붙여넣습니다.

8. 다른 모든 값에는 GitLab의 제안을 사용하거나 원하는 값을 사용할 수 있습니다.

9. Token 값을 복사하고 Done을 선택합니다.

Mattermost 토큰을 GitLab에 제공#

Mattermost에서 슬래시 명령어를 만들면 GitLab에 제공해야 하는 토큰이 생성됩니다:

1. GitLab 브라우저 탭에서 Active 체크박스를 선택합니다.
2. Token 텍스트 상자에 Mattermost에서 복사한 토큰을 붙여넣습니다.
3. Save changes를 선택합니다.

이제 슬래시 명령어가 GitLab 프로젝트와 통신할 수 있습니다.

Mattermost에 GitLab 계정 연결#

사전 요구 사항:

• 슬래시 명령어를 실행하려면 GitLab 프로젝트에서 해당 작업을 수행할 수 있는 권한이 있어야 합니다.

Mattermost 슬래시 명령어를 사용하여 GitLab과 상호 작용하려면:

1. Mattermost 채팅 환경에서 새 슬래시 명령어를 실행합니다.
2. connect your GitLab account를 선택하여 액세스를 권한 부여합니다.

Chat 아래의 Mattermost 프로필 페이지에서 모든 권한 부여된 채팅 계정을 볼 수 있습니다.

관련 주제#

• Mattermost Linux 패키지
• Mattermost의 슬래시 명령어

문제 해결#

Mattermost 슬래시 명령어가 GitLab에서 이벤트를 트리거하지 않는 경우:

• 공개 채널을 사용하고 있는지 확인합니다. Mattermost 웹훅은 비공개 채널에 액세스할 수 없습니다.
• 비공개 채널이 필요한 경우 웹훅 채널을 편집하고 비공개 채널을 선택합니다. 모든 이벤트는 지정된 채널로 전송됩니다.