Skip to content

Latest commit

 

History

History
98 lines (73 loc) · 5.31 KB

README.md

File metadata and controls

98 lines (73 loc) · 5.31 KB

limnoria-gitlab

limnoria-gitlab is a plugin for limnoria that provides support for gitlab webhook notifications. Currently it has the following features:

  • Support of push, tag, issue, comment and merge request events
  • Commands to manage subscribed projects per channel
  • Localization

Installation

To install this plugin just copy its directory to the supybot.directories.plugins directory of your limnoria instance and enable it in your configuration file under supybot.plugins. For more information checkout the Supybot user guide.

Configuration

The limnoria-gitlab plugin uses the build-in web service of Limnoria therefore it listens on the address configured by supybot.servers.http.hosts[4,6] and supybot.servers.http.port. For more information on the HTTP server of Limnoria checkout the 'Using the HTTP server' chapter of their documentation.

Depending on the configuration of your Limnoria instance and your web server the plugin now listens on the following address where it accepts the network and the channel as a parameter:

http://<host>:<port>/gitlab/<network>

The placeholders are defined as followed:

  • <host> - The host defined by the external IP of the service
  • <port> - The port that the HTTP server of Limnoria listens to
  • <network> - The network that the Limnoria instance is connected to

For instance if your bot is in the OFTC network and in the #limnoria-gitlab channel, the plugin listens on the following URL for webhook notifications:

http://limnoria.example.com:8080/gitlab/OFTC

Now you need to add this address as a new webhook in the project settings of your Gitlab instance. Therefore you go to Settings -> Webhooks and click Add Web Hook after you've entered the above address under URL and selected the checkboxes for the types of notifications you want to be send to the channel.

Commands

  • gitlab project add [<channel>] <project-slug> <project-host> - This command subscribes a new project to the channel:

    • [<channel>] - The channel that should be used. (Optional, defaults to the current channel)
    • <project-slug> - The slug of the gitlab project
    • <project-host> - The host of the gitlab project

    Example: To subscribe the example_project to the current channel you can run the following command: gitlab project add example_project https://gitlab.example.com/foo/example_project

  • gitlab project remove [<channel>] <project-slug> - This command removes a subscribed project from the channel:

    • [<channel>] - The channel that should be used. (Optional, defaults to the current channel)
    • <project-slug - The slug of the gitlab project

  • gitlab project list [<channel>] - Lists the subscribed projects from the channel:

    • [<channel>] - The channel that should be used. (Optional, defaults to the current channel)

Options

The following option can be set for each channel and defines the list of subscribed projects (this option should only be set by the commands of this plugin).

  • plugins.Gitlab.projects - Saves the subscribed project mappings (Default: empty) Readonly!

In addition all the formats that are used to notify the channel about changes on the Gitlab project can be configured:

  • plugins.Gitlab.format.push - The format that is used if a milestone has been created
  • plugins.Gitlab.format.commit - The format that is used if a milestone has been deleted
  • plugins.Gitlab.format.tag - The format that is used if a milestone has been changed
  • plugins.Gitlab.format.issue-open - The format that is used if an issue has been created
  • plugins.Gitlab.format.issue-update - The format that is used if an issue has been updated
  • plugins.Gitlab.format.issue-close - The format that is used if an issue has been closed
  • plugins.Gitlab.format.issue-reopen - The format that is used if an issue has been reopened
  • plugins.Gitlab.format.merge-request-open - The format that is used if an merge request has been created
  • plugins.Gitlab.format.merge-request-update - The format that is used if an merge request has been updated
  • plugins.Gitlab.format.merge-request-close - The format that is used if an merge request has been closed
  • plugins.Gitlab.format.merge-request-reopen - The format that is used if an merge request has been reopened
  • plugins.Gitlab.format.merge-request-merge - The format that is used if an merge request has been merged
  • plugins.Gitlab.format.note-merge-request - The format that is used if someone commented on a merge request
  • plugins.Gitlab.format.note-commit - The format that is used if someone commented on a commit
  • plugins.Gitlab.format.note-issue - The format that is used if someone commented on a issue
  • plugins.Gitlab.format.note-snippet - The format that is used if someone commented on a snippet

For those formats you can pass different arguments that contain the values of the notification. The default values are:

  • The data of the payload as described here
  • project - The project containing the name and the id of the project
  • url - The direct url to the data described by this notification