Telegram

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

GitLab 16.1에서 소개.

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

Telegram 봇 생성

Telegram에서 봇을 생성하려면:

봇을 생성하면 BotFather가 API 토큰을 제공합니다. 이 토큰은 봇을 Telegram에서 인증하는 데 사용되므로 안전하게 보관해야 합니다.

Telegram에서 봇을 구성하려면:

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

메시지 스레드 ID GitLab 16.11에서 소개.
호스트 이름 GitLab 17.1에서 소개.

봇을 Telegram 채널에 초대한 후 GitLab을 구성하여 다음을 수행할 수 있습니다:

통합을 활성화하려면 다음을 수행합니다:
- 그룹이나 프로젝트의 경우:
  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하여 프로젝트나 그룹을 찾습니다.
  2. 설정 > 통합을 선택합니다.
- 인스턴스의 경우:
  1. 왼쪽 사이드바에서 맨 아래에서 관리자를 선택합니다.
  2. 설정 > 통합을 선택합니다.
Telegram을 선택합니다.
통합 활성화 아래에서 활성 확인란을 선택합니다.
선택 사항. 호스트 이름에 로컬 봇 API 서버의 호스트 이름을 입력합니다.
토큰에 Telegram 봇에서 값 붙여넣기합니다.
트리거 섹션에서 Telegram에서 수신하려는 GitLab 이벤트에 대해 확인란을 선택합니다.
알림 설정 섹션에서:
- 채널 식별자에 Telegram 채널 식별자 붙여넣기합니다.
- 선택 사항. 메시지 스레드 ID에 대상 메시지 스레드(포럼 수퍼그룹의 주제)의 고유 식별자 붙여넣기
- 선택 사항. 오직 실패한 파이프라인에 대해서만 알림 확인란을 선택하여 실패한 파이프라인에 대해서만 알림을 받습니다.
- 선택 사항. 알림을 받을 브랜치 드롭다운 목록에서 알림을 받기를 원하는 브랜치를 선택합니다.
선택 사항. 설정 테스트를 선택합니다.
변경 사항 저장을 선택합니다.

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