irker (IRC 게이트웨이)

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

GitLab은 irker 서버에 업데이트 메시지를 푸시하는 방법을 제공합니다. 통합을 구성한 후, 프로젝트에 대한 각 푸시는 데이터를 직접 irker 서버로 전송하도록 통합을 트리거합니다.

irker 통합 API 문서도 참조하세요.

자세한 내용은 irker 프로젝트 홈 페이지를 참조하세요.

irker 데몬 설정하기

irker 데몬을 설정해야 합니다. 그렇게 하려면:

  1. irker 코드를 저장소에서 다운로드합니다:

    git clone https://gitlab.com/esr/irker.git  
    
  2. irkerd라는 이름의 Python 스크립트를 실행합니다. 이것이 게이트웨이 스크립트입니다.
    IRC 서버에 메시지를 보내기 위한 IRC 클라이언트 역할과 GitLab 서비스에서 메시지를 수신하기 위한 TCP 서버 역할을 합니다.

irker 서버가 동일한 머신에서 실행되는 경우 설정이 완료됩니다. 그렇지 않다면, 다음 섹션의 첫 번째 단계를 따라야 합니다.

caution
irker는 내장 인증이 없으므로 방화벽 외부에서 호스팅되는 경우 IRC 채널에 스팸을 유발할 수 있습니다. 남용을 방지하기 위해, 보안된 네트워크에서 데몬을 실행하세요. 자세한 내용은 irker의 보안 분석을 참조하세요.

GitLab에서 이 단계를 완료하세요

  1. 왼쪽 사이드바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. Settings > Integrations를 선택합니다.
  3. irker (IRC gateway)를 선택합니다.
  4. Active 토글이 활성화되어 있는지 확인합니다.
  5. 선택 사항. Server host에서 irkerd가 실행되는 서버 호스트 주소를 입력합니다. 비어 있으면 기본값은 localhost입니다.
  6. 선택 사항. Server port에서 irkerd의 서버 포트를 입력합니다. 비어 있으면 기본값은 6659입니다.
  7. 선택 사항. Default IRC URI에서 기본 IRC URI를 입력합니다. 형식은 irc[s]://domain.name입니다.
    이는 Recipients에 제공된 모든 채널 또는 사용자에 추가됩니다.
  8. Recipients에서 업데이트를 수신할 사용자 또는 채널을 입력합니다. 공백으로 구분합니다
    (예: #channel1 user1). 자세한 내용은 irker 수신자 입력을 참조하세요.
  9. 선택 사항. 메시지를 강조 표시하려면 Colorize messages 체크박스를 선택합니다.
  10. 선택 사항. Test settings를 선택합니다.
  11. Save changes를 선택합니다.

irker 수신자 입력

Default IRC URI 필드를 비워 두었다면, 수신자를 전체 URI 형식으로 입력합니다:
irc[s]://irc.network.net[:port]/#channel. 기본 IRC URI를 입력한 경우, 채널 또는 사용자 이름만 사용할 수 있습니다.

메시지를 보내려면:

  • 채널(예: #chan)에 irker는 chan#chan 형식의 채널 이름을 허용합니다.
  • 비밀번호 보호된 채널에 대해서는 채널 이름 뒤에 ?key=thesecretpassword를 추가합니다.
    이 때, 채널 비밀번호 대신 thesecretpassword를 사용합니다. 예: chan?key=hunter2.
    채널 이름 앞에 # 기호를 넣지 마세요. 그렇게 하면 irker가 #chan?key=password라는 이름의 채널에 참여하려고 하며, /whois IRC 명령을 통해 채널 비밀번호가 유출될 수 있습니다. 이는 오랜 irker 버그로 인한 것입니다.
  • 사용자 쿼리에서는 사용자 이름 뒤에 ,isnick을 추가합니다. 예: UserSmith,isnick.