Slack App Directory를 통해 배포되는 GitLab for Slack 앱은 GitLab.com에서만 작동합니다. GitLab Self-Managed에서는 매니페스트 파일로 자체 GitLab for Slack 앱 복사본을 만들어 인스턴스를 구성할 수 있습니다.

이 앱은 Slack 워크스페이스에만 설치되는 비공개 일회성 복사본이며 Slack App Directory를 통해 배포되지 않습니다. GitLab Self-Managed 인스턴스에서 GitLab for Slack 앱을 사용하려면 통합을 켜야 합니다.

GitLab for Slack 앱 생성#

사전 요구 사항:

• 최소한 Slack 워크스페이스 관리자여야 합니다.

GitLab for Slack 앱을 만들려면 다음 단계를 따릅니다:

• GitLab에서:

  1. 오른쪽 상단에서 Admin을 선택합니다.
  2. 왼쪽 사이드바에서 Settings > General을 선택합니다.
  3. GitLab for Slack app을 확장합니다.
  4. Create Slack app을 선택합니다.

그러면 다음 단계를 진행하도록 Slack으로 리디렉션됩니다.

• Slack에서:

  1. 앱을 만들 Slack 워크스페이스를 선택한 다음 Next를 선택합니다.
  2. Slack이 검토용 앱 요약을 표시합니다. 전체 매니페스트를 보려면 Edit Configurations를 선택합니다. 검토 요약으로 돌아가려면 Next를 선택합니다.
  3. Create를 선택합니다.
  4. Got it을 선택해 대화 상자를 닫습니다.
  5. Install to Workspace를 선택합니다.

설정 구성#

GitLab for Slack 앱을 만든 다음에는 GitLab에서 설정을 구성할 수 있습니다:

1. 오른쪽 상단에서 Admin을 선택합니다.
2. 왼쪽 사이드바에서 Settings > General을 선택합니다.
3. GitLab for Slack app을 확장합니다.
4. Enable GitLab for Slack app 확인란을 선택합니다.
5. GitLab for Slack 앱의 세부 정보를 입력합니다:
   1. Slack API로 이동합니다.
   2. **GitLab (<your host name>)**을 검색해 선택합니다.
   3. App Credentials로 스크롤합니다.
6. Save changes를 선택합니다.

GitLab for Slack 앱 설치#

사전 요구 사항:

• Slack 워크스페이스에 앱을 추가할 수 있는 권한이 있어야 합니다.
• GitLab for Slack 앱을 만들고 앱 설정을 구성해야 합니다.

인스턴스 설정에서 GitLab for Slack 앱을 설치하려면 다음 단계를 따릅니다:

1. 오른쪽 상단에서 Admin을 선택합니다.
2. 왼쪽 사이드바에서 Settings > Integrations를 선택합니다.
3. GitLab for Slack app을 선택합니다.
4. Install GitLab for Slack app을 선택합니다.
5. Slack 확인 페이지에서 Allow를 선택합니다.

구성 테스트#

GitLab for Slack 앱 구성을 테스트하려면 다음 단계를 따릅니다:

1. Slack 워크스페이스의 채널에 /gitlab help 슬래시 명령을 입력합니다.
2. Enter를 누릅니다.

사용할 수 있는 슬래시 명령 목록이 표시됩니다.

프로젝트에서 슬래시 명령을 사용하려면 해당 프로젝트에 GitLab for Slack 앱을 구성합니다.

GitLab for Slack 앱 업데이트#

사전 요구 사항:

• 최소한 Slack 워크스페이스 관리자여야 합니다.

GitLab이 GitLab for Slack 앱의 새 기능을 릴리스하면 새 기능을 사용하기 위해 복사본을 수동으로 업데이트해야 할 수 있습니다.

GitLab for Slack 앱 복사본을 업데이트하려면 다음 단계를 따릅니다:

• GitLab에서:
  1. 오른쪽 상단에서 Admin을 선택합니다.
  2. 왼쪽 사이드바에서 Settings > General을 선택합니다.
  3. GitLab for Slack app을 확장합니다.
  4. Download latest manifest file을 선택해 slack_manifest.json을 다운로드합니다.
• Slack에서:
  1. Slack API로 이동합니다.
  2. **GitLab (<your host name>)**을 검색해 선택합니다.
  3. 왼쪽 사이드바에서 App Manifest를 선택합니다.
  4. JSON 탭을 선택해 매니페스트의 JSON 보기로 전환합니다.
  5. GitLab에서 다운로드한 slack_manifest.json 파일의 내용을 복사합니다.
  6. 복사한 내용을 JSON 뷰어에 붙여 넣어 기존 내용을 대체합니다.
  7. Save Changes를 선택합니다.

연결 요구 사항#

GitLab for Slack 앱 기능을 켜려면 네트워크가 GitLab과 Slack 사이의 인바운드 및 아웃바운드 연결을 허용해야 합니다.

• Slack 알림을 사용하려면 GitLab 인스턴스가 https://slack.com으로 요청을 보낼 수 있어야 합니다.
• 슬래시 명령과 그 밖의 기능을 사용하려면 GitLab 인스턴스가 https://slack.com에서 오는 요청을 받을 수 있어야 합니다.

여러 워크스페이스 지원 활성화#

기본적으로 GitLab for Slack 앱은 Slack 워크스페이스 한 곳에만 설치할 수 있습니다. 관리자는 GitLab for Slack 앱을 만들 때 이 워크스페이스를 선택합니다.

여러 Slack 워크스페이스에 대한 지원을 켜려면 GitLab for Slack 앱을 비공개 배포 앱으로 구성해야 합니다. 비공개 배포 앱의 특징은 다음과 같습니다:

• Slack App Directory에 게시되지 않습니다.
• 다른 사이트가 아니라 사용 중인 GitLab 인스턴스에서만 사용할 수 있습니다.

GitLab for Slack 앱을 비공개 배포 앱으로 구성하려면 다음 단계를 따릅니다:

1. Slack의 Your Apps 페이지로 이동해 GitLab for Slack 앱을 선택합니다.
2. Manage Distribution을 선택합니다.
3. Share Your App with Other Workspaces 섹션에서 Remove Hard Coded Information을 확장합니다.
4. I've reviewed and removed any hard-coded information 확인란을 선택합니다.
5. Activate Public Distribution을 선택합니다.

문제 해결#

GitLab for Slack 앱을 관리할 때 다음과 같은 문제가 발생할 수 있습니다.

Slack에서 슬래시 명령이 dispatch_failed를 반환하는 경우#

Slack에서 슬래시 명령이 /gitlab failed with the error "dispatch_failed"를 반환할 수 있습니다.

이 문제를 해결하려면 다음을 확인합니다:

• GitLab for Slack 앱이 올바르게 구성되어 있고 Enable GitLab for Slack app 확인란이 선택되어 있습니다.
• GitLab 인스턴스가 Slack과 주고받는 요청을 허용합니다.