Configurable settings for any additional build plugins added to Screwdriver.cd.
The settings can be set in
shared, to apply to all jobs, or in an individual job. A job-level setting will completely override the
If you don’t configure the build status, the notification will default to sending notifications on
shared: settings: email: [firstname.lastname@example.org, email@example.com] slack: 'mychannel' jobs: main: requires: [~pr, ~commit] template: example/mytemplate@stable
jobs: main: requires: [~pr, ~commit] template: example/mytemplate@stable settings: email: [firstname.lastname@example.org, email@example.com] slack: 'mychannel'
To enable emails to be sent as a result of build events, use the email setting.
You can configure a list of one or more email addresses to contact. You can also configure when to send an email, e.g. when the build status is
settings: email: addresses: [firstname.lastname@example.org, email@example.com] statuses: [SUCCESS, FAILURE]
To enable Slack notifications to be sent as a result of build events, invite the
screwdriver-bot Slack bot to your channel(s) and use the Slack setting in your Screwdriver yaml. Both public and private channels are supported. You can configure a list of one or more Slack channels to notify.
You can also configure when to send a Slack notification, e.g. when the build status is
FAILURE. If no
statuses field is set, the build will only send notifications for build failures. For a full list of statuses, see the data-schema.
To send data in steps as a notification, notification meta is available.
Example: Multiple Rooms
The value of the
slack setting can be an array of multiple channels.
settings: slack: [mychannel, my-other-channel]
Example: Notify on build statuses
This Slack setting will send Slack notifications to
my-other-channel on all build statuses:
settings: slack: channels: - 'mychannel' - 'my-other-channel' statuses: - SUCCESS - FAILURE - ABORTED - QUEUED - RUNNING