Jenkins : Ironmq Notifier

The messages have FIFO (first-in first-out) ordering so ensure continuity and can be dealt with by different clients as needed.

The current build status is :   

1.0.18 - will use a minimum version of 2.7.2 version of jenkins, tested to 2.29

• removed dependency on older dependency for testing
• change jenkins plugin to newer version to ensure best compatibility

1.0.17 - test and set to allow install on 1.651.3 version of jenkins

1.0.16 - Initial pre-release v2 pipeline

• Regression on alternate queue name for push queue
• Code adjustments to prepare for v2 (pipeline) (not yet completed).

1.0.15-Not released - Deployment issues

1.0.14 - tested with 1.651.2 LTS

1.0.13 - nothing special

WARNING: You will need to change the hosts you send messages to, and the message format has changed in this release. (1.0.12 and above)

Note: 1.0.12 has major changes to support for the new Version 3 ironmq api. The version 2 api has been deprecated by Iron.io.

One of the biggest change in the new ironmq API is the removal of the ability to put expiry seconds on individual messages to a queue.

The following change will occur from version 1.0.12 forward.

• The message version of the mesage will change from "1" to "3.0".  
• You will need to prepare to use only Version 3 iron.io servers .  The default server will be changed to mq-aws-us-east-1-1.iron.io
• To prepare for the upgrade, the following will change.. Default Config Server name... and then within in job definition.
• The expirySeconds field will remain for several versions to allow easier reversion to pre-1.0.12 versions without errors but will be removed by version 1.0.15 unless a very compelling reason to put this field back exists before then. For now, the data will be accepted but the default for the Queue on Iron.IO will be used.  As an alternative, consider using the iron.io API to set the default for the entire Queue if setting queue expiry time is important to you.  Otherwise, messages will expire based on default queue setttings.
• The Expires Date field will also be removed as it may provide misleading information. Expiry will inherit from the queue settings and are therefore inappropriate as part of the message properties.

Note: 1.0.11 - enhancement - defaults settings simplify adding post-build actions.

Setup Instructions for Iron.io

At the time of the creation of this document, no setup or accounts are needed at Rackspace or Amazon. It is all handled nicely through the one interface at Iron.io

• Go to http://www.iron.io/mq for more info.
• Create an account
• Create a Project (you can have one project for your Jenkins instance or several projects depending on your needs).
• After the project is setup, go to the "HUD" at https://hud.iron.io

Sample Jenkins Project (not the Settings Icon) which will provide authentication token for your Project (Jenkins in this example).

You will need the following information:

• ProjectId (provided by the HUD)
  Token for this Project (provided by the HUD under authentication)
  QueueName (A-Z upper and lower) (I have not tested other alternatives)
  Preferred Server Name (there are several servers available for this service. This plugin is designed so that if there are new ones, no coding changes are needed.. Just replace the name of the server as they add/remove servers from their available list.

Current options for Server Names are..

• mq-aws-us-east-1-1.iron.io
• mq-aws-us-east-1-2.iron.io
• mq-aws-eu-west-1-1.iron.io

Starting from version 1.0.11, configure default settings in the Configure Jenkins Server Defaults as follows;

These settings will be used by default when adding a Post-Build action to new jobs.

After downloading the plugin into your Jenkins server, when creating a job, go to Post-Build Action and add a Step called "Send message to IronMQ".

You will then see the following options. (please note, these are not valid #s and are for presentation only).

The next time your build executes, it will send the results to your ironMQ mesasge queue.

As of Version 1.0.5, when a message is transmitted to the queue, it is in JSON format to allow for applications to be created with intelligence based on the data in the Queue.

Current To-Do list

• Modify the documentation to show new version 3 API screens and information.
• Get unstable build to work in the event of an error of some sort during transmission
• Consider starting work on languages.
• Consider adding a "backup-server" as part of the input.
• Consider having the next version extend the Credentials Plugin for keys

Change Log

Version 1.0.13 (Dec 16, 2015)

• Set Base Version to 1.625.3 (instead of .2) to ensure works with LTS with security advisory 2015-12-09

Version 1.0.12 (Dec 9, 2015)

• Version 3 API due to deprecation of Version 2 API at iron.io

Version 1.0.11 (Oct 16, 2015)

• Added Default configuration Settings to Jenkins Server Configuration Page
  • This allows easier adding as a post-build action.
• Test with 1.625.1 LTS
• Added Automated Tests

Version 1.0.10 (Mar 27, 2015)

• Confirm working with 1.592 LTS (March, 2015 Security Advisory)
• Start working on localization ability

Version 1.0.6 (Oct 21, 2013)

• Fixed some Descriptor Implementation (this version should work on 1.532).

Version 1.0.5 (Oct 8, 2013)

• Messages switched to JSON format to allow a large amount of information as well as easy future API upgrades.

Version 1.0.4 (Oct 7, 2013)

• Add ability to set expiry timeout on messages
• set default preferredServer to mq-rackspace-ord.iron.io
• set default queueName to Jenkins
• some field validation warnings

Version 1.0.3 (Oct 5, 2013)

• First field validation on forms (queueName)
• change default message expiry to 806400 seconds (7 days)

Version 1.0.2 (Oct 3, 2013) (minimum recommended version)

• First successfully deployed version (start here).
• Ensured that queue name would be transferred (no longer in test mode)

Version 1.0.1 (Oct 3, 2013)

• Fixed a missing dependency from iron.io library

Version 1.0 (Oct 2, 2013)

• Initial Release. (Avoid this initial release.  it installed OK but would not run due to a dependency problem).