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

이 앱은 Slack 앱 디렉토리를 통해 배포되지 않고 Slack 워크스페이스에만 설치되는 비공개 일회성 복사본입니다. GitLab Self-Managed 인스턴스에서 GitLab for Slack 앱을 사용하려면 통합을 활성화해야 합니다.

GitLab for Slack 앱 만들기#

사전 요구 사항:

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

GitLab for Slack 앱을 만들려면:

• GitLab에서:

  1. 오른쪽 상단에서 관리자를 선택합니다.
  2. 왼쪽 사이드바에서 설정 > 일반을 선택합니다.
  3. GitLab for Slack 앱을 확장합니다.
  4. Slack 앱 만들기를 선택합니다.

그러면 다음 단계를 위해 Slack으로 리디렉션됩니다.

• Slack에서:

  1. 앱을 만들 Slack 워크스페이스를 선택한 다음 다음을 선택합니다.
  2. Slack에 검토를 위한 앱 요약이 표시됩니다. 전체 매니페스트를 보려면 구성 편집을 선택합니다. 검토 요약으로 돌아가려면 다음을 선택합니다.
  3. 만들기를 선택합니다.
  4. 알겠습니다를 선택하여 대화 상자를 닫습니다.
  5. 워크스페이스에 설치를 선택합니다.

설정 구성#

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

1. 오른쪽 상단에서 관리자를 선택합니다.
2. 왼쪽 사이드바에서 설정 > 일반을 선택합니다.
3. GitLab for Slack 앱을 확장합니다.
4. GitLab for Slack 앱 활성화 확인란을 선택합니다.
5. GitLab for Slack 앱 세부 정보를 입력합니다:
   1. Slack API로 이동합니다.
   2. GitLab (<호스트 이름>) 을 검색하여 선택합니다.
   3. 앱 자격 증명으로 스크롤합니다.
6. 변경 사항 저장을 선택합니다.

GitLab for Slack 앱 설치#

사전 요구 사항:

• Slack 워크스페이스에 앱을 추가하려면 적절한 권한이 있어야 합니다.
• GitLab for Slack 앱을 만들고 앱 설정을 구성해야 합니다.

인스턴스 설정에서 GitLab for Slack 앱을 설치하려면:

1. 오른쪽 상단에서 관리자를 선택합니다.
2. 왼쪽 사이드바에서 설정 > 통합을 선택합니다.
3. GitLab for Slack 앱을 선택합니다.
4. GitLab for Slack 앱 설치를 선택합니다.
5. Slack 확인 페이지에서 허용을 선택합니다.

구성 테스트#

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. 오른쪽 상단에서 관리자를 선택합니다.
  2. 왼쪽 사이드바에서 설정 > 일반을 선택합니다.
  3. GitLab for Slack 앱을 확장합니다.
  4. 최신 매니페스트 파일 다운로드를 선택하여 slack_manifest.json을 다운로드합니다.
• Slack에서:
  1. Slack API로 이동합니다.
  2. GitLab (<호스트 이름>) 을 검색하여 선택합니다.
  3. 왼쪽 사이드바에서 앱 매니페스트를 선택합니다.
  4. JSON 탭을 선택하여 매니페스트의 JSON 뷰로 전환합니다.
  5. GitLab에서 다운로드한 slack_manifest.json 파일의 내용을 복사합니다.
  6. JSON 뷰어에 내용을 붙여 넣어 기존 내용을 교체합니다.
  7. 변경 사항 저장을 선택합니다.

연결 요구 사항#

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 앱 디렉토리에 게시되지 않습니다.
• 다른 사이트가 아닌 GitLab 인스턴스에서만 사용할 수 있습니다.

GitLab for Slack 앱을 목록에 없는 배포 앱으로 구성하려면:

1. Slack의 내 앱 페이지로 이동하여 GitLab for Slack 앱을 선택합니다.
2. 배포 관리를 선택합니다.
3. 다른 워크스페이스와 앱 공유 섹션에서 하드 코딩된 정보 제거를 확장합니다.
4. 하드 코딩된 정보를 검토하고 제거했습니다 확인란을 선택합니다.
5. 공개 배포 활성화를 선택합니다.

문제 해결#

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

사용자 문서는 GitLab for Slack 앱을 참조하세요.

Slack에서 슬래시 명령이 dispatch_failed를 반환#

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

이 문제를 해결하려면 다음을 확인하세요:

• GitLab for Slack 앱이 올바르게 구성되어 있고 GitLab for Slack 앱 활성화 확인란이 선택되어 있습니다.
• GitLab 인스턴스가 Slack에서의 요청을 허용합니다.