# CruiseControl.rb can send email notices whenever build is broken or fixed. To make it happen, you need to tell it how # to send email, and who to send it to. Do the following: # # 1. Configure SMTP server connection. Copy [cruise]/config/site_config.rb_example to ~cruise/config/site_config.rb, # read it and edit according to your situation. # # 2. Tell the builder, whom do you want to receive build notices: #
Project.configure do |project|
# ...
# project.email_notifier.emails = ['john@doe.com', 'jane@doe.com']
# ...
# end
#
# You can also specify who to send the email from, either for the entire site by setting Configuration.email_from
# in [cruise]/config/site_config.rb, or on a per project basis, by placing the following line in cruise_config.rb:
# Project.configure do |project|
# ...
# project.email_notifier.from = "cruisecontrol@doe.com"
# ...
# end
#
# The emails from CruiseControl.rb can have a lot of details about the build, or just a link to the build page in the dashboard.
# Usually, you will want the latter. Set the dashboard URL in the [cruise]/config/site_config.rb as follows:
#
# Configuration.dashboard_url = 'http://your.host.name.com:3333'
class EmailNotifier
attr_accessor :emails
attr_writer :from
def initialize(project = nil)
@emails = []
end
def from
@from || Configuration.email_from
end
def build_finished(build)
return if @emails.empty? or not build.failed?
email :deliver_build_report, build, "#{build.project.name} build #{build.label} failed", "The build failed."
end
def build_fixed(build, previous_build)
return if @emails.empty?
email :deliver_build_report, build, "#{build.project.name} build #{build.label} fixed", "The build has been fixed."
end
private
def email(template, build, *args)
BuildMailer.send(template, build, @emails, from, *args)
CruiseControl::Log.event("Sent e-mail to #{@emails.size == 1 ? "1 person" : "#{@emails.size} people"}", :debug)
rescue => e
settings = ActionMailer::Base.smtp_settings.map { |k,v| " #{k.inspect} = #{v.inspect}" }.join("\n")
CruiseControl::Log.event("Error sending e-mail - current server settings are :\n#{settings}", :error)
raise
end
end
Project.plugin :email_notifier