Slack 앱 관리를 위한 GitLab

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

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

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

GitLab for Slack 앱 생성

필수 조건:

GitLab for Slack 앱을 생성하려면:

  • GitLab에서:

    1. 왼쪽 사이드바에서 맨 아래에서 관리 영역을 선택합니다.
    2. 왼쪽 사이드바에서 설정 > 일반을 선택합니다.
    3. GitLab for Slack 앱을 확장합니다.
    4. 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 앱 구성을 테스트하려면:

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

사용 가능한 슬래시 명령 목록이 표시되어야 합니다.

프로젝트에 대한 슬래시 명령을 사용하려면 프로젝트용 GitLab for Slack 앱을 구성하세요.

GitLab for Slack 앱 설치

  • 기능 플래그가 GitLab 16.10에서 gitlab_for_slack_app_instance_and_group_level로 소개되었습니다. 기본적으로 비활성화됨.
Self-Managed GitLab의 경우 기본적으로 이 기능은 사용할 수 없습니다. 이를 사용하려면 관리자가 gitlab_for_slack_app_instance_and_group_level이라는 기능 플래그를 활성화해야 합니다. GitLab.com의 경우, 이 기능은 사용 가능하지만 GitLab.com 관리자만 구성할 수 있습니다. GitLab Dedicated의 경우, 이 기능은 사용할 수 없습니다.

필수 조건:

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

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

GitLab for Slack 앱 업데이트

필수 조건:

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 앱을 관리하는 동안 다음과 같은 문제가 발생할 수 있습니다.

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

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

슬래시 명령은 Slack에서 /gitlab이 “dispatch_failed” 오류와 함께 반환될 수 있습니다.

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

  • GitLab for Slack 앱이 올바르게 구성되었으며 GitLab for Slack 앱 활성화 확인란이 선택되었습니다.
  • GitLab 인스턴스가 Slack과의 요청을 허용하고 있는지 확인하세요.