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 서버가 같은 머신에서 실행된다면 여기까지로 설정이 끝납니다. 그렇지 않다면 다음 섹션의 앞부분 단계를 따라야 합니다.

GitLab에서 수행할 단계#

1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
2. 왼쪽 사이드바에서 Settings > Integrations를 선택합니다.
3. **irker (IRC gateway)**를 선택합니다.
4. Enable integration 아래에서 Active 체크박스를 선택합니다.
5. 선택 사항. Server host 아래에 irkerd가 실행되는 서버 호스트 주소를 입력합니다. 비워 두면 기본값은 localhost입니다.
6. 선택 사항. Server port 아래에 irkerd의 서버 포트를 입력합니다. 비워 두면 기본값은 6659입니다.
7. 선택 사항. Default IRC URI 아래에 irc[s]://domain.name 형식으로 기본 IRC URI를 입력합니다. 이 값은 Recipients 아래에 전체 URI가 아닌 형태로 입력한 모든 채널이나 사용자 앞에 붙습니다.
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입니다.