Telegram

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

GitLab 16.1에서 소개됨.

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

Telegram 봇 생성

Telegram에서 봇을 생성하려면:

봇을 생성하면 BotFather가 API 토큰을 제공합니다. 이 토큰은 봇의 인증에 필요하므로 안전하게 보관하세요.

Telegram에서 봇을 구성하려면:

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

메시지 스레드 ID GitLab 16.11에서 소개됨.

Telegram 채널로 봇을 초대한 후 GitLab을 구성하여 알림을 보낼 수 있습니다:

통합을 활성화하려면:
- 그룹 또는 프로젝트의 경우:
  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하여 프로젝트 또는 그룹을 찾습니다.
  2. 설정 > 통합을 선택합니다.
- 인스턴스의 경우:
  1. 왼쪽 사이드바에서 맨 아래에서 관리 영역을 선택합니다.
  2. 설정 > 통합을 선택합니다.
Telegram을 선택합니다.
통합 활성화 아래에서 활성 확인란을 선택합니다.
토큰에 Telegram 봇에서 값을 붙여넣기합니다.
트리거 섹션에서 Telegram에서 받고 싶은 GitLab 이벤트용 확인란을 선택합니다.
알림 설정 섹션에서:
- 채널 식별자에 Telegram 채널 식별자를 붙여넣기합니다.
- 선택 사항. 메시지 스레드 ID에 대상 메시지 스레드(포럼 슈퍼그룹의 주제)를 위한 고유 식별자를 붙여넣기합니다.
- 선택 사항. 손상된 파이프라인에만 알림 받기 확인란을 선택하여 실패한 파이프라인에 대해서만 알림을 받습니다.
- 선택 사항. 알림을 받을 브랜치 드롭다운 디렉터리에서 알림을 받고 싶은 브랜치를 선택합니다.
선택 사항. 설정 테스트를 선택합니다.
변경 사항 저장을 선택합니다.

이제 Telegram 채널은 선택한 모든 GitLab 이벤트를 수신할 수 있습니다.