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 앱은 세분화된 권한을 사용합니다. 기능은 변경되지 않았지만, 앱을 다시 설치해야 합니다.
프로젝트 또는 그룹 설정에서
- 그룹 수준에서의 설치는 GitLab 16.10에 flag와 함께 소개되었으며, 기본적으로 비활성화되어 있습니다.
- GitLab 16.11에서 GitLab.com, Self-Managed형, 그리고 GitLab Dedicated에서 활성화되었습니다.
gitlab_for_slack_app_instance_and_group_level
이라는 피처 플래그를 비활성화할 수 있습니다.
GitLab.com 및 GitLab Dedicated에서는 이 기능을 사용할 수 있습니다.프로젝트 또는 그룹 설정에서 GitLab for Slack 앱을 설치하려면:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트 또는 그룹을 찾습니다.
- 설정 > 통합을 선택합니다.
- GitLab for Slack 앱을 선택합니다.
- GitLab for Slack 앱 설치를 선택합니다.
- Slack 확인 페이지에서 허용을 선택합니다.
Slack 앱 디렉터리에서
GitLab.com에서는 Slack 앱 디렉터리에서 GitLab for Slack 앱을 설치할 수 있습니다.
Slack 앱 디렉터리에서 GitLab for Slack 앱을 설치하려면:
- GitLab for Slack 페이지로 이동합니다.
- Slack 작업 공간에 연결할 GitLab 프로젝트를 선택합니다.
GitLab for Slack 앱 재설치
GitLab이 GitLab for Slack 앱에 대한 새로운 기능을 출시하면, 이러한 기능을 사용하려면 앱을 재설치해야 할 수 있습니다.
GitLab for Slack 앱을 재설치하려면:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
- 설정 > 통합을 선택합니다.
- GitLab for Slack 앱을 선택합니다.
- GitLab for Slack 앱 재설치를 선택합니다.
- Slack 확인 페이지에서 허용을 선택합니다.
GitLab for Slack 앱이 통합을 사용하는 모든 프로젝트에 대해 업데이트됩니다.
또는, 통합을 다시 구성할 수 있습니다.
슬래시 명령
일반적인 GitLab 작업을 실행하려면 슬래시 명령을 사용할 수 있습니다.
GitLab for Slack 앱을 사용하는 경우:
- 첫 번째 슬래시 명령을 실행할 때 Slack 사용자를 인가해야 합니다.
- 슬래시 명령을 위해 프로젝트 전체 경로를 대체하거나, 슬래시 명령을 위해 프로젝트 별칭을 생성할 수 있습니다.
대신 Slack 슬래시 명령이나 Mattermost 슬래시 명령을 사용하는 경우:
- 이러한 통합에 대해 구성한 트리거 이름으로
/gitlab
을 대체하세요. -
<project>
를 제거하세요.
다음 슬래시 명령을 GitLab에 사용할 수 있습니다:
명령 | 설명 |
---|---|
/gitlab help
| 사용 가능한 모든 슬래시 몤령을 표시합니다. |
/gitlab <project> issue show <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> 의 이슈를 <project> 로 이동합니다.
|
/gitlab <project> issue close <id>
|
<id> 의 이슈를 닫습니다.
|
/gitlab <project> issue comment <id> Shift+Enter <comment>
|
<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 앱에서 슬래시 명령을 위해 프로젝트 별칭을 생성하려면:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
- 설정 > 통합을 선택합니다.
- GitLab for Slack 앱을 선택합니다.
- 프로젝트 경로 또는 별칭 옆에 편집을 선택합니다.
- 새 별칭을 입력하고 변경 사항 저장을 선택합니다.
Slack 알림
- GitLab 15.9에서 소개됨](https://gitlab.com/gitlab-org/gitlab/-/issues/381012).
특정 GitLab 이벤트에 대한 Slack 채널로 알림을 받을 수 있습니다.
알림 구성
Slack 알림을 구성하려면:
- 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
- 설정 > 통합을 선택합니다.
- GitLab for Slack 앱을 선택합니다.
-
트리거 섹션에서:
- Slack에서 알림을 받고 싶은 각 GitLab 이벤트에 대한 확인란을 선택합니다.
-
각 확인란을 선택하면 알림을 받고 싶은 Slack 채널 이름을 입력합니다. 쉼표로 구분하여 최대 10개의 채널 이름을 입력할 수 있습니다 (예:
#channel-one, #channel-two
).Slack 채널이 비공개인 경우, 반드시 Slack 채널에 GitLab for Slack 앱을 추가해야 합니다.
- 선택 사항. 알림 설정 섹션에서:
- 오직 실패한 파이프라인에 대해서만 알림 확인란을 선택하면 실패한 파이프라인에 대해서만 알림을 받습니다.
- 알림을 받을 브랜치 드롭다운 디렉터리에서 알림을 받고 싶은 브랜치를 선택합니다.
- 알림 대상 레이블에서 GitLab 이슈, Merge Request, 댓글에 대해 알림을 받기 위해 레이블 중 하나 이상을 입력합니다. 모든 이벤트에 대해 알림을 받으려면 비워 둡니다.
- 선택 사항. 설정 테스트를 선택합니다.
- 변경 사항 저장을 선택합니다.
개인 채널로 알림 받기
개인 Slack 채널로 알림을 받으려면 채널에 GitLab for Slack 앱을 추가해야 합니다:
- 채널에서
@GitLab
을 입력하여 앱을 언급합니다. - 채널에 추가를 선택합니다.
알림 이벤트
다음과 같은 GitLab 이벤트가 Slack에서 알림을 트리거할 수 있습니다:
이벤트 | 설명 |
---|---|
Push | 리포지터리에 푸시가 이루어집니다. |
Issue | 이슈가 생성되거나 닫히거나 다시 열립니다. |
Confidential issue | 기밀 이슈가 생성되거나 닫히거나 다시 열립니다. |
Merge request | Merge Request이 생성되거나 Merge되거나 닫히거나 다시 열립니다. |
Note | 댓글이 추가됩니다. |
Confidential note | 기밀 이슈에 대한 내부 노트 또는 댓글이 추가됩니다. |
Tag push | 태그가 리포지터리에 푸시되거나 제거됩니다. |
Pipeline | 파이프라인 상태가 변경됩니다. |
Wiki page | 위키 페이지가 생성되거나 업데이트됩니다. |
Deployment | 배포가 시작되거나 완료됩니다. |
그룹 멘션 - 공개 채널 | 공개 채널에서 그룹이 언급됩니다. |
그룹 멘션 - 개인 채널 | 개인 채널에서 그룹이 언급됩니다. |
인시던트 | 인시던트가 생성되거나 닫히거나 다시 열립니다. |
취약점 | 새로운 고유한 취약점이 기록됩니다. |
경고 | 새로운 고유한 경고가 기록됩니다. |
그룹 멘션을 트리거하여 알림받기
- GitLab 16.10 에서 동시에 발표된
gitlab_for_slack_app_instance_and_group_level
이라는 플래그와 함께 도입되었습니다. 기본적으로 비활성화됩니다.- GitLab 16.11 에서 GitLab.com, Self-Managed 및 GitLab Dedicated에 활성화되었습니다.
플래그:
Self-Managed형 GitLab에서는 기본적으로 이 기능을 사용할 수 있습니다.
기능을 숨기려면 관리자가 gitlab_for_slack_app_instance_and_group_level
라는 피처 플래그를 비활성화할 수 있습니다.
GitLab.com 및 GitLab Dedicated에서는 이 기능을 사용할 수 있습니다.
그룹 멘션을 위해 알림 이벤트를 트리거하려면 다음 위치에서 @<group_name>
을 사용합니다:
- 이슈 및 Merge Request 설명
- 이슈, Merge Request, 및 커밋에 대한 댓글