Slack 앱용 GitLab

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated
History
note
이 페이지에는 Slack용 GitLab 앱의 사용자 설명서가 포함되어 있습니다. 관리자 설명서는 GitLab for Slack 앱 관리를 참조하십시오.

Slack용 GitLab 앱은 네 Slack 워크스페이스에서 슬래시 명령과 알림을 제공하는 기본 Slack 앱입니다. GitLab은 네 Slack 사용자를 네 GitLab 사용자와 연결하여 Slack에서 실행하는 모든 명령을 연결된 GitLab 사용자가 실행합니다.

Slack용 GitLab 앱 설치하기

필수 사항:

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

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

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

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

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

Slack 앱 디렉터리에서

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

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

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

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

Slack용 GitLab 앱 다시 설치하기

GitLab이 Slack용 GitLab 앱의 새로운 기능을 출시할 때, 이러한 기능을 사용하려면 앱을 다시 설치해야 할 수 있습니다.

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

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

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

또는 통합을 다시 구성할 수 있습니다.

슬래시 명령

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

Slack용 GitLab 앱의 경우:

  • 첫 번째 슬래시 명령을 실행할 때 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이 일치하는 배포 작업을 찾지 못하면 명령에 오류가 반환됩니다.

프로젝트 별칭 생성

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

GitLab for Slack 앱의 슬래시 명령용 프로젝트 별칭을 생성하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 설정 > 통합을 선택합니다.
  3. GitLab for Slack 앱을 선택합니다.
  4. 프로젝트 경로 또는 별칭 옆에서 편집을 선택합니다.
  5. 새 별칭을 입력하고 변경 사항 저장을 선택합니다.

Slack 알림

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

알림 구성

Slack 알림을 구성하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 설정 > 통합을 선택합니다.
  3. GitLab for Slack 앱을 선택합니다.
  4. 트리거 섹션에서:
    • Slack에서 알림을 받고 싶은 각 GitLab 이벤트의 확인란을 선택합니다.

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

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

  5. 선택 사항. 알림 설정 섹션에서:
    • 작동하지 않는 파이프라인에 대해서만 알림 받기 확인란을 선택하여 실패한 파이프라인에 대한 알림만 받습니다.
    • 알림을 받기를 원하는 브랜치를 알림을 받을 브랜치 드롭다운 목록에서 선택합니다. 취약점에 대한 알림은 선택한 브랜치에 관계없이 기본 브랜치에서만 트리거됩니다. 자세한 내용은 이슈 469373을 참조하세요.
    • 알림을 받을 라벨에 GitLab 이슈, 병합 요청 또는 코멘트가 필요한 라벨 중 하나 이상을 입력합니다. 모든 이벤트에 대해 알림을 받으려면 비워 둡니다.
  6. 선택 사항. 설정 테스트를 선택합니다.
  7. 변경 사항 저장을 선택합니다.

비공개 채널로 알림 받기

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

  1. 해당 채널에서 앱을 @GitLab으로 언급합니다.
  2. 채널에 추가를 선택합니다.

알림 이벤트

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

이벤트 설명
Push 저장소에 푸시됨
이슈 이슈가 생성되거나 닫힘, 재오픈 됨
비밀 이슈 비밀 이슈가 생성되거나 닫힘, 재오픈 됨
병합 요청 병합 요청이 생성되거나 병합, 닫힘, 재오픈 됨
코멘트 코멘트가 추가됨
비밀 코멘트 비공개 이슈에 대한 내부 코멘트나 코멘트가 추가됨
태그 푸시 태그가 저장소에 푸시되거나 제거됨
파이프라인 파이프라인 상태 변경됨
위키 페이지 위키 페이지가 생성되거나 업데이트됨
배포 배포가 시작되거나 완료됨
공개 그룹 멘션 공개 채널에서 그룹이 멘션됨
비공개 그룹 멘션 비공개 채널에서 그룹이 멘션됨
인시던트 인시던트가 생성되거나 닫힘, 재오픈 됨
취약점 기본 브랜치에 새로운 고유 취약점이 기록됨
경보 새로운 고유한 경보가 기록됨

공개/비공개 그룹 멘션에 대한 알림 트리거

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

공개/비공개 그룹 멘션에 대한 알림 이벤트를 트리거하려면 다음 위치에 @<그룹_이름>을 사용하세요:

  • 이슈 및 병합 요청 설명
  • 이슈, 병합 요청, 커밋의 코멘트