GitLab for Slack 앱 관리

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

Slack 앱 디렉토리를 통해 배포된 GitLab for Slack 앱은 GitLab.com에서만 작동합니다. Self-Managed GitLab에서는 manifest 파일에서 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으로 리디렉션됩니다.

  • 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 (<호스트 이름>)을 검색하고 선택합니다.
    3. 앱 자격 증명으로 이동합니다.
  6. 변경 사항 저장을 선택합니다.

구성 테스트

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

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

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

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

GitLab for Slack 앱 설치

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. Slack 확인 페이지에서 허용을 선택합니다.

GitLab for 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 (<호스트 이름>)을 검색하고 선택합니다.
    3. 왼쪽 사이드바에서 앱 manifest를 선택합니다.
    4. JSON 탭을 선택하여 manifest의 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 failed with the error "dispatch_failed"를 반환할 수 있습니다.

이 문제를 해결하려면:

  • GitLab for Slack 앱이 올바르게 구성되었으며 GitLab for Slack app 활성화 확인란이 선택되어 있는지 확인하십시오.
  • GitLab 인스턴스가 Slack과의 요청을 허용하는지 확인하십시오.