Mattermost 슬래시 명령어

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-Managed, GitLab Dedicated

Mattermost 채팅 환경에서 이슈 생성과 같은 일반적인 GitLab 작업을 실행하는 slash commands를 사용할 수 있습니다.

또한 GitLab은 별도로 구성된 Mattermost 알림의 일환으로 이벤트(예: 이슈 생성)를 Mattermost에 전송할 수 있습니다.

사용 가능한 슬래시 명령어 목록은 Slash commands에서 확인할 수 있습니다.

구성 옵션

GitLab은 Mattermost 슬래시 명령어를 구성하는 다양한 방법을 제공합니다. 이러한 옵션 중 어떤 것을 사용하더라도 Mattermost 3.4 이상을 사용해야 합니다.

  • Linux 패키지 설치: Mattermost는 Linux 패키지에 번들로 제공됩니다. Linux 패키지 설치를 위해 Mattermost를 구성하려면 Linux 패키지 Mattermost 문서를 참조하십시오.
  • GitLab과 동일한 서버에 Mattermost가 설치된 경우, 자동 구성을 사용하십시오.
  • 다른 모든 설치에 대해서, 수동 구성을 사용하십시오.

자동으로 구성

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

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 설정 > 통합을 선택합니다.
  3. Mattermost 슬래시 명령어를 선택합니다.
  4. 통합 활성화 아래에서 활성 확인란이 선택되어 있는지 확인합니다.
  5. Mattermost에 추가를 선택하고 변경 사항 저장을 선택합니다.

수동으로 구성

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

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

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

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

  1. 관리자 권한이 있는 사용자로 Mattermost에 로그인합니다.
  2. 사용자 이름 옆에 있는 설정 아이콘을 선택하고 시스템 콘솔을 선택합니다.
  3. 통합 관리를 선택하고 다음 값을 TRUE로 설정합니다:
    • 사용자 정의 슬래시 명령어 활성화
    • 통합에서 사용자 이름 재정의 활성화
    • 프로필 사진 아이콘 재정의를 위한 통합 활성화
  4. 저장을 선택하지만 이 브라우저 탭을 닫지 마십시오. 나중 단계에서 필요합니다.

GitLab에서 구성 값 가져오기

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

  1. 다른 브라우저 탭에서 관리자 액세스 권한이 있는 사용자로 GitLab에 로그인합니다.
  2. 왼쪽 사이드바에서 맨 아래쪽에 있는 관리를 선택합니다.
  3. 설정 > 통합을 선택합니다.
  4. Mattermost 슬래시 명령어를 선택합니다. GitLab은 Mattermost 설정에 대한 잠재적인 값들을 표시합니다.
  5. 요청 URL 값을 복사합니다. 다른 값은 제안 사항입니다.
  6. 이 브라우저 탭을 닫지 마십시오. 나중 단계에서 필요합니다.

Mattermost에서 슬래시 명령어 생성

Mattermost에서 슬래시 명령어를 생성하려면:

  1. Mattermost 브라우저 탭에서 팀 페이지로 이동합니다.
  2. 설정 아이콘을 선택하고 통합을 선택합니다.
  3. 왼쪽 사이드바에서 슬래시 명령어를 선택합니다.
  4. 슬래시 명령어 추가를 선택합니다.
  5. 새 명령어에 대한 표시 이름 및 설명을 입력합니다.

  6. 응용 프로그램의 구성에 기반하여 명령 트리거 단어를 제공합니다:

    • 하나의 프로젝트만 Mattermost 팀에 연결할 계획이라면 트리거 단어로 /gitlab을 사용하십시오.
    • 여러 프로젝트를 연결할 계획이라면 프로젝트와 관련된 트리거 단어(예: /프로젝트명 또는 /gitlab-프로젝트명)를 사용하십시오.
  7. 요청 URL에 GitLab에서 복사한 값을 붙여넣으십시오.
  8. 다른 모든 값은 GitLab이나 선호하는 값으로 사용하십시오.
  9. 토큰 값을 복사하고 완료를 선택합니다.

Mattermost 토큰을 GitLab에 제공

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

  1. GitLab 브라우저 탭에서 활성 확인란을 선택합니다.
  2. 토큰 텍스트 상자에 Mattermost에서 복사한 토큰을 붙여넣습니다.
  3. 변경 사항 저장을 선택합니다.

이제 슬래시 명령어를 사용하여 GitLab 프로젝트와 통신할 수 있습니다.

GitLab 계정을 Mattermost에 연결

전제 조건:

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

  1. Mattermost 채팅 환경에서 새 슬래시 명령어를 실행합니다.
  2. 권한 부여를 위해 GitLab 계정 연결을 선택합니다.

채팅 아래에 있는 Mattermost 프로필 페이지에서 모든 승인된 채팅 계정을 볼 수 있습니다.

관련 주제

문제 해결

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

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