GitLab for Slack 앱 관리

Tier: Free, Premium, Ultimate Offering: Self-managed
note
이 페이지는 GitLab for Slack 앱에 대한 관리자 문서를 포함합니다. 사용자 문서는 GitLab for Slack 앱을 참조하세요.

GitLab for Slack 앱은 Slack App Directory를 통해 배포되는 경우 GitLab.com에서만 작동합니다.
Self-managed GitLab에서는 매니페스트 파일을 통해 GitLab for Slack 앱의 복사본을 생성하고 인스턴스를 구성할 수 있습니다.

이 앱은 Slack 작업 공간에만 설치된 비공식적인 복사본으로, Slack App Directory를 통해 배포되지 않습니다.
Self-managed 인스턴스에 GitLab for Slack 앱을 사용하려면, 통합을 활성화해야 합니다.

GitLab for 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 앱 구성을 테스트하려면:

  1. Slack 작업 공간의 채널에 /gitlab help 슬래시 명령어를 입력합니다.
  2. Enter를 누릅니다.

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

프로젝트에 대해 Slash 명령어를 사용하려면, 프로젝트용 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. 왼쪽 사이드바 하단에서 Admin을 선택합니다.
  2. Settings > Integrations을 선택합니다.
  3. GitLab for Slack app을 선택합니다.
  4. Install GitLab for Slack app을 선택합니다.
  5. Slack 확인 페이지에서 Allow를 선택합니다.

GitLab for 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 (<your host name>)를 검색하고 선택합니다.
    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 failed with the error "dispatch_failed"를 반환할 수 있습니다.

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

  • GitLab for Slack 앱이 적절하게 구성되어 있고 GitLab for Slack 앱 사용 체크박스가 선택되어 있습니다.
  • 귀하의 GitLab 인스턴스가 Slack으로의 요청을 허용합니다 연결 요구 사항.