Commits Bot maintenance

Contact Information

Owner: GNOME Sysadmin Team

Contact: #sysadmin

Persons: AndreaVeri

Machine: signal

Official documentation: http://kgb.alioth.debian.org

Description

Maintenance instructions on how to properly include new projects and modules on the Commits Bot.

Action

Adding and configuring new repositories is as easy as modifying two files. Make sure repository-name matches with the "real name" of the repository you are about to configure, without the .git extension, for example sysadmin-bin.git becomes sysadmin-bin. The rationale can be found at https://git.gnome.org/browse/sysadmin-bin/tree/git/post-receive-notify-kgb. (each repository has a specific hook configured to read from a configuration file using the following syntax: kgb-client-$REPOSITORY_ID.conf).

On combobox.gnome.org, at /home/admin/KGB, create a new kgb-client-$REPOSITORY_NAME.conf file. You can use the following example:

---
repo-id: repository-name
servers:
 - uri: http://signal.gnome.org:5391/
   password: verysecret
web-link: https://git.gnome.org/browse/${module}/commit/?id=${commit}

On signal.gnome.org, modify the /etc/kgb/kgb-bot.conf file:

repositories:
  repository-name:
    password: verysecret
channels:
  - name: '#gedit'
    network: GIMPNET
    repos:
      - repository-name

Then reload the bot with sudo service kgb-bot reload. The bot will then join the new channel and start sending out notifications.