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

1. Telegram 봇 만들기.
2. Telegram 봇 구성.
3. GitLab에서 Telegram 통합 설정.

Telegram 봇 만들기#

Telegram에서 봇을 만들려면:

1. @BotFather와 새 채팅을 시작합니다.
2. Telegram 문서에 설명된 대로 새 봇 만들기를 수행합니다.

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

Telegram 봇 구성#

Telegram에서 봇을 구성하려면:

1. 새 채널이나 기존 채널에 봇을 관리자로 추가합니다.
2. 이벤트를 받으려면 봇에 메시지 게시 권한을 할당합니다.
3. 채널의 식별자를 만듭니다.
   • 공개 채널의 경우 공개 링크를 입력하고 채널 식별자를 복사합니다(예: https:/t.me/MY_IDENTIFIER).
   • 비공개 채널의 경우 API 토큰과 함께 getUpdates 방법을 사용하고 채널 식별자를 복사합니다(예: -2241293890657).

GitLab에서 Telegram 통합 설정#

사전 요구사항:

• 인스턴스 활성화를 위한 관리자 액세스.
• 그룹 활성화를 위한 Owner 역할.
• 프로젝트 활성화를 위한 Maintainer 또는 Owner 역할.

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

1. 통합을 활성화하려면:
   • 그룹 또는 프로젝트의 경우:
     1. 상단 바에서 검색 또는 이동을 선택하고 프로젝트 또는 그룹을 찾습니다.
     2. 설정 > 통합을 선택합니다.
   • 인스턴스의 경우:
     1. 오른쪽 상단에서 관리자를 선택합니다.
     2. 설정 > 통합을 선택합니다.
2. Telegram을 선택합니다.
3. 통합 활성화 아래에서 활성 체크박스를 선택합니다.
4. 선택사항. 호스트 이름에 로컬 봇 API 서버의 호스트 이름을 입력합니다.
5. 토큰에 Telegram 봇의 토큰 값을 붙여넣습니다.
6. 트리거 섹션에서 Telegram에서 받을 GitLab 이벤트에 대한 체크박스를 선택합니다.
7. 알림 설정 섹션에서:
   • 채널 식별자에 Telegram 채널 식별자를 붙여넣습니다.
   • 선택사항. 메시지 스레드 ID에 대상 메시지 스레드(포럼 슈퍼그룹의 주제)의 고유 식별자를 붙여넣습니다.
   • 선택사항. 실패한 파이프라인만 알림 체크박스를 선택하여 실패한 파이프라인에 대한 알림만 받습니다.
   • 선택사항. 상태가 변경될 때만 알림 체크박스를 선택하여 ref의 파이프라인 상태가 변경될 때만 알림을 받습니다.
   • 선택사항. 알림을 보낼 브랜치 드롭다운 목록에서 알림을 받을 브랜치를 선택합니다.
8. 선택사항. 설정 테스트를 선택합니다.
9. 변경 사항 저장을 선택합니다.

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