Skip to content

Irker IRC Gateway

GitLab provides a way to push update messages to an Irker server. When configured, pushes to a project will trigger the service to send data directly to the Irker server.

See the project homepage for further info:https://gitlab.com/esr/irker

Needed setup

You will first need an Irker daemon. You can download the Irker code from its repository onhttps://gitlab.com/esr/irker:

git clone https://gitlab.com/esr/irker.git

Once you have downloaded the code, you can run the python script namedirkerd. This script is the gateway script, it acts both as an IRC client, for sending messages to an IRC server obviously, and as a TCP server, for receiving messages from the GitLab service.

If the Irker server runs on the same machine, you are done. If not, you will need to follow the firsts steps of the next section.

Complete these steps in GitLab

  1. Navigate to the project you want to configure for notifications.
  2. Navigate to theIntegrations page
  3. Click "Irker".
  4. Select the "Active" checkbox.
  5. Enter the server host address whereirkerdruns (defaults tolocalhost) in theServer hostfield on the Web page
  6. Enter the server port ofirkerd(e.g. defaults to 6659) in theServer portfield on the Web page.
  7. Optional: ifDefault IRC URIis set, it has to be in the formatirc[s]://domain.nameand will be prepend to each and every channel provided by the user which is not a full URI.
  8. Specify the recipients (e.g. #channel1, user1, etc.)
  9. Save or optionally click "Test Settings".

Note on Irker recipients

Irker accepts channel names of the formchanand#chan, both for the#chanchannel. If you want to send messages in query, you will need to add,isnickafter the channel name, in this form:Aorimn,isnick. In this latter case,Aorimnis treated as a nick and no more as a channel name.

Irker can also join password-protected channels. Users need to append?key=thesecretpasswordto the chan name. When using this feature remember tonotput the#sign in front of the channel name; failing to do so will result on irker joining a channel literally named#chan?key=passwordhenceforth leaking the channel key through the/whoisIRC命令(取决于IRC服务器配置). This is due to a long standing irker bug.

Baidu
map