GitLab for Slack 앱

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated
note
이 페이지에는 GitLab for Slack 앱에 대한 사용자 문서가 포함되어 있습니다. 관리자 문서는 GitLab for Slack 앱 관리에서 확인하세요.

GitLab for Slack 앱은 Slack 워크스페이스에서 슬래시 명령과 알림을 제공하는 네이티브 Slack 앱입니다. GitLab은 Slack 사용자와 GitLab 사용자를 연결하여 Slack에서 실행하는 모든 명령이 연결된 GitLab 사용자에 의해 실행되도록 합니다.

GitLab for Slack 앱 설치

사전 요구 사항:

  • Slack 워크스페이스에 앱을 추가할 수 있는 적절한 권한이 있어야 합니다.
  • Self-managed GitLab에서, 관리자가 통합을 활성화해야 합니다.

GitLab 15.0 이상에서 GitLab for Slack 앱은 세분화된 권한을 사용합니다. 기능은 변경되지 않았지만, 앱을 다시 설치해야 합니다.

프로젝트 또는 그룹 설정에서


Self-managed GitLab에서 기본적으로 이 기능을 사용할 수 있습니다.
기능을 숨기려면 관리자가 gitlab_for_slack_app_instance_and_group_level이라는 기능 플래그를 비활성화할 수 있습니다.
GitLab.com 및 GitLab Dedicated에서는 이 기능을 사용할 수 있습니다.

프로젝트 또는 그룹 설정에서 GitLab for Slack 앱을 설치하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트 또는 그룹을 찾습니다.
  2. 설정 > 통합을 선택합니다.
  3. GitLab for Slack 앱을 선택합니다.
  4. GitLab for Slack 앱 설치를 선택합니다.
  5. Slack 확인 페이지에서 허용을 선택합니다.

Slack 앱 디렉터리에서

Tier: Free, Premium, Ultimate Offering: GitLab.com

GitLab.com에서는 Slack 앱 디렉터리에서 GitLab for Slack 앱을 설치할 수도 있습니다.

Slack 앱 디렉터리에서 GitLab for Slack 앱을 설치하려면:

  1. GitLab for Slack 페이지로 이동합니다.
  2. Slack 워크스페이스에 연결할 GitLab 프로젝트를 선택합니다.

GitLab for Slack 앱 다시 설치

GitLab이 GitLab for Slack 앱에 대한 새로운 기능을 출시할 때, 이러한 기능을 사용하기 위해 앱을 다시 설치해야 할 수도 있습니다.

GitLab for Slack 앱을 다시 설치하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 설정 > 통합을 선택합니다.
  3. GitLab for Slack 앱을 선택합니다.
  4. GitLab for Slack 앱 다시 설치를 선택합니다.
  5. Slack 확인 페이지에서 허용을 선택합니다.

GitLab for Slack 앱은 통합을 사용하는 모든 프로젝트에서 업데이트됩니다.

대안으로, 통합을 다시 구성할 수 있습니다.

슬래시 명령어

슬래시 명령어를 사용하여 GitLab의 일반적인 작업을 실행할 수 있습니다.

GitLab for Slack 앱의 경우:

  • 첫 번째 슬래시 명령어를 실행할 때 Slack 사용자를 인증해야 합니다.
  • 슬래시 명령어에 대해 <project>를 프로젝트 전체 경로로 바꾸거나 프로젝트 별칭 생성을 사용할 수 있습니다.

Slack 슬래시 명령어 또는 Mattermost 슬래시 명령어를 사용하는 경우:

  • /gitlab를 이 통합에 대해 구성한 트리거 이름으로 바꿉니다.
  • <project>를 제거합니다.

GitLab에서 사용할 수 있는 슬래시 명령어는 다음과 같습니다:

명령어 설명
/gitlab help 사용 가능한 모든 슬래시 명령어를 보여줍니다.
/gitlab <project> issue show <id> ID <id>의 이슈를 보여줍니다.
/gitlab <project> issue new <title> Shift+Enter <description> 제목 <title>과 설명 <description>으로 이슈를 생성합니다.
/gitlab <project> issue search <query> <query>와 일치하는 최대 다섯 개의 이슈를 보여줍니다.
/gitlab <project> issue move <id> to <project> ID <id>의 이슈를 <project>로 이동합니다.
/gitlab <project> issue close <id> ID <id>의 이슈를 닫습니다.
/gitlab <project> issue comment <id> Shift+Enter <comment> ID <id>의 이슈에 <comment> 본문으로 주석을 추가합니다.
/gitlab <project> deploy <from> to <to> 배포를 <from> 환경에서 <to> 환경으로 합니다.
/gitlab <project> run <job name> <arguments> 기본 브랜치에서 ChatOps 작업 <job name>를 실행합니다.
/gitlab incident declare Slack에서 인시던트 생성을 위한 대화 상자를 엽니다.

deploy 명령어

환경에 배포하기 위해, GitLab은 파이프라인에서 수동 배포 작업을 찾으려 합니다.

환경에 대해 하나의 배포 작업만 정의된 경우, 해당 작업이 트리거됩니다.

둘 이상의 배포 작업이 정의된 경우, GitLab은 환경 이름과 일치하는 작업 이름을 찾으려 합니다.

일치하는 배포 작업을 찾을 수 없는 경우 명령어는 오류를 반환합니다.

프로젝트 별칭 생성

GitLab for Slack 앱에서 슬래시 명령어는 기본적으로 프로젝트 전체 경로를 사용합니다. 대신 프로젝트 별칭을 사용할 수 있습니다.

GitLab for Slack 앱에서 슬래시 명령어에 대한 프로젝트 별칭을 생성하려면:

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

  2. 설정 > 통합을 선택합니다.

  3. GitLab for Slack 앱을 선택합니다.

  4. 프로젝트 경로 또는 별칭 옆에서 편집을 선택합니다.

  5. 새 별칭을 입력하고 변경 사항 저장을 선택합니다.

Slack 알림

특정 GitLab 이벤트에 대해 Slack 채널로 알림을 받을 수 있습니다.

알림 구성

Slack 알림을 구성하려면:

  1. 왼쪽 사이드바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. Settings > Integrations를 선택합니다.
  3. GitLab for Slack app을 선택합니다.
  4. Trigger 섹션에서:
    • Slack에서 알림을 받으려는 각 GitLab event의 체크박스를 선택합니다.

    • 선택한 각 체크박스에 대해 알림을 받고 싶은 Slack 채널의 이름을 입력합니다. 최대 10개의 채널 이름을 쉼표로 구분하여 입력할 수 있습니다(예: #channel-one, #channel-two).

      참고: Slack 채널이 비공개인 경우, 채널에 GitLab for Slack app을 추가해야 합니다.

  5. 선택 사항. Notification settings 섹션에서:
    • Notify only broken pipelines 체크박스를 선택하여 실패한 파이프라인에 대한 알림만 받습니다.
    • Branches for which notifications are to be sent 드롭다운 목록에서 알림을 받고 싶은 브랜치를 선택합니다. 취약점에 대한 알림은 선택된 브랜치와 관계없이 기본 브랜치로만 트리거됩니다. 자세한 내용은 이슈 469373을 참조하세요.
    • Labels to be notified에 GitLab 문제, 병합 요청 또는 댓글이 알림을 받기 위해 가져야 하는 모든 레이블을 입력합니다. 모든 이벤트에 대한 알림을 받으려면 비워두세요.
  6. 선택 사항. Test settings를 선택합니다.
  7. Save changes를 선택합니다.

비공식 채널에 대한 알림 수신

비공식 Slack 채널에서 알림을 받으려면, GitLab for Slack app을 채널에 추가해야 합니다:

  1. 채널에서 @GitLab을 입력하여 앱을 언급합니다.
  2. Add to Channel을 선택합니다.

알림 이벤트

다음 GitLab 이벤트가 Slack에서 알림을 트리거할 수 있습니다:

이벤트 설명
Push 리포지토리에 푸시가 이루어집니다.
Issue 이슈가 생성되거나 종료되거나 재개됩니다.
Confidential issue 비공식 이슈가 생성되거나 종료되거나 재개됩니다.
Merge request 병합 요청이 생성되거나 병합되거나 종료되거나 재개됩니다.
Note 댓글이 추가됩니다.
Confidential note 비공식 이슈에 대한 내부 메모 또는 댓글이 추가됩니다.
Tag push 리포지토리에 태그가 푸시되거나 제거됩니다.
Pipeline 파이프라인 상태가 변경됩니다.
Wiki page 위키 페이지가 생성되거나 업데이트됩니다.
Deployment 배포가 시작되거나 완료됩니다.
Group mention in public 공개 채널에서 그룹이 언급됩니다.
Group mention in private 비공식 채널에서 그룹이 언급됩니다.
Incident 사건이 생성되거나 종료되거나 재개됩니다.
Vulnerability 기본 브랜치에 새로운 고유 취약점이 기록됩니다.
Alert 새로운 고유 경고가 기록됩니다.

그룹 언급에 대한 알림 트리거

History
Self-managed GitLab에서 기본적으로 이 기능은 사용 가능합니다.
기능을 숨기려면 관리자가 기능 플래그를 비활성화할 수 있습니다 gitlab_for_slack_app_instance_and_group_level이라는 이름으로.
GitLab.com 및 GitLab Dedicated에서는 이 기능이 사용 가능합니다.

그룹 언급에 대한 알림 이벤트를 트리거하려면 다음에 @<group_name>을 사용합니다:

  • 이슈 및 병합 요청 설명
  • 이슈, 병합 요청 및 커밋에 대한 댓글