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: [email@example.com, firstname.lastname@example.org] slack: 'mychannel' jobs: main: requires: [~pr, ~commit] template: example/mytemplate@stable
jobs: main: requires: [~pr, ~commit] template: example/mytemplate@stable settings: email: [email@example.com, firstname.lastname@example.org] 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: [email@example.com, firstname.lastname@example.org] 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. You may also choose whether to use the default notification format or a more compact one using the
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
Example repo: https://github.com/screwdriver-cd-test/slack-example
Example: Minimized notification
The default notification format includes the job’s status, a corresponding emoji, and a link to the pipeline. The notification’s attachment will include a link to the build, up to 150 characters of the commit message, a link to the commit, and a description of what triggered the event.
This Slack setting will use the default notification format:
settings: slack: channels: - 'mychannel' statuses: - SUCCESS
true, then the notification will use a format that consists of a link to the job, the job’s status, and an attachment with a link to the build.
settings: slack: channels: - 'mychannel' statuses: - SUCCESS minimized: true