BigW Consortium Gitlab

irker.md 2 KB
Newer Older
Aorimn committed
1 2 3 4 5 6
# 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.

Stan Hu committed
7
See the project homepage for further info: https://gitlab.com/esr/irker
Aorimn committed
8 9 10 11

## Needed setup

You will first need an Irker daemon. You can download the Irker code from its
12
repository on https://gitlab.com/esr/irker:
Aorimn committed
13

14 15 16
```
git clone https://gitlab.com/esr/irker.git
```
Aorimn committed
17

18 19 20 21
Once you have downloaded the code, you can run the python script named `irkerd`.
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.
Aorimn committed
22

23 24
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.
Aorimn committed
25

26 27 28 29 30 31 32 33 34 35 36
## Complete these steps in GitLab:

1. Navigate to the project you want to configure for notifications.
1. Select "Settings" in the top navigation.
1. Select "Services" in the left navigation.
1. Click "Irker".
1. Select the "Active" checkbox.
1. Enter the server host address where `irkerd` runs (defaults to `localhost`)
in the `Server host` field on the Web page
1. Enter the server port of `irkerd` (e.g. defaults to 6659) in the
`Server port` field on the Web page.
37
1. Optional: if `Default IRC URI` is set, it has to be in the format
38 39 40 41
`irc[s]://domain.name` and will be prepend to each and every channel provided
by the user which is not a full URI.
1. Specify the recipients (e.g. #channel1, user1, etc.)
1. Save or optionally click "Test Settings".
Aorimn committed
42 43 44 45 46

## Note on Irker recipients

Irker accepts channel names of the form `chan` and `#chan`, both for the
`#chan` channel. If you want to send messages in query, you will need to add
47
`,isnick` after the channel name, in this form: `Aorimn,isnick`. In this latter
Aorimn committed
48 49 50 51
case, `Aorimn` is treated as a nick and no more as a channel name.

Irker can also join password-protected channels. Users need to append
`?key=thesecretpassword` to the chan name.