Slack 앱 관리를 위한 GitLab

Tier: Free, Premium, Ultimate Offering: Self-managed
  • GitLab 16.2에서 Self-managed용으로 도입되었습니다.
note

이 페이지에는 Slack 앱을 위한 관리자 문서가 포함되어 있습니다. 사용자 문서는 GitLab for Slack app을 참조하세요.

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

이 앱은 Slack 워크스페이스에만 설치된 개인적인 일회성 복사본이며 Slack App Directory를 통해 배포되지 않습니다. 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은 앱에 대한 요약을 표시합니다. 전체 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라는 플래그와 함께 도입되었습니다. 기본적으로 비활성화됩니다.

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 앱 업데이트

전제 조건:
최소한 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. 왼쪽 사이드바에서 앱 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 앱이 올바르게 구성되었으며 Enable GitLab for Slack app 확인란이 선택되었습니다.
  • GitLab 인스턴스가 Slack으로의 요청 및 응답을 허용하도록 설정되어 있는지 확인하십시오.