Mattermost 슬래시 명령어

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

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

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

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

구성 옵션

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

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

자동으로 구성하기

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

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

수동으로 구성하기

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

  1. Mattermost에서 사용자 정의 슬래시 명령어 활성화를 수행해야 합니다. 이 단계는 자체 컴파일 설치에만 필요합니다.
  2. GitLab에서 구성 값 가져오기(#get-configuration-values-from-gitlab).
  3. Mattermost에서 슬래시 명령어 생성(#create-a-slash-command-in-mattermost).
  4. Mattermost 토큰을 GitLab에 제공하기(#provide-the-mattermost-token-to-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. 요청 URLGitLab에서 복사한 값을 붙여넣기합니다.
  8. 다른 값은 GitLab의 제안사항 또는 선호하는 값으로 사용할 수 있습니다.
  9. Token 값을 복사하고 완료를 선택합니다.

Mattermost 토큰을 GitLab에 제공하기

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

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

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

GitLab 계정을 Mattermost에 연결하기

필수 조건:

Mattermost 슬래시 커맨드를 사용하여 GitLab과 상호 작용하는 방법:

  1. Mattermost 채팅 환경에서 새로운 슬래시 커맨드를 실행합니다.
  2. GitLab 계정을 연결을 선택하여 액세스를 승인합니다.

Mattermost 프로필 페이지의 채팅에서 모든 승인된 채팅 계정을 확인할 수 있습니다.

관련 주제

문제 해결

Mattermost 슬래시 커맨드가 GitLab에서 이벤트를 트리거하지 않을 때:

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