GitLab for Slack 앱 관리

Tier: Free, Premium, Ultimate Offering: Self-Managed
  • GitLab 16.2에서 Self-Managed를 위해 도입되었습니다.
note
이 페이지에는 GitLab for Slack 앱의 관리자 설명서가 포함되어 있습니다. 사용자 설명서는 GitLab for Slack 앱을 참조하세요.

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

이 앱은 슬랙 워크스페이스에 설치된 개인 단일 복사본이며 슬랙 앱 디렉터리를 통해 배포되지 않습니다. Self-Managed 인스턴스에서 GitLab for Slack 앱을 사용하려면 통합을 활성화해야 합니다.

GitLab for Slack 앱 생성

전제 조건:

  • 최소한 Slack 워크스페이스 관리자여야 합니다(https://slack.com/help/articles/360018112273-Types-of-roles-in-Slack).

GitLab for Slack 앱을 생성하려면:

  • GitLab에서:

    1. 왼쪽 사이드바에서 맨 아래에서 관리 영역을 선택합니다.
    2. 왼쪽 사이드바에서 설정 > 일반을 선택합니다.
    3. GitLab for Slack 앱을 확장합니다.
    4. 슬랙 앱 생성을 선택합니다.

그럼 이후 단계로 Slack으로 리디렉션됩니다.

  • Slack에서:

    1. 앱을 생성할 Slack 워크스페이스를 선택한 다음 다음을 선택합니다.
    2. Slack은 앱 요약을 보여줍니다. 전체 manifest를 보려면 구성 편집을 선택하세요. 다시 요약으로 돌아가려면 다음을 선택하세요.
    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 (<your host name>)을 검색하고 선택합니다.
    3. 앱 자격 증명으로 스크롤합니다.
  6. 변경 사항 저장을 선택합니다.

구성 테스트

GitLab for Slack 앱 구성을 테스트하려면:

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

사용 가능한 슬래시 명령 디렉터리이 표시되어야 합니다.

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

GitLab for Slack 앱 설치

  • 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에서는 이 기능을 사용할 수 있습니다.

전제 조건:

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

  1. 왼쪽 사이드바에서 맨 아래에서 관리 영역을 선택합니다.
  2. 설정 > 통합을 선택합니다.
  3. GitLab for Slack 앱을 선택합니다.
  4. GitLab for Slack 앱 설치를 선택합니다.
  5. 슬랙 확인 페이지에서 허용을 선택합니다.

GitLab for Slack 앱 업데이트

전제 조건:

  • 최소한 Slack 워크스페이스 관리자여야 합니다(https://slack.com/help/articles/360018112273-Types-of-roles-in-Slack).

GitLab이 GitLab for Slack 앱에 대한 새로운 기능을 출시하면 새로운 기능을 사용하려면 복사본을 매뉴얼으로 업데이트해야 할 수 있습니다.

GitLab for Slack 앱의 복사본을 업데이트하려면:

  • GitLab에서:

    1. 왼쪽 사이드바에서 맨 아래에서 관리 영역을 선택합니다.
    2. 왼쪽 사이드바에서 설정 > 일반을 선택합니다.
    3. GitLab for Slack 앱을 확장합니다.
    4. 최신 manifest 파일 다운로드를 선택하여 slack_manifest.json을 다운로드합니다.

  • Slack에서:

    1. Slack API로 이동합니다.
    2. GitLab (<your host name>)을 검색하고 선택합니다.
    3. 왼쪽 사이드바에서 앱 매니페스트를 선택합니다.
    4. JSON 탭을 선택하여 manifest의 JSON 뷰로 전환합니다.
    5. GitLab에서 다운로드한 slack_manifest.json 파일의 내용을 복사합니다.
    6. 복사한 내용을 JSON 뷰어에 붙여넣어 기존 내용을 바꿉니다.
    7. 변경 사항 저장을 선택합니다.

연결 요구 사항

GitLab for Slack 앱 기능을 활성화하려면 네트워크가 GitLab과 Slack 간의 들어오고 나가는 연결을 허용해야 합니다.

  • 슬랙 알림을 위해 GitLab 인스턴스는 https://slack.com로 요청을 보낼 수 있어야 합니다.
  • 슬래시 명령 및 기타 기능을 위해 GitLab 인스턴스는 https://slack.com에서의 요청을 수신할 수 있어야 합니다.

문제 해결

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

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

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

슬래시 명령이 Slack에서 /gitlab이 "dispatch_failed" 오류로 실패함을 반환할 수 있습니다.

이 문제를 해결하려면:

  • GitLab for Slack 앱이 올바르게 구성되었으며 GitLab for Slack 앱 활성화 확인란이 선택되어 있는지 확인합니다.
  • GitLab 인스턴스가 슬랙에게 요청을 허용하고 받을 수 있는지 확인합니다.