텔레그램

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

도입됨 GitLab 16.1에서.

GitLab을 구성하여 텔레그램 채팅이나 채널에 알림을 보낼 수 있습니다.
텔레그램 통합을 설정하려면 다음을 수행해야 합니다:

텔레그램 봇 만들기

텔레그램에서 봇을 만들려면:

봇을 만들면 BotFather가 API 토큰을 제공합니다. 이 토큰을 안전하게 보관하세요. 텔레그램에서 봇을 인증하는 데 필요합니다.

텔레그램에서 봇을 구성하려면:

봇을 새 채널 또는 기존 채널의 관리자로 추가합니다.
봇에게 이벤트를 수신하기 위한 게시 메시지 권한을 부여합니다.
채널에 대한 식별자를 만듭니다.
- 공개 채널의 경우, 공개 링크를 입력하고 채널 식별자를 복사합니다 (예: https:/t.me/MY_IDENTIFIER).
- 비공개 채널의 경우, API 토큰으로 getUpdates 메서드를 사용하고 채널 식별자를 복사합니다 (예: -2241293890657).

메시지 스레드 ID 도입됨 GitLab 16.11에서.

호스트 이름 도입됨 GitLab 17.1에서.

봇을 텔레그램 채널에 초대한 후, GitLab이 알림을 보내도록 구성할 수 있습니다:

통합을 활성화하려면:
- 그룹 또는 프로젝트의 경우:
  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트 또는 그룹을 찾습니다.
  2. 설정 > 통합을 선택합니다.
- 인스턴스의 경우:
  1. 왼쪽 사이드바에서 하단에 있는 관리자를 선택합니다.
  2. 설정 > 통합을 선택합니다.
텔레그램을 선택합니다.
통합 활성화에서 활성 체크박스를 선택합니다.
선택 사항. 호스트 이름에 로컬 봇 API 서버의 호스트 이름을 입력합니다.
토큰에서 텔레그램 봇의 토큰 값을 붙여넣습니다.
트리거 섹션에서 텔레그램에서 받고 싶은 GitLab 이벤트에 대한 체크박스를 선택합니다.
알림 설정 섹션에서:
- 채널 식별자에 텔레그램 채널 식별자를 붙여넣습니다.
- 선택 사항. 메시지 스레드 ID에 대상 메시지 스레드(포럼 슈퍼그룹의 주제)에 대한 고유 식별자를 붙여넣습니다.
- 선택 사항. 중단된 파이프라인만 알림 체크박스를 선택하여 실패한 파이프라인 관련 알림만 받습니다.
- 선택 사항. 알림을 받을 브랜치 드롭다운 목록에서 알림을 받을 브랜치를 선택합니다.
선택 사항. 설정 테스트를 선택합니다.
변경 사항 저장을 선택합니다.

이제 텔레그램 채널에서 선택한 모든 GitLab 이벤트를 받을 수 있습니다.