IRC Plugin

Skip to end of metadata
Go to start of metadata

Plugin Information

Plugin ID ircbot Changes In Latest Release
Since Latest Release
Latest Release
Latest Release Date
Required Core
Dependencies
2.25
Apr 02, 2014
1.466
analysis-core (version:1.0, optional)
instant-messaging (version:1.25)
ci-game (version:1.16, optional)
Source Code
Issue Tracking
Maintainer(s)
GitHub
Open Issues
Christoph Kutzinski (id: kutzi)
Usage Installations 2013-Apr 1625
2013-May 1654
2013-Jun 1686
2013-Jul 1673
2013-Aug 1705
2013-Sep 1656
2013-Oct 1770
2013-Nov 1762
2013-Dec 1736
2014-Jan 1820
2014-Feb 1850
2014-Mar 1930

This plugin enables Jenkins to send build notífications via IRC and lets you interact with Jenkins via an IRC bot. Note that you also need to install the instant-messaging plugin .

Installation Requirements
This plugin needs the instant-messaging plugin. Please ensure that the latest version of this plug-in is also installed.

Features

See the  instant-messaging plugin for a description of protocol-independent features.

IRC-specific features

support password-protected chatrooms

  • support NickServ authentication

Known Issues

Please look into the issue tracker for any open issues for this plugin.

Debugging Problems

If you experience any problems using the plugin please increase the log level of the logger hudson.plugins.ircbot to FINEST (see Logging), try to reproduce the problem and attach the collected logs to the JIRA issue.

Changelog

Version 2.25 (Apr 2, 2014)

  • Fixed a NullPointerException introduced in 2.24 issue #22478

Version 2.24 (Mar 29, 2014)

  • Added basic support for SOCKS proxies (thanks Andrew Bonney)
  • Fixed: dropped whitespace if IRC colors were used issue #22360 (thanks Marius Gedminas)
  • Updated to PircBotX 1.9

Version 2.23 (May 22, 2013)

  • new option to disallow bot commands from private chats
  • new option to trust self-signed SSL certificates

Version 2.22 (Mar. 1, 2013)

Version 2.21 (Dec. 15, 2012)

  • new option to colorize build notifications based on the build outcome.
    Note that this feature may change in the future - especially regarding 'what' is colorized and the colors!
  • fixed issue #13967 (ArrayIndexOutOfBounds Exception when I try to setup a second IRC channel in Jenkins configuration)

Version 2.20 (Oct. 13, 2012)

  • fixed a bug when updating from previous versions on Windows

Version 2.19

Version 2.18

Version 2.17

skipped

Version 2.16:

  • fixed: password authentication not working since 2.14 (issue #10862)

Version 2.15

Version 2.14

  • Support SSL connections (issue #3543
    • Attention: as the underlying IRC library had to be replaced to achieve this, it's not completely unlikely that you could experience some regressions. Please open a new issue in that case.
  • New option to specify IRC server encoding (issue #10090)

Version 2.13

Version 2.12

Version 2.11

  • see instant-messaging plugin 1.14 for changes!

Version 2.9

  • wait 5 seconds after identifying with NickServ before trying to join channels. Should minimize problems if channels are restricted and the NickServ identification isn't fast enough before the bot tries to join the channels. Refs. JENKINS-6600 , JENKINS-8451

Version 2.8

  • fixed: NullPointerException because of incorrect migration of old configurations. JENKINS-8001
  • new feature: new chat notifier which prints the failing tests, too JENKINS-7035

Version 2.7

  • improvement: bot commands are now extensible and open for other plugins (see class BotCommand).
  • improvement: added an extension point to customize the message the bot sends to chats for notification (see class BuildToChatNotifier).
  • improvement: bot may be invited to channels (issue 6600 )

Version 2.6

  • fixed: disconnects (and no reconnects) when changing the global config (issue #6933)
  • improved behaviour when plugin is disabled. I.e. doesn't log unnecessary stuff.
  • fixed: plugins configure option not visible JENKINS-5978 JENKINS-5233
  • use UTF-8 as encoding for sending/receiving messages (previously used default encoding of the Hudson server)

Version 2.5

  • fixed: notify upstream commiter would have notified committers of 'old' builds (JENKINS-6712)
  • improvement: print useful project names for matrix jobs (JENKINS-6560 )
  • fixed: don't delay Hudson startup (JENKINS-4346 )
  • feature: userstat command for bot (JENKINS-6147 )
  • fixed: don't count offline computer for the executors count (JENKINS-6387)

Version 2.4

  • fixed: bot output sometimes send to wrong user (JENKINS-6484)

Version 2.3

  • allow to pass build parameters with the build command (JENKINS-5058 ) Make sure that instant-messaging 1.7 or later is installed.
  • allow to set NickServ passwords

Version 2.2

  • support password-protected chatrooms

Version 2.1

  • new option to inform upstream committers (JENKINS-4629 )
  • Bot uses /msg command to inform channels/users instead of /notice as before. You can restore the old behaviour in the global configuration. (JENKINS-5087 )

Version 2.0

  • This is the first version which is build upon the instant-messaging plugin. Make sure that instant-messaging 1.3 is installed.
  • This version needs Hudson 1.319 or newer
  • Though much care has been taken to migrate settings from previous versions, because of the amount of the changes it cannot be guaranteed that all old settings are migrated correctly!
  • This version supports all options that the Jabber plugin supports. See [there] for more info.
  • Command responses are no longer send as private messages to the user. Instead they are send to the channel. If you want private messages then send the command as a private message to the bot.

Usage

When you install this plugin, your Hudson configuration page gets additional "IRC Notification" option as illustrated below:

 
In addition, each project should add a "Post-build Actions"> "IRC Notification" configuration as illustrated below:
 

 
For the project configuration, leave the Channels blank to default to the channels defined in the master IRC configration.

Labels

plugin-trigger plugin-trigger Delete
plugin-notifier plugin-notifier Delete
instant-messaging-plugin instant-messaging-plugin Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.
  1. Jun 02, 2009

    Josh Koenig says:

    Any possible support for per-channel passwords?

    Any possible support for per-channel passwords?

    1. Nov 22, 2009

      Christoph Kutzinski says:

      Should be possible - the biggest problem is how to make the UI for this. Please,...

      Should be possible - the biggest problem is how to make the UI for this. Please, create a new issue tracker item for it.

  2. Jan 08, 2010

    Daniel Lindner says:

    I've begun to write a parser API for 2.X style IRC messages of this plugin. The ...

    I've begun to write a parser API for 2.X style IRC messages of this plugin. The API can be used to further process the messages, it just extracts the data.

    The source code can always be found here: http://github.com/dlindner/hudson.irc.plugin.parser

    The first version was created in context of an Open Source Love Day (OSLD): http://schneide.wordpress.com/2009/12/23/open-source-love-day-december-2009/

  3. Jan 12, 2010

    pctainto - says:

    I think in the latest upgrade, the "Hudson username" and "Hudson password" field...

    I think in the latest upgrade, the "Hudson username" and "Hudson password" fields were added (I don't remember them before...).  So, when I upgraded, it added two fields to the plugin xml to store this data, but, I never had the chance to set data for that.  So, Hudson would just never start up -- its startup process would freeze after joining the IRC room.  I eventually started poking around and saw the empty fields and filled them in with some user data, which, fixed my problem.  Anyway, someone else is probably having the same problem.  The xml file I edited was hudson.plugins.ircbot.IrcPublisher.xml .  I have a locked down Hudson, but, haven't had problems with the IRC bot in the past.

    1. Mar 13, 2010

      Christoph Kutzinski says:

      Please use the issue tracker to report bugs! I don't monitor the comments.

      Please use the issue tracker to report bugs! I don't monitor the comments.

  4. Jan 21, 2010

    ole b says:

    A feature request ! Support of SSL connections to IRC Servers would be nice ...

    A feature request !

    • Support of SSL connections to IRC Servers would be nice
    • Channelkeys should be supported.
    1. Mar 13, 2010

      Christoph Kutzinski says:

      Please use the issue tracker to report feature requests! I don't monitor the...

      Please use the issue tracker to report feature requests! I don't monitor the comments.